From 3c11a926d53411e90dd49f7ca2d56e9fac101e52 Mon Sep 17 00:00:00 2001 From: Gabriel Radureau Date: Sat, 11 Jul 2026 20:17:16 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20AGENTS.md=20=E2=80=94=20doc-freshness?= =?UTF-8?q?=20rule=20(trust=20order=20+=20QA-gated=20closure=20pointer)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index 2f7fa43..62bed46 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -29,6 +29,7 @@ The [AI back-office PRD](https://gitea.arcodange.lab/arcodange-org/factory/src/b - **Production is an append-only ledger**: create → validate → pay → avoir; never mutate or delete a validated document, never fabricate a ref Dolibarr owns. Full grammar + anti-hallucination write contract (provenance anchors, fresh-feed corroboration, refuse-never-repair): PRD [compliance](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/compliance.md) + [agent-architecture](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/agent-architecture.md). - Sandbox state is disposable: `bin/arcodange sandbox checkpoint {status|refresh|provision|relink-env}` (refresh re-seeds iso-prod and wipes the write agent → re-provision, human login). Anything irreversible-by-design is trialed on a checkpoint first. - Bank feeds (Qonto/Wise) and the Zoho mailbox are **read-only by construction**; no agent ever moves money. +- **Doc freshness.** Docs describe intent; the PRD STATUS + git describe reality. Before acting on any versionable claim (a path exists, a flag's value, a status emoji), verify in trust order: **live system > code/git log > [PRD STATUS](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/STATUS.md) > PRD leaves > memories**. A PR that makes a documented claim false updates that doc **in the same PR**; whoever closes a milestone follows the QA-gated [closure protocol](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/main/vibe/PRD/ai-back-office/STATUS.md) (verify → flip STATUS → truth-pass docs → deprecation grep → fresh-reader smoke test) before the milestone closes. ## Before building anything