Agent Coordination & Documentation Improvement Plan

Findings

Persona Inconsistency: coordination-board.md uses a mix of legacy IDs (CLAUDE_AIINF) and new canonical IDs (ai-infra-architect).
Tool Underutilization: The protocol in AGENTS.md relies entirely on manual Markdown edits, ignoring the built-in z3ed agent CLI tools (todo, handoff) described in agent-architecture.md.
Fragmented Docs: There is no central entry point (README.md) for agents entering the directory.
Undefined Systems: claude-gemini-collaboration.md references a "challenge system" and "leaderboard" that do not exist.

Mandate CLI Tools: Update the "Quick tasks" and "Substantial work" sections to recommend using z3ed agent todo for personal task tracking.
Clarify Handoffs: Explicitly mention using z3ed agent handoff for transferring context, with the Markdown board used for public signaling.
Strict Persona Usage: Remove "Legacy aliases" mapping and simply link to personas.md as the source of truth.

Header Update: Add a bold warning to use only IDs from personas.md.
Retroactive Fix: Update recent active entries to use the correct new IDs (e.g., convert CLAUDE_AIINF -> ai-infra-architect where appropriate).

Create a simple index file that links to:
- Protocol: AGENTS.md
- Roles: personas.md
- Status: coordination-board.md
- Tools: agent-architecture.md
Provide a 3-step "Start Here" guide for new agents.

Rename to docs/internal/agents/archive/collaboration-concept-legacy.md or remove the "Challenge System" sections if the file is still valuable for its architectural definitions.
Recommendation: If the "Architecture vs. Automation" split is still relevant, update the file to use backend-infra-engineer (Architecture) vs GEMINI_AUTOM (Automation) instead of "Claude vs Gemini".