fix: framework documentation and agent standardization (#80)#90
Merged
Conversation
- Rename 'Core Responsibilities' to 'Key Responsibilities' in 25 agents - Fix heading level drift: promote ### required sections to ## (Collaboration Protocol, Key Responsibilities, What This Agent Must NOT Do, Delegation Map) - Demote all #### headings to ### across all agent files - Rename '## Coordination' to '## Delegation Map' in 8 UE/Unity sub-specialists - Add 'Reports to:' line to all 8 former exception agents - Add 'What This Agent Must NOT Do' section to 8 UE/Unity sub-specialists - Add MCP Integration guidance to Unity, Unreal, SFML 3, and Raylib leads
…ub (#80) - Fix module count: 19/17 -> 21 across README.md and AGENTS.md - Add engine-sfml3 and engine-raylib to README module table (were missing) - Rewrite docs/framework/directory-structure.md with .agents/ as canonical (was stale, showing .opencode/ as canonical root for agents/skills/modules) - Remove docs/framework/review-workflow.md (292-byte stub, zero references, content fully covered by AGENTS.md Coordination Rules)
…#80) - Clear AGENT_EXCEPTIONS list: all 8 UE/Unity sub-specialists now have Delegation Map + Reports to: + What This Agent Must NOT Do sections - Add 'name' to REQUIRED_SKILL_FRONTMATTER (authoring guide requires it, all 77 skills already have it — now enforced by validator) - Fix validator directory paths: .opencode/ -> .agents/ for agents, skills, and commands directories (fixes Windows where git symlinks are text placeholders)
- Add Optional Frontmatter section to authoring-skills.md - Document 'isolation: worktree' field with usage explanation - Document 'context: |' field with shell command examples - Covers fields used by 7 skills (changelog, explore, help, hybrid-prototype, prototype, retrospective, sprint-plan)
striderZA
force-pushed
the
fix/issue-80-framework-standardization
branch
from
July 23, 2026 19:13
001197a to
3939bff
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #80 — addresses 9 documentation and standardization issues identified during framework review.
Changes
Agent Standardization
Documentation
Validator
Authoring Docs
Verification
Commits
fix: standardize agent structure across all 51 agentsdocs: fix module counts, rewrite directory-structure, remove stale stubfix: clear AGENT_EXCEPTIONS, add name to skill frontmatter, fix pathsdocs: document isolation and context frontmatter fields