Skip to content

fix: align framework docs with canonical counts and stale references - #106

Merged
striderZA merged 1 commit into
masterfrom
fix/docs-consistency-2026-08-11
Aug 11, 2026
Merged

fix: align framework docs with canonical counts and stale references#106
striderZA merged 1 commit into
masterfrom
fix/docs-consistency-2026-08-11

Conversation

@striderZA

Copy link
Copy Markdown
Owner

Summary

Framework-wide documentation consistency fix after a six-scout audit of AGENTS.md, docs/, tests/, and module manifests. All counts now match the canonical source of truth: 52 agents / 77 commands / 22 modules / 11 rules.

What changed

Count corrections (52 / 77 / 22) across AGENTS.md, README, docs/framework/, docs/pi-.md, docs/WORKFLOW-GUIDE.md, docs/CONTRIBUTING.md, docs/hybrid-workflow.md.

Completeness fixes

  • AGENTS.md command table: added 9 undocumented commands (adopt, ux-design, ux-review, explore, hybrid-prototype, team-live-ops, art-generate, skill-improve, skill-test)
  • skills-reference.md: 73 → 77 commands; added 7 missing skills (art-bible, asset-spec, art-generate, security-audit, skill-improve, day-one-patch, explore)
  • agent-roster.md: added missing godot-csharp-specialist, raylib-specialist, sfml-specialist (now 52/52)
  • directory-structure.md: added engine-bevy module; plugin test count 11/140+ → 18/158

Bug fixes

  • .agents/modules/installed.json: engine-bevy manifest had empty files array — populated with agents/bevy-specialist.md (OpenCode manifest was correct; Pi manifest stale)
  • workflow-catalog.yaml: /brainstorm → /concept-brainstorm in docs/ + both core-module copies
  • CI: added validate-plugins job — the advertised 18-suite/158-test plugin suite was never run in agent-validation.yml
  • engine-unity modulefile: aligned 0.7.0 → 0.6.0 to match manifest + sibling modules

Documentation

  • docs/AGENTS.md: de-hardcoded godot as the current engine
  • engine-reference/README.md: documented PLUGINS.md structure
  • README.md: documented npm run test:parity

Verification

  • node tests/agents/validate.mjs → 207/207 PASS
  • node tests/workflow/run-all.mjs → 4/4 suites PASS
  • node tests/modules/validate-modules.mjs → 22/22 PASS
  • npm run test:plugins → 18 suites, 158 tests, 0 fail
  • Repo-wide grep: no stale counts, no /brainstorm references remaining

- Correct agent/command/module counts (52/77/22) across AGENTS.md, README,
  docs/framework, Pi docs, WORKFLOW-GUIDE, and CONTRIBUTING
- Add 9 missing commands to AGENTS.md table and 7 missing skills to
  skills-reference; add godot-csharp/raylib/sfml3 specialists to roster
- Fix /brainstorm -> /concept-brainstorm in workflow catalog and core
  module copies; de-hardcode godot as current engine in docs/AGENTS.md
- Populate engine-bevy files list in Pi install manifest; align
  engine-unity module version to 0.6.0
- Add plugin tests job (18 suites / 158 tests) to CI workflow; document
  test:parity and PLUGINS.md engine-reference structure
@striderZA
striderZA merged commit 5a8c5b8 into master Aug 11, 2026
5 checks passed
@striderZA
striderZA deleted the fix/docs-consistency-2026-08-11 branch August 11, 2026 18:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant