This package contains the full-chain Relay refactor discussed in the design conversation.

Relay is a repository-native AI workflow system built around:

• four short roles: Planner, Builder, Reviewer, Tester
• file-first handoff packets
• YAML-driven workflows
• gates and validators
• a Python runner
• optional adapters for Manual, Copilot CLI, Codex CLI, and Claude Code

Relay does not depend on chat memory as the workflow source of truth.

Each step reads the previous handoff file, produces its own artifact, and writes the next handoff. If chat history conflicts with handoff files, handoff files win.

• .relay/00-context describes the current project.
• .relay/01-roles describes the four role responsibilities.
• .relay/02-skills indexes optional skills.
• .relay/03-rules defines Relay protocol rules.
• .relay/04-templates defines artifacts and handoffs.
• .relay/05-runtime is the runner source of truth.
• .relay/06-runs stores task runs.
• .relay/07-runner contains the Python runner.

Workflow order is defined only in .relay/05-runtime/workflows/*.yaml. Do not duplicate executable workflow order in Markdown files.

Unix/macOS:

./relay start --workflow feature-development --title "Add login feature"
./relay status
./relay next

Windows PowerShell:

.\relay.ps1 start --workflow feature-development --title "Add login feature"
.\relay.ps1 status
.\relay.ps1 next

• feature-development: requirement -> plan -> build -> review -> test -> fix loop -> final
• bugfix-fast: triage -> root cause -> fix -> review -> regression -> final
• bugfix-safe: triage -> root cause -> fix plan gate -> fix -> review -> regression -> final
• refactor: scope -> plan -> refactor -> review -> regression -> final
• investigation: frame -> investigate -> review findings -> final

• Planner: requirements, bug triage, scope, acceptance criteria
• Builder: implementation plan, root cause, coding, fixes
• Reviewer: code review, diff risk review, scope review
• Tester: behavioral validation, regression, evidence

Copy these files into the target repository root:

AGENTS.md
CLAUDE.md
relay
relay.ps1
.github/copilot-instructions.md
.relay/

Then update .relay/00-context/* with the real project details.