Fix release for 1.1.1: the minimal path end to end, engine commands that run on Godot, Unity and Unreal, hook warnings you can see, and verdicts that say when they could not check. Details in CHANGELOG.md; upgrade steps in UPGRADING.md (v1.1.1 → v1.1.2). Fixes #67 Fixes #131 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WuJn2FdynEybfL5KC697nJ
2.7 KiB
Agent Coordination Rules
- Vertical Delegation: Leadership agents delegate to department leads, who delegate to specialists. Never skip a tier for complex decisions.
- Horizontal Consultation: Agents at the same tier may consult each other but must not make binding decisions outside their domain.
- Conflict Resolution: When two agents disagree, escalate to the shared
parent. If no shared parent, escalate to
creative-directorfor design conflicts ortechnical-directorfor technical conflicts. - Change Propagation: When a design change affects multiple domains, the
produceragent coordinates the propagation. - No Unilateral Cross-Domain Changes: An agent must never modify files outside its designated directories without explicit delegation.
Model Tier Assignment
Read .claude/docs/model-tiers.md on demand. It carries the tier table, the
per-skill assignments and the authoring rule.
Load-bearing enough to restate here: whether a skill's model: is used
depends on how the skill starts. Typed as /skill-name: yes, except a haiku
pin in auto mode. Started by Claude through the Skill tool: no. Never tell a
user a haiku skill saves money; an opus skill typed in a Sonnet session
costs more. The agent-side model: is a different mechanism, and is applied.
Subagents vs Agent Teams
This project uses two distinct multi-agent patterns:
Subagents (current, always active)
Spawned via the Agent tool within a single Claude Code session (renamed from
Task in Claude Code 2.1.63; Task still works as an alias). Used by all
team-* skills and orchestration skills. Subagents share the session's
permission context, run sequentially or in parallel within the session, and
return results to the parent.
When to spawn in parallel: If two subagents' inputs are independent (neither
needs the other's output to begin), spawn both Agent calls simultaneously
rather than waiting. Example: /review-all-gdds Phase 2 (consistency) and
Phase 3 (design theory) are independent — spawn both at the same time.
Phase 1 loads the GDDs and both depend on it, so it is the one phase here that
must NOT be parallelised.
Agent Teams (experimental — opt-in)
Multiple independent Claude Code sessions coordinated via a shared task list.
Opt-in and never yet used here — read .claude/docs/agent-teams.md on demand
before proposing one.
Parallel Task Protocol
When an orchestration skill spawns multiple independent agents:
- Issue all independent
Agentcalls before waiting for any result - Collect all results before proceeding to dependent phases
- If any agent is BLOCKED, surface it immediately — do not silently skip
- Always produce a partial report if some agents complete and others block