Skip to content

Stale 'af' CLI references in resource docs (post-afx rename cleanup) #712

@waleedkadous

Description

@waleedkadous

Summary

After Spec 647 renamed afafx (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:1002bin/ 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:

  1. 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)
  2. Update codev/resources/claude_vs_codev_task.md to use .codev/config.json
  3. 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
  4. 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)

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions