issues: file #34 (AGENTS.md refresh)
Message
issues: file #34 (AGENTS.md refresh)
Diff
.forge/issues/1155c874-8531-41ee-bbb1-24d8e5b6728f/issue.md+34 −0
--- /dev/null+++ b/.forge/issues/1155c874-8531-41ee-bbb1-24d8e5b6728f/issue.md@@ -0,0 +1,34 @@1+---2+id: 1155c874-8531-41ee-bbb1-24d8e5b6728f3+title: 'AGENTS.md refresh: wiki paths, byte budgets, true merge contract, --skill pointer'4+state: open5+labels: []6+assignees: []7+milestone: null8+created: 2026-09-08T08:40:27.467909782Z9+updated: null10+---11+SOURCE: owner request + orchestrator audit (2026-09-08). The live12+manual (.forge/wiki/docs/AGENTS.md) drifted from reality in four13+places; every other section is still true and stays untouched.14+15+STALE vs CURRENT:16+1. Reading order points at root OUTLINE.md / PLAN.md — they moved to17+ .forge/wiki/docs/ long ago (no root copies exist). Fix the paths.18+2. Budgets bullet lists line caps only. Byte caps are live now:19+ root <=300B/12ln, -h <=250B/8ln, --skill <=1000B/30ln (PLAN20+ [M2] table, in the wiki). Add the byte figures.21+3. "Merges are agent work" bullet says merge "applies, runs CI,22+ lists what conflicted, stops" — omits the never-touch-main truth23+ (#27): f0rge merge CI-gates the patch in a scratch worktree,24+ NEVER touches main or branches; the ORCHESTRATOR fast-forwards25+ the applied sha and deletes the branch; conflicts are reconciled26+ by the agent. Say that.27+4. No mention of the canonical agent contract: `f0rge --skill`28+ (single source of truth; skill.md body == SKILL_TEXT; golden29+ test; 1000B budget). Add one line.30+31+Scope: .forge/wiki/docs/AGENTS.md ONLY. Token-minimal prose; no32+format changes; keep Install section and everything else verbatim.33+DONE: a fresh agent reading this AGENTS.md + `f0rge --skill` can34+run the whole daily loop with zero contradictions.