reverse-doc

name	reverse-doc
description	Reconstitue la documentation d'un projet depuis le code source : CDC, doc technique/user, user stories, glossaire, architecture. Stocke en notes vault PARA.
version	1.0.0
platforms	["linux","macos"]
metadata	{"hermes":{"tags":["reverse","docs","reconstitution","vault","architecture","user-stories"],"related_skills":["note-taking","doc-repair","stack-analyze"],"model":"deepseek-v4-full"}}

reverse-doc

Adaptation de strange (16) — ULK → Hermes. Carte : docs/backlog/2026-06-28-SPEC-HERMES-REVERSE-DOC/CARD.md (P3, GitHub #258).

Reconstitue 6 artefacts documentaires depuis le code source : cahier des charges, doc technique, doc utilisateur, user stories, glossaire, architecture. Sortie directe en notes vault PARA. Références fichier:ligne uniquement, jamais le code source recopié.

Runtime & modèles

• DeepSeek V4 full : analyse du code, synthèse, rédaction des artefacts, consolidation (tier ULK sonnet → DeepSeek full — synthèse complexe, ne pas sous-doser l'effort).
• Pas de délégation coding : la skill lit du code et écrit des notes Markdown. Rédiger de la doc n'est pas produire du code source → tout reste DeepSeek.
• delegate_task (raisonnement, pas coding) : parallélise la génération de chaque artefact (6 sous-tâches DeepSeek), pas de l'écriture de code.

Vault

• écriture dans Projects/<projet>/docs/ (CDC, user stories) et Resources/<projet>/ (doc technique, glossaire, architecture) + index Projects/<projet>/README.md.

Procédure

1. Définir l'arborescence de sortie vault (PARA par projet).
2. Phase analyse : lister les fichiers source, détecter la stack (s'appuie sur stack-analyze si disponible), cartographier les modules.
3. Générer chaque artefact via delegate_task (6 sous-tâches parallèles DeepSeek).
4. Écrire les notes avec frontmatter type: doc, project: <nom>, generated: true, date.
5. Créer l'index Projects/<projet>/README.md listant les artefacts (Wikilinks).
6. Consolider les glossaires (les sous-tâches parallèles peuvent diverger).

Critères d'acceptation

• Les 6 artefacts générés et stockés dans le vault.
• Chaque note a un frontmatter valide (title, type, project, generated, date).
• Index de projet créé, listant tous les artefacts en Wikilinks.
• Fonctionne sur un projet ≥ 500 lignes de code.

Pièges

• delegate_task parallèle → glossaires incohérents : consolider en post-traitement.
• Ne pas inclure le code source dans les notes (taille vault) : références fichier:ligne seulement.
• Projets sans README ni commentaires → effort de raisonnement DeepSeek plus élevé ; petit projet → passe simple.