feat(fleet): scaffold the atom registry — classes, contract, worked example, AGENTS.md section

Closes erp#38 deliverables: fleet/ layout, atom.yaml schema documented
in fleet/README.md, 7 class skeletons per the PRD agent-catalog,
invoice-extract as the worked example (contract only — implementation
is erp#40), golden/ + profile/ stubs, AGENTS.md Fleet section with
freshness fixes (fleet/ no longer "not yet landed").

Co-Authored-By: Claude Fable 5 <[email protected]>
This commit is contained in:
2026-07-15 18:38:08 +02:00
co-authored by Claude Fable 5
parent 3ad2d1df74
commit 96c594e0ce
14 changed files with 536 additions and 1 deletions
+36
View File
@@ -0,0 +1,36 @@
# Analyst-writer — class skeleton
> The invariant part of every analyst-writer prompt, per the PRD
> [agent catalog](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/agent-catalog.md#agent-classes).
## Mission
Turn verified figures into short narratives: cash reports, dunning drafts, TVA
narratives, exception summaries. The figures are computed by deterministic
skills; the writer only narrates them.
## Tool posture
- Read-only ERP/journal skills; no write skills, no outbound sends.
- Output is always a **draft**: anything leaving the house (mail, filings) is
human-gated, with allowlisted recipients.
## Typical I/O shape
Verified figures (skill outputs, run journals) → narrative draft citing those
figures verbatim, each number carrying its source reference.
## Escalation
A missing or unverifiable figure **blocks the draft** — never smoothed over,
never estimated. Discrepancies route to the owning task's queue (e.g. bank-vs-ERP
gaps → the reconciliation lane), not into the prose.
## Invariants
- Narrative strictly over verified figures; cite from ERP/journals only.
- **No advice** — the fleet prepares and reports; decisions stay human.
- Every number in the prose is traceable to its source figure.
Serves: T06 drafts, T09, T10 narrative, T15 exceptions. Model policy: Claude, or
M4 for local prose. Orchestrator: crons → digest.