Elegance Pipeline

Multi-agent code-elegance workflow with persistent state and stage gates.

Pipeline stages

4 Scouts (parallel, sonnet) -> 2 Judges (parallel, opus) -> 1 Planner (opus)
  -> 1 Verifier (opus) -> 1 Implementer (gated, opus)

State manager

All orchestration goes through the pipeline state manager:

python ${CLAUDE_PLUGIN_ROOT}/elegance_pipeline/pipeline.py [--state-dir <dir>] <command>

Commands: init, status, prompt, submit, signal

Default state lives at .claude/elegance_pipeline/state/ and is shared by default. If you want one dedicated team per spec, give each run its own --state-dir.

How to orchestrate

1. Run status to see which slots are ready
2. For each ready slot, run prompt --role <role> --slot <slot> to get the task prompt
3. Spawn the appropriate fully qualified subagent (elegance-pipeline:elegance-scout, elegance-pipeline:elegance-judge, elegance-pipeline:elegance-planner, elegance-pipeline:elegance-verifier, or elegance-pipeline:elegance-implementer). If your runtime exposes a different fully qualified name, use that exact identifier instead of the bare short name.
4. After each agent completes, submit its output via the state manager
5. Run status again to see what unlocked
6. Repeat until the pipeline is complete or blocked

Orchestration rules

• Scouts run in parallel (all 4 at once via background agents)
• Judges run in parallel after ALL scouts are submitted
• Planner runs after BOTH judges are submitted
• Verifier runs after the planner is submitted
• Implementer only runs when the implementation signal is READY
• Never bypass stage gates
• If the verifier says no implementation is warranted, stop

Agent model mapping

Manual signal override

python ${CLAUDE_PLUGIN_ROOT}/elegance_pipeline/pipeline.py [--state-dir <dir>] signal on
python ${CLAUDE_PLUGIN_ROOT}/elegance_pipeline/pipeline.py [--state-dir <dir>] signal off

If Connectors Available

• github Post elegance score deltas as PR review comments
• linear Create refactor tasks from planner output when implementer gate opens
• slack Notify on pipeline completion with verdict and scout findings summary
• jira Log verifier decision and refactor scope as a Jira ticket