docs: AGENTS.md — orientation + backlog discovery for agents #58

Merged
arcodange merged 3 commits from arcodange/agents-md-backlog into main 2026-07-11 20:21:22 +02:00
Owner

What

Agents landing in this repo had no entry point: no AGENTS.md, and the backlog (erp#38–57 on 6 dated milestones, telegram-gateway#1–2, factory#22) was only discoverable from the PRD STATUS over in the factory repo.

This adds the repo-root orientation map:

  • Where the work comes from — the backlog section with the resume protocol (pick the top unblocked issue of the earliest open milestone), Gitea-MCP pointers (list_issues/issue_read, owner arcodange-org), and the owner gotcha for telegram-gateway (owner arcodange, not arcodange-org).
  • Repo map — chart/ops/bin/skills/test + the not-yet-landed fleet/ (tracked by #38).
  • Operating rules — trunk reserved, Gitea-not-gh, read-only prod (voir_tous trap), sandbox rehearsal + human-gated promote (ADR-0003), append-only ledger grammar, anti-hallucination write contract (PRD pointers), disposable sandbox checkpoints, read-only bank/mail.

Advances erp#38 (the AGENTS.md seed; the fleet/ scaffold and the full fleet section remain in #38's scope — do not close).

Advances PRD: vibe/PRD/ai-back-office (agent-catalog "document surface" — AGENTS.md row).

🤖 Generated with Claude Code

## What Agents landing in this repo had **no entry point**: no `AGENTS.md`, and the backlog (erp#38–57 on 6 dated milestones, telegram-gateway#1–2, factory#22) was only discoverable from the PRD STATUS over in the factory repo. This adds the repo-root orientation map: - **Where the work comes from** — the backlog section with the resume protocol (*pick the top unblocked issue of the earliest open milestone*), Gitea-MCP pointers (`list_issues`/`issue_read`, owner `arcodange-org`), and the owner gotcha for telegram-gateway (owner `arcodange`, not arcodange-org). - **Repo map** — chart/ops/bin/skills/test + the not-yet-landed `fleet/` (tracked by #38). - **Operating rules** — trunk reserved, Gitea-not-gh, read-only prod (`voir_tous` trap), sandbox rehearsal + human-gated promote (ADR-0003), append-only ledger grammar, anti-hallucination write contract (PRD pointers), disposable sandbox checkpoints, read-only bank/mail. **Advances erp#38** (the `AGENTS.md` seed; the `fleet/` scaffold and the full fleet section remain in #38's scope — do not close). **Advances PRD:** [vibe/PRD/ai-back-office](https://gitea.arcodange.lab/arcodange-org/factory/src/branch/arcodange/prd-ai-back-office/vibe/PRD/ai-back-office/README.md) (agent-catalog "document surface" — `AGENTS.md` row). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
arcodange added 1 commit 2026-07-11 20:07:40 +02:00
Agents landing in this repo had no entry point: no AGENTS.md, and the
backlog (erp#38-57 on 6 dated milestones, gateway#1-2, factory#22)
was only discoverable from the PRD STATUS in the factory repo. This
seeds the repo-root orientation map: where the work comes from (resume
protocol: top unblocked issue of the earliest open milestone, gitea
MCP pointers, owner gotcha for telegram-gateway), the repo map, the
operating rules (trunk/worktrees, read-only prod, sandbox+promote
gate, append-only ledger, anti-hallucination contract pointers).

Advances erp#38 (AGENTS.md seed; the fleet/ scaffold and the full
fleet section remain in #38's scope).

Co-Authored-By: Claude Fable 5 <[email protected]>
arcodange added 1 commit 2026-07-11 20:17:23 +02:00
arcodange added 1 commit 2026-07-11 20:19:34 +02:00
arcodange merged commit bceeb7dc19 into main 2026-07-11 20:21:22 +02:00
arcodange deleted branch arcodange/agents-md-backlog 2026-07-11 20:21:23 +02:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: arcodange-org/erp#58