docs(prd): agent catalog — task→(prompt+model+orchestrator) matrix + agent-facing file syntax

New agent-catalog.md leaf answering three operator directions: (1) the document surface agents read is now specified — AGENTS.md orientation maps, SKILL.md with trigger-carrying descriptions (Use-when/SKIP-for), atom.yaml registry contracts, thin prompt.md files (no business rules in prompts — rules live in profile files and validators), schema'd fiscal.yaml/calendar.yaml with effective_from dates, [AGENT]/[HUMAN] runbooks, env-var-indirected .mcp.json; same-change freshness rule extended to the fleet. (2) hermes's telegram-gateway confirmed as THE human channel when available (cluster-served cards, email fallback; D1 operator-endorsed). (3) the categorization to prove: seven agent classes (incl. the LLM-free deterministic controller) and a T01-T17 assignment matrix with per-row proof gates and statuses (proven / to-prove / not-built), re-scored monthly from run journals (fallback rate >20% = wrong cell). New D8 (fleet code home, leaning erp fleet/). Co-Authored-By: Claude Fable 5 <[email protected]>
2026-07-11 15:09:28 +02:00
parent 5430e5f3ac
commit 8e4186dbeb
4 changed files with 82 additions and 4 deletions
@@ -114,6 +114,7 @@ flowchart TB
 - **[Task inventory](task-inventory.md)** — the enumerated tasks (T01–T17 + backlog), each with trigger, mode opératoire, guardrails, current tooling, and target autonomy. *This is the functional requirement set.*
 - **[Agent architecture](agent-architecture.md)** — atom contracts, pipeline shape, write safety, security model (least-privilege ephemeral ERP credentials), prompt-injection defenses, runtimes/scheduling, and the human channel.
 - **[Model fleet](model-fleet.md)** — the four tiers, routing policy, structured-output enforcement, availability model, degraded modes, and cost envelope.
+- **[Agent catalog](agent-catalog.md)** — the concrete assignment task → (prompt + model + orchestrator) with a proof status per row, the seven agent classes, and the syntax of every file agents read (`AGENTS.md`, `SKILL.md`, atom registry, prompts, fiscal profile).
 - **[Challenges](challenges.md)** — the twelve identified risks and their mitigation strategies (the technical "second temps" of this PRD).
 - **[Compliance](compliance.md)** — the French bookkeeping obligations (inaltérabilité, FEC, piste d'audit fiable, numbering, retention) mapped to fleet mechanisms; the production ledger grammar and its linter; the sandbox-vs-production operating posture.
 - **[POC plan](poc-plan.md)** — feasibility proofs as real implementations, ordered, with exit criteria.
@@ -166,6 +167,7 @@ Golden datasets built from real history (mails, invoices, filed declarations), a
 | [Task inventory](task-inventory.md) | T01–T16 + backlog: trigger, mode opératoire, guardrails, current tooling, target autonomy per task. | 🟡 In design |
 | [Agent architecture](agent-architecture.md) | Atom contracts, pipeline shape, write safety, security, injection defenses, runtimes, human channel. | 🟡 In design |
 | [Model fleet](model-fleet.md) | Four tiers, routing policy, structured outputs, availability, degraded modes, cost. | 🟡 In design |
+| [Agent catalog](agent-catalog.md) | Task → (prompt + model + orchestrator) matrix with proof statuses; agent classes; agent-facing file syntax. | 🟡 In design |
 | [Challenges](challenges.md) | Twelve risks with mitigation strategies and residual ownership. | 🟡 In design |
 | [Compliance](compliance.md) | Bookkeeping obligations → mechanisms; ledger grammar + linter; sandbox-vs-prod posture; Dolibarr verifications. | 🟡 In design |
 | [POC plan](poc-plan.md) | Ordered feasibility proofs with exit criteria and challenge coverage. | 🟡 In design |