PD-249 — Decomposition multi-agents¶

Manifest¶

parallelization: by_level

Story : PD-249 — Manuel technique SAE consolide Projet : ProbatioVault-doc Type : Documentaire (Markdown + Mermaid, pas de code) Agent commun : agent-developer (claude -p) — redaction technique Repertoire cible : _build/docs/sae-manual/

Niveau 0 (parallele — 10 agents)¶

Niveau 1 (sequentiel — apres niveau 0)¶

Niveau 2 (sequentiel — apres niveau 1)¶

Strategie d'execution¶

• Niveau 0 : 10 chapitres en parallele. Chaque agent recoit le meme bloc partage (spec + tests + plan + code contracts complets + regles transversales de redaction) suivi de son contract specifique (CC-01 a CC-10) et de la liste de ses sources.
• Niveau 1 : Glossaire SAE (TASK-12). Necessite la lecture de tous les chapitres produits au niveau 0 pour extraire exhaustivement les termes normatifs, techniques et ProbatioVault utilises. L'agent recoit en entree les 10 chapitres produits + les glossaires existants des projets sources.
• Niveau 2 : Integration MkDocs (TASK-11). Necessite tous les fichiers (10 chapitres + glossaire) pour creer la page index.md, modifier mkdocs.yml et valider la navigation. L'agent verifie la coherence des liens internes et la completude de la table des matieres.

Regles d'assemblage cache-first (prompt caching)¶

Les 10 agents du niveau 0 partagent un prefix identique pour maximiser le cache Anthropic :

Le system prompt (--append-system-prompt) DOIT etre byte-identical entre les 10 appels du niveau 0.

Sources par agent¶

TASK-01 — Ch.1 Introduction et vue d'ensemble (CC-01)¶

Sources ProbatioVault-doc :

• docs/epics/legal-compliance/PD-249-manuel-technique-sae-consolide/PD-249-besoin.md (section Perimetre)
• docs/epics/legal-compliance/PD-244-audit-iso14641-nfz42013/PD-244-compliance-dashboard.md

Sources ProbatioVault-infra :

• docs/architecture/overview.md

Sources ProbatioVault-backend :

• aucune

TASK-02 — Ch.2 Architecture du SAE (CC-02)¶

Sources ProbatioVault-infra :

• docs/architecture/overview.md
• docs/architecture/data-flows.md
• docs/architecture/storage/storage-architecture.md

Sources ProbatioVault-backend :

• docs/architecture/overview.md

TASK-03 — Ch.3 Modele de securite (CC-03)¶

Sources ProbatioVault-infra :

• docs/architecture/overview.md
• docs/architecture/crypto-model.md

Sources ProbatioVault-backend :

• docs/architecture/crypto-model.md

Sources ProbatioVault-doc :

• docs/normes/pv-pre/RFC-PV-PRE.md

Specs PD : PD-7, PD-8, PD-36, PD-60

TASK-04 — Ch.4 Stockage et immutabilite (CC-04)¶

Sources ProbatioVault-infra :

• docs/architecture/storage/storage-architecture.md
• docs/architecture/storage/cold.md
• docs/architecture/storage/glacier-crr.md
• docs/architecture/storage/worm.md
• docs/architecture/worm-proof.md

Specs PD : PD-4, PD-5, PD-6

TASK-05 — Ch.5 Chaine de preuve (CC-05)¶

Sources ProbatioVault-backend :

• docs/architecture/refs/crypto.md
• docs/architecture/refs/composite-proof.md

Sources ProbatioVault-doc :

• docs/normes/pv-envelope/RFC-PV-ENVELOPE.md
• docs/normes/pv-proof/RFC-PV-PROOF.md
• docs/normes/pv-anchor/RFC-PV-ANCHOR.md

Specs PD : PD-33, PD-34, PD-38, PD-39

TASK-06 — Ch.6 Cycle de vie des documents (CC-06)¶

Sources ProbatioVault-backend :

• docs/architecture/data-flows.md

Sources ProbatioVault-doc :

• Specs PD-250 (backend artefacts)
• Specs PD-251 (backend, partiel — statut En cours Q1 2026)

TASK-07 — Ch.7 Tracabilite et audit (CC-07)¶

Sources ProbatioVault-backend :

• docs/architecture/probatoire/audit-signing/ (dossier complet)
• Module audit backend (typedoc)

Sources ProbatioVault-doc :

• docs/normes/pv-audit/RFC-PV-AUDIT.md

Specs PD : PD-19, PD-37, PD-250 (bordereau)

TASK-08 — Ch.8 Conformite normative (CC-08)¶

Sources ProbatioVault-doc :

• docs/epics/legal-compliance/PD-244-audit-iso14641-nfz42013/PD-244-reconciliation.yaml
• docs/epics/legal-compliance/PD-244-audit-iso14641-nfz42013/PD-244-gaps.yaml
• docs/epics/legal-compliance/PD-244-audit-iso14641-nfz42013/PD-244-compliance-dashboard.md
• docs/epics/legal-compliance/PD-244-audit-iso14641-nfz42013/PD-244-iso-14641-matrix-claude.yaml
• docs/epics/legal-compliance/PD-244-audit-iso14641-nfz42013/PD-244-nf-z42-013-matrix-claude.yaml

Contrainte : Scores PD-244 repris sans alteration (ISO 77.78%, NF 68.18%). Toute divergence tracee explicitement.

TASK-09 — Ch.9 Procedures operationnelles (CC-09)¶

Sources ProbatioVault-infra :

• docs/reference/infra/runbooks/ (dossier)
• docs/reference/infra/operations/ (dossier)
• docs/security-compliance/ (dossier)

Sources complementaires : Documentation monitoring (si disponible)

TASK-10 — Ch.10 Feuille de route (CC-10)¶

Sources ProbatioVault-doc :

• docs/epics/legal-compliance/PD-249-manuel-technique-sae-consolide/PD-249-besoin.md (section Composants SAE planifies)

Sources complementaires : Roadmaps infra/backend (si disponibles)

TASK-12 — Glossaire SAE (CC-12)¶

Sources (entrees produites au niveau 0) :

• Tous les chapitres ch01 a ch10 (extraction des termes utilises)

Sources ProbatioVault existantes :

• ProbatioVault-infra/docs/meta/glossary.md
• ProbatioVault-backend/docs/meta/glossary.md
• ProbatioVault-app/docs/meta/glossary.md

Sources ProbatioVault-doc :

• Definitions de la specification PD-249 (section 3)

TASK-11 — Integration MkDocs (CC-11)¶

Sources (fichiers produits aux niveaux 0 et 1) :

• Tous les fichiers du dossier _build/docs/sae-manual/ (ch01 a ch10 + glossaire)

Fichier modifie :

• mkdocs.yml (ajout section "Manuel SAE" dans nav)

Verifications :

• mkdocs build sans erreur
• Navigation visible dans le rendu HTML
• ENABLE_PDF_EXPORT=1 mkdocs build pour verification PDF
• Liens internes entre chapitres fonctionnels
• Ancres de section navigables

Regles transversales de redaction (injectees dans le bloc partage)¶

1. Consolidation vs duplication (INV-249-06) : Maximum 30% de contenu verbatim par chapitre et par source unique. Synthetiser, reformuler, ajouter references explicites.
2. Exploitabilite sans code (INV-249-07) : Decrire les mecanismes, pas les implementations. Inclure regles, parametres, preuves documentaires.
3. Statuts explicites (INV-249-08) : Chaque composant porte un statut DONE / En cours / Planifie avec horizon temporel.
4. Diagrammes Mermaid (INV-249-03) : Minimum 1 diagramme par composant implemente, maximum 15 noeuds, labels francais, identifiants techniques anglais, pas d'images statiques.
5. Convention Mermaid : Chaque diagramme precede d'un titre ### Diagramme : {nom} et suivi d'une legende textuelle.

Matrice de couverture INV/CA par niveau¶