Workflows

Commands

Command Purpose
/refract:brainstorm <idea> Clarify intent and trade-offs; write DESIGN.md.
/refract:write-plan <design> Turn a confirmed design into a phase plan.
/refract:execute-plan [target] Run or resume one wave of phases through all three gates.
/refract:execute-plan-all [target] Autonomously execute all waves through final audit and consolidation.
/refract:debug <symptom> Diagnose a bug from runtime evidence before fixing it.

In Pi, drop the refract: prefix: /brainstorm, /write-plan, /execute-plan, /execute-plan-all, /debug.

Job workflows

Each job runs one workflow. A profile maps workflows to targets.

Workflow Use
implement Repository changes
review Independent verification of a change
consult Read-only analysis and second opinions
other Anything else; requires an explicit mapping and never falls back

Run without Refract

Set REFRACT_DISABLE=1 to skip the daemon check and tell the host agent to ignore Refract for that session:

REFRACT_DISABLE=1 claude -p "Summarize this repository"

Source: README.md, plugin/README.md