Summary
After Spec 647 renamed af → afx (PR #649), some live documentation still references the old af CLI or stale paths from the agent-farm restructure. Architect role docs and skeleton skills are clean, but a few codev/resources/ files were missed.
Discovered while reviewing the v3.0.1 release on 2026-04-30.
In-repo references that need updating
Definite fixes
-
codev/resources/risk-triage.md:44 — table cell `packages/codev/src/commands/af/` references a directory that doesn't exist. Agent Farm commands now live in packages/codev/src/agent-farm/commands/. Same line is duplicated in codev-skeleton/resources/risk-triage.md:44 and packages/codev/skeleton/resources/risk-triage.md:44 (the latter is a built artifact synced from codev-skeleton/).
-
codev/resources/claude_vs_codev_task.md:79 — example shell command stages af-config.json. Should be .codev/config.json (the v3 layout).
Needs review (may or may not be stale)
-
codev/resources/arch.md:274 — terminal session naming example: `af-shell-{id}`. If the runtime session prefix has been renamed to afx-shell- or similar, update the doc to match. If session names are still af- for compatibility, leave as-is and add a note.
-
codev/resources/arch.md:1002 — bin/ listing includes af.js alongside afx.js, etc. This is correct — the rename preserved af as an alias and both bin entries still exist (packages/codev/bin/af.js and packages/codev/bin/afx.js). Mention here for completeness only; no change needed.
Out-of-repo (cannot be fixed by a builder)
~/.claude/CLAUDE.md (architect's personal global instructions) — has multiple stale af references in the "🚨 NEVER" rules and "🚨 ABSOLUTE GIT RESTRICTIONS" sections
~/.claude/projects/.../memory/MEMORY.md (AI auto-memory) — has stale af cleanup, af send, af dash references
These are personal/AI-managed and not addressable by this builder.
Suggested approach
Bugfix protocol. Trivial scope:
- Update the two stale lines in
codev/resources/risk-triage.md (and verify the skeleton + built copies — codev-skeleton/ is the source, packages/codev/skeleton/ is the cp -r build output)
- Update
codev/resources/claude_vs_codev_task.md to use .codev/config.json
- Audit
codev/resources/arch.md for any other stale af CLI references (use grep -nE "\\baf\\b" codev/resources/arch.md) and fix or annotate
- Re-grep the live docs (skip
codev/specs/, codev/plans/, codev/reviews/, codev/projectlist-archive.md — those are historical) to confirm no other stale references slipped through
Out of scope
- Historical specs/plans/reviews (e.g.,
codev/plans/0065-bugfix-protocol.md referencing packages/codev/src/commands/af/spawn.ts) — these are records of work done at the time and should not be rewritten
- Project filenames containing "af" (e.g.,
0053-af-open-image-support.md) — immutable historical IDs
- Code that intentionally checks for legacy
af-config.json to emit migration errors (this is by-design backward compat)
Summary
After Spec 647 renamed
af→afx(PR #649), some live documentation still references the oldafCLI or stale paths from the agent-farm restructure. Architect role docs and skeleton skills are clean, but a fewcodev/resources/files were missed.Discovered while reviewing the v3.0.1 release on 2026-04-30.
In-repo references that need updating
Definite fixes
codev/resources/risk-triage.md:44— table cell`packages/codev/src/commands/af/`references a directory that doesn't exist. Agent Farm commands now live inpackages/codev/src/agent-farm/commands/. Same line is duplicated incodev-skeleton/resources/risk-triage.md:44andpackages/codev/skeleton/resources/risk-triage.md:44(the latter is a built artifact synced fromcodev-skeleton/).codev/resources/claude_vs_codev_task.md:79— example shell command stagesaf-config.json. Should be.codev/config.json(the v3 layout).Needs review (may or may not be stale)
codev/resources/arch.md:274— terminal session naming example:`af-shell-{id}`. If the runtime session prefix has been renamed toafx-shell-or similar, update the doc to match. If session names are stillaf-for compatibility, leave as-is and add a note.codev/resources/arch.md:1002—bin/listing includesaf.jsalongsideafx.js, etc. This is correct — the rename preservedafas an alias and both bin entries still exist (packages/codev/bin/af.jsandpackages/codev/bin/afx.js). Mention here for completeness only; no change needed.Out-of-repo (cannot be fixed by a builder)
~/.claude/CLAUDE.md(architect's personal global instructions) — has multiple staleafreferences in the "🚨 NEVER" rules and "🚨 ABSOLUTE GIT RESTRICTIONS" sections~/.claude/projects/.../memory/MEMORY.md(AI auto-memory) — has staleaf cleanup,af send,af dashreferencesThese are personal/AI-managed and not addressable by this builder.
Suggested approach
Bugfix protocol. Trivial scope:
codev/resources/risk-triage.md(and verify the skeleton + built copies —codev-skeleton/is the source,packages/codev/skeleton/is the cp -r build output)codev/resources/claude_vs_codev_task.mdto use.codev/config.jsoncodev/resources/arch.mdfor any other staleafCLI references (usegrep -nE "\\baf\\b" codev/resources/arch.md) and fix or annotatecodev/specs/,codev/plans/,codev/reviews/,codev/projectlist-archive.md— those are historical) to confirm no other stale references slipped throughOut of scope
codev/plans/0065-bugfix-protocol.mdreferencingpackages/codev/src/commands/af/spawn.ts) — these are records of work done at the time and should not be rewritten0053-af-open-image-support.md) — immutable historical IDsaf-config.jsonto emit migration errors (this is by-design backward compat)