Standardize agent definitions, fix documentation inconsistencies, and close quality gaps

[striderZA]

Multiple documentation and standardization issues identified during framework review:

Agent standardization:

• Section naming inconsistency: "Key Responsibilities" (28 agents) vs "Core Responsibilities" (23 agents)
• Heading level drift: same sections at ## or ### depending on tier
• 8 exception agents (UE/Unity sub-specialists) use ## Coordination instead of ## Delegation Map
• MCP Integration section only present in Godot agents — no guidance for Unity/Unreal/SFML/Raylib

Documentation inconsistencies:

• docs/framework/directory-structure.md is stale — shows .opencode/ as canonical, missing .agents/ and .pi/
• Module count inconsistency: README says "19", AGENTS.md says "17", actual is 21
• docs/framework/review-workflow.md is a 292-byte stub
• docs/architecture/ has only tr-registry.yaml, no ADRs (referenced as if ADRs should exist)

Validator gaps:

• Validator doesn't check name field (authoring guide requires it)
• isolation and context frontmatter fields used in skills but undocumented in authoring guide

Tasks

• Standardize on "Key Responsibilities" OR "Core Responsibilities" across all 51 agents
• Standardize heading levels (## for all top-level sections)
• Add Reports to: line to 8 exception agents and remove from AGENT_EXCEPTIONS
• Add MCP Integration guidance for Unity/Unreal/SFML/Raylib (or document as Godot-specific)
• Update docs/framework/directory-structure.md to reflect .agents/ as canonical
• Fix module count references across all docs (pick one number, use consistently)
• Expand docs/framework/review-workflow.md or remove if redundant
• Add name to REQUIRED_SKILL_FRONTMATTER in tests/agents/validate.mjs
• Document isolation and context fields in docs/authoring-skills.md

Affected Files

• .agents/agents/*.md (51 files for naming standardization, 8 for exception gaps)
• tests/agents/validate.mjs
• docs/authoring-skills.md
• docs/framework/directory-structure.md
• docs/framework/review-workflow.md
• README.md, AGENTS.md (module count fixes)

---

Identified during comprehensive framework review on 2026-07-21