decompose
Installation
SKILL.md
Decompose
Convert a SPEC.md into a structured spec.json — an ordered list of right-sized user stories with verifiable acceptance criteria and dependency ordering. The output is consumed by /implement and the OpenBolts engine.
This skill is the dedicated planner in a plan-then-execute architecture. It analyzes the spec and codebase to produce a decomposition plan. It does NOT implement, run tests, or modify application code.
Operating assumptions
| Assumption | Type | If violated |
|---|---|---|
bun is available to run validate-spec.ts |
Hard requirement | Error with message: "bun required for spec.json validation" |
| SPEC.md follows /spec's output format | Adaptable | Graceful degradation — warn and proceed with reduced quality (see Phase 1 triage) |
| Codebase is accessible via Read/Glob/Grep | Adaptable | Skip codebase analysis; warn "dependencies inferred from spec only" |
| /implement's spec.json schema (validate-spec.ts) is stable | Hard requirement | scripts/validate-spec.ts is a symlink to /implement's copy — no manual sync needed |
Ship working directory
Output is written to tmp/ship/, derived dynamically from git rev-parse --show-toplevel. Override with CLAUDE_SHIP_DIR_OVERRIDE for Docker/CI/isolated envs.