Parent EPIC: #2003
Goal: Create the durable repository-owned model of the workflow between custom AI agents, including prerequisites, handoffs, feedback loops, artifacts, and terminal states.
Scope:
- Create docs/agents/README.md and docs/agents/orchestration.md.
- Add a Mermaid flowchart and a structured handoff table covering every custom agent.
- Distinguish required handoffs from optional or event-driven paths, and document feedback loops and terminal states.
- Link the guide from docs/index.md and .github/agents/README.md.
Boundary: This issue documents the current process. It does not select or implement a state machine, graph database, external workflow tool, or technical transition gate. Those choices require separate evidence and an ADR.
Verification: Run linter all and cargo test --doc --workspace; compare the guide with every custom profile and render the Mermaid flowchart.
Parent EPIC: #2003
Goal: Create the durable repository-owned model of the workflow between custom AI agents, including prerequisites, handoffs, feedback loops, artifacts, and terminal states.
Scope:
Boundary: This issue documents the current process. It does not select or implement a state machine, graph database, external workflow tool, or technical transition gate. Those choices require separate evidence and an ADR.
Verification: Run linter all and cargo test --doc --workspace; compare the guide with every custom profile and render the Mermaid flowchart.