| name | the-algorithm |
| description | Use when work should run through the Algorithm: current-state to ideal-state, VSA/ISC creation or refinement, effort tiers, seven-phase execution, verification-first planning, euphoric-surprise goals, substantial build/design/refactor/migration work, or explicit Algorithm requests. |
| metadata | {"short-description":"Soma Algorithm execution doctrine"} |
The Algorithm
The Algorithm is Soma's portable execution doctrine. It turns work into a transition from current state to ideal state, captured as a VSA whose criteria are granular, binary, and verifiable.
Prefer the Soma Algorithm harness over freeform execution when it is available. The harness is the deterministic layer; these files are the doctrine and substrate-facing instructions.
Use
- Start with
Workflows/RunAlgorithm.md.
- Read
references/algorithm.md when doctrine detail matters.
- Read
references/capabilities.md before selecting thinking or delegation capabilities.
- Read
references/mode-detection.md when effort tier, fast-path, ideate, optimize, or research mode is ambiguous.
- Read
references/parameter-schema.md for ideate and optimize parameter handling.
- Treat Claude-specific hooks, voice curls, and Claude Code sub-agents as source history, not portable requirements.
Triggers
- algorithm
- ideal state
- VSA
- ISC
- verification criteria
- current state to ideal state
- euphoric surprise
- substantial build/design/refactor/migration work