spec-writer

name	spec-writer
description	Génère specs (CARD.md), todos et CLAUDE.md depuis un brief et les écrit dans le vault Obsidian avec frontmatter PARA.
version	1.0.0
platforms	["linux","macos"]
metadata	{"hermes":{"tags":["spec","docs","planning","para","card","brief"],"related_skills":["diagnostic","routine-builder","project-audit"],"model":"deepseek-v4-full"}}

spec-writer

Adaptation de shuri (01) — ULK → Hermes. Carte : docs/backlog/2026-06-28-SPEC-HERMES-SPEC-WRITER/CARD.md (P1, GitHub #269).

Convertit une idée/brief en tâche planifiée : génère la spec Faru (CARD.md), le todo et, en option, le CLAUDE.md projet — écrits comme notes PARA dans le vault.

Runtime & modèles

• DeepSeek V4 full : décomposition du brief, rédaction structurée, classification PARA.
• Pas de délégation coding : écrire une note Markdown (CARD.md, CLAUDE.md) n'est pas du coding (cf. routage 2026-07-06, frontière coding). Reste sur DeepSeek. Si le brief demande l'exécution immédiate d'une tâche de code, la délégation coding survient dans la skill cible (ex. fix-errors), pas ici.

Vault (écriture)

• spec → 01_PROJETS/<slug>/CARD.md
• brief brut → 00_INBOX/<date>-brief.md
• CLAUDE.md → 03_RESSOURCES/<projet>/CLAUDE.md (flag --with-claude-md)

Procédure

1. Décompose le brief → CARD.md (template Faru verbatim : title/type/status/assigned/ priority/effort/tags + étapes + critères d'acceptation).
2. Classe la destination PARA selon le type de note.
3. Option --with-claude-md : génère le contexte projet exploitable par un agent.
4. delegate_task vers la skill d'exécution si auto_execute: true dans le brief.
5. Idempotent : check avant écriture, ne pas écraser une CARD.md existante.

Critères d'acceptation

• CARD.md conforme au template Faru (tous les champs frontmatter valides).
• Classification PARA correcte pour spec / brief brut / note technique.
• Délégation via delegate_task fonctionnelle si auto_execute: true.
• CLAUDE.md exploitable sans retouche manuelle.
• Idempotent : relancer sur le même brief n'écrase pas une CARD.md existante.

Pièges

• Appeler diagnostic d'abord (ou accepter la stack en paramètre) — pas de contexte projet implicite.
• Le template Faru évolue → versionner le template dans la skill (anti-dérive).
• 00_INBOX (à trier) ≠ 01_PROJETS (engagé) : demander confirmation avant de promouvoir un brief.