Skip to content

[Framework] Docs claim 54 commands; actual count is 77 #94

Description

@striderZA

Problem

AGENTS.md:194 and README.md:76,89 state "54 commands". Actual count in .agents/commands/ is 77 .md command files (78 entries minus README.md). This is a ~43% undercount, presumably stale since commands were added after the doc was last updated (e.g. art-generate.md, adopt.md).

Validated via tests/agents/validate.mjs (77/77 command definitions pass) and .agents/commands/ directory listing.

Fix

  • Replace hardcoded "54" with "77" in AGENTS.md and README.md (all three occurrences).
  • Consider generating this count at doc-build/validate time instead of hardcoding, to prevent future drift (e.g. validate.mjs could assert the doc-stated count matches the file count).

Acceptance criteria

  • AGENTS.md and README.md show the correct command count
  • Optional: validator or CI check that fails if a doc-stated count drifts from actual file count

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationframework-reviewIdentified during comprehensive framework reviewpriority-highFix soon

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions