/documentation — documenter ce qui existe vraiment/documentation — document what actually exists
Le skill /documentation génère la documentation d'un projet client à partir du code réel — pas des intentions. Il extrait de façon déterministe les endpoints, les règles, les entités et les droits d'accès effectifs, puis met en page des documents lisibles par le métier.
The /documentation skill generates a client project's documentation from the actual code — not from intentions. It deterministically extracts the endpoints, rules, entities and effective access rights, then lays out documents readable by business users.
Les 4 types de documentsThe 4 document types
| TypeType | Pour quiFor whom | ContenuContent |
|---|---|---|
| Module utilisateurUser module | Utilisateurs métierBusiness users | Fonctionnalités du module, écrans, qui a accès à quoiModule features, screens, who can access what |
| Outils développeurDeveloper tools | Équipe de devDev team | Endpoints, services, points d'extensionEndpoints, services, extension points |
| ERD base de donnéesDatabase ERD | Dev / DBADev / DBA | Schéma des entités et relationsEntity-relationship diagram |
| Outils de testTesting tools | QAQA | Couverture, scénarios, points de contrôleCoverage, scenarios, checkpoints |
La section « Accès & rôles » — le code fait foiThe "Access & roles" section — the code is authoritative
Chaque document de module contient une section « Accès & rôles » construite par jointure entre les permissions réellement présentes dans le code, les rôles semés dans le Core, et la portée déclarée dans rbac.md. En cas d'écart entre le document BA et le code, c'est le code qui fait foi — la doc décrit ce que l'application fait, pas ce qu'on aurait voulu qu'elle fasse.
Every module document carries an "Access & roles" section built by joining the permissions actually present in the code, the roles seeded in Core, and the scope declared in rbac.md. When the BA document and the code disagree, the code wins — the doc describes what the application does, not what it was meant to do.
La section « Référence technique » (détails d'implémentation) est désactivée par défaut — elle s'active avec --tech quand le lectorat est technique.
The "Technical reference" section (implementation details) is off by default — enable it with --tech when the audience is technical.
Dans quel cas ?Which situation, which command?
| Je suis dans ce cas…I am in this situation… | …alors je fais…then I do |
|---|---|
| « Livrer la doc utilisateur du module Ventes »"Deliver the Sales module's user doc" | /documentation — type module utilisateur/documentation — user-module type |
| « Un schéma de la base pour l'architecte »"A database diagram for the architect" | /documentation — type ERD/documentation — ERD type |
| « La doc a-t-elle suivi les derniers développements ? »"Did the docs keep up with recent development?" | l'agent docs-sync-checker détecte la dérive code ↔ docthe docs-sync-checker agent detects code ↔ doc drift |
| « Le lectorat est une équipe technique »"The audience is a technical team" | ajouter --techadd --tech |