ccda618ea4
- 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>
78 lines
3.7 KiB
Markdown
78 lines
3.7 KiB
Markdown
# 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é.
|