[DTP-Worker] Sprint 8 · buffer L75 · Doc agent CRM (stub→doc réelle · 3 modules Sprint 4 sourcés + anti-invention taux null) (Doc · roadmap L75)

- 03_agents/crm/AGENT.md : stub 29 lignes → doc réelle ~90 lignes
- Table 3 livrables CRM (workflow_vente/dossier_vente/commissions) :
  sprint · CLI build|validate · job CI · nb tests (25/31/25 = 81, tous sourcés)
- #3 mis en avant (CRM = ERPNext natif · JAMAIS EspoCRM/HubSpot)
- Anti-invention #6 : taux commission null ; USD+DOP/Letter US cités #10
- Vérifs : guard vert · check_docs vert (liens OK) · 0 réf roadmap morte

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Code DTP Worker
2026-07-30 13:01:09 +00:00
parent dbeea972ed
commit ccda618ea4
3 changed files with 169 additions and 6 deletions
@@ -0,0 +1,77 @@
# Rapport de session · 2026-07-30 · session 26
**Agent** : Claude Code DTP · **Session** : `20260730_125754`
**Sprint** : 8 · **Volet** : buffer L75 (corrections finales · documentation agent)
**Auto-score 4Big** : 95/100
---
## 1. Contexte — pourquoi une tâche « doc » et pas un nouveau module
La recette d'acceptation (`05_deliverables_mvp/qa/acceptance/out/acceptance_matrix.json`)
prouve que **15/15 promesses** roadmap sont `in_repo` (seule M5 « app publiée
2 stores » reste hors périmètre worker · #8). **Aucun module roadmap ne reste à
créer** ; un 5ᵉ générateur méta serait un doublon (interdit CLAUDE.md #5). La
consigne de mandat prévoit ce cas : *« Si aucune tâche prioritaire évidente →
améliore la doc d'un AGENT.md existant. »*
La session 25 a fait exactement cela pour l'agent **QA** (stub 29 lignes → doc
réelle 82 lignes). J'ai poursuivi la même remédiation sur le **prochain agent le
plus sous-documenté au regard de ce qu'il a livré**.
## 2. Défaut corrigé — `03_agents/crm/AGENT.md` était un stub
L'agent **CRM** a livré **3 modules substantiels** au Sprint 4
(`05_deliverables_mvp/crm/`) — pipeline vente, DocType porteur, barème
commissions — mais son `AGENT.md` restait le **stub générique de 29 lignes** qui
ne reflétait rien de la réalité livrée. Écart de documentation identique à celui
traité pour QA en session 25.
## 3. Ce qui a été fait
`03_agents/crm/AGENT.md` réécrit (stub → doc réelle, ~90 lignes) :
- **Table des 3 livrables CRM** — module · sprint (ligne roadmap) · rôle · **entrée
CLI** · **job CI** · **nb tests** — chaque valeur **sourcée** depuis les modules
réels et le CI.
- Principe directeur : **hand-off VPS, jamais d'écriture serveur** (#8) ; ordre
d'import DocType-avant-Workflow.
- Cross-cohérence (source unique) : nom/champ d'état/statuts dérivés de
`workflow_vente_spec.json` ; rôles résolus depuis `rbac_50_roles.json`.
- Anti-invention (#6) explicité : **taux de commission `null`** (aucun taux dans
CLAUDE.md), USD+DOP et Letter US **cités** depuis #10.
- Non-négociable **#3 mis en avant** : CRM = ERPNext natif, **JAMAIS** EspoCRM/HubSpot.
- Coordination inter-agents (ERPNext Backend · RBAC · Publiciste · QA · Faisabilité).
## 4. Anti-invention (#6)
**Zéro chiffre fabriqué.** Chaque nombre de la doc est un compte réel :
| Source | Valeur citée |
|---|---|
| `grep -c 'def test_'` sur les 3 suites | 25 / 31 / 25 → **81 tests** |
| `.gitea/workflows/ci.yml` | jobs `crm-workflow-vente-tests`, `crm-dossier-vente-tests`, `crm-commissions-tests` (tous dans `gate.needs`) |
| `grep add_parser` des 3 générateurs | sous-commandes `build` / `validate` |
| `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` L51 | deliverables Sprint 4 |
| CLAUDE.md #3 / #10 | ERPNext natif · USD+DOP · Letter US |
## 5. Vérifications
- `ci/guard_constraints.sh`**vert** (contraintes non-négociables OK).
- `ci/check_docs.sh`**vert** (liens internes OK · aucun lien mort).
- `grep ROADMAP_8_WEEKS\.md 03_agents/`**0 référence morte** (non régressé
depuis session 25).
- Comptes de tests vérifiés par `grep` (pytest non installé dans l'environnement
worker ; l'exécution réelle est assurée par le CI Gitea).
## 6. Hors périmètre worker (VPS · #8)
Néant — changement doc-only en-repo.
---
**Bilan** : la documentation de l'agent CRM reflète désormais fidèlement les 3
livrables réellement produits, avec chaque chiffre sourcé. Reste sous-documentés
(stubs 29 lignes) : bim, devops, erpnext_backend, ifc_speckle, mobile, onapi_legal,
rendu, seo, frontend_console — candidats naturels pour les prochaines itérations
buffer, à traiter par ordre de volume livré.