docs(claude): establish release workflow as default execution layer
Adds a "Release lifecycle" section to CLAUDE.md that makes the release workflow the canonical way to develop, debug, verify, and tag — for both single-agent (phone/remote) and multi-agent (supervised, tmux) modes. Updates the planning section to route plan execution through the workflow rather than directly to subagent-driven-development or executing-plans. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
27
CLAUDE.md
27
CLAUDE.md
@@ -88,7 +88,7 @@ Source code: `ssh://git@git.adlee.work:2222/alee/relicario.git`
|
|||||||
|
|
||||||
## Planning & design specs
|
## Planning & design specs
|
||||||
|
|
||||||
**Before starting any planning or implementation task**, search `docs/superpowers/specs/` for a spec covering the feature area, and `docs/superpowers/plans/` for any existing implementation plan. The specs are the authoritative design record; plans track per-milestone implementation details.
|
**Before starting any planning or implementation task**, search `docs/superpowers/specs/` for a spec covering the feature area, and `docs/superpowers/plans/` for any existing implementation plan. The specs are the authoritative design record; plans track per-milestone implementation details. Once a plan exists, execute it via the release workflow (see **Release lifecycle** below) — not directly via subagent-driven-development or executing-plans unless the workflow is unavailable.
|
||||||
|
|
||||||
Core references (read before touching crypto, data model, or architecture):
|
Core references (read before touching crypto, data model, or architecture):
|
||||||
- `docs/superpowers/specs/2026-04-11-relicario-design.md` — threat model, entropy analysis, crypto pipeline, crate layout
|
- `docs/superpowers/specs/2026-04-11-relicario-design.md` — threat model, entropy analysis, crypto pipeline, crate layout
|
||||||
@@ -97,6 +97,31 @@ Core references (read before touching crypto, data model, or architecture):
|
|||||||
|
|
||||||
After completing any dev iteration, update `STATUS.md` to reflect what shipped and what's now in flight. Update the component doc for any area you changed (see table below).
|
After completing any dev iteration, update `STATUS.md` to reflect what shipped and what's now in flight. Update the component doc for any area you changed (see table below).
|
||||||
|
|
||||||
|
## Release lifecycle
|
||||||
|
|
||||||
|
The `release` workflow (`.claude/workflows/release.js`) is the **default execution layer** for all dev work. Invoke it via the `Workflow` tool or the `/release` skill. Full reference: `docs/superpowers/RELEASE-WORKFLOW.md`.
|
||||||
|
|
||||||
|
### Standard actions
|
||||||
|
|
||||||
|
| Action | When | How |
|
||||||
|
|--------|------|-----|
|
||||||
|
| `develop` + `mode:"single"` | Implement a plan; phone/remote; fire-and-forget | `Workflow({name:"release", args:{action:"develop", mode:"single", release:"<label>"}})` |
|
||||||
|
| `develop` + `mode:"multi"` | Parallel streams; at PC; PM supervises devs | `Workflow({name:"release", args:{action:"develop", mode:"multi", release:"<label>"}})` |
|
||||||
|
| `debug` | Fix a failing test or broken feature after manual testing | `Workflow({name:"release", args:{action:"debug", context:"<paste failure>"}})` |
|
||||||
|
| `verify` | Confirm tests pass before releasing | `Workflow({name:"release", args:{action:"verify"}})` |
|
||||||
|
| `release` | Cut and tag a version | `Workflow({name:"release", args:{action:"release", release:"<label>"}})` |
|
||||||
|
|
||||||
|
### Execution defaults
|
||||||
|
|
||||||
|
- **Single-plan work** → `mode:"single"`. One agent works through tasks sequentially; updates `STATUS.md` automatically on completion.
|
||||||
|
- **Multi-plan or multi-phase work** → `mode:"multi"`. PM agent reads plans, assigns dev streams (up to 6), generates prompt files + a `<release>-launch.sh` in `docs/superpowers/coordination/`. Run the launch script — it starts the relay and opens a tmux session.
|
||||||
|
- **Debugging** → always `action:"debug"`. Never hand-fix without at least trying the debug loop first.
|
||||||
|
- **Releasing** → always `action:"release"`. It verifies first, writes CHANGELOG, tags, and stops before push.
|
||||||
|
|
||||||
|
### Multi-agent relay
|
||||||
|
|
||||||
|
The relay server (`tools/relay/`) supports roles `pm`, `dev-a` through `dev-f`. The launch script starts it automatically. If you need to start it manually: `cd tools/relay && ./start.sh`. Protocol reference: `docs/superpowers/coordination/RELAY.md`.
|
||||||
|
|
||||||
## Roadmap & status
|
## Roadmap & status
|
||||||
|
|
||||||
Current in-flight work: `STATUS.md`. Full roadmap with release targets: `ROADMAP.md`. Wire format reference: `docs/FORMATS.md`.
|
Current in-flight work: `STATUS.md`. Full roadmap with release targets: `ROADMAP.md`. Wire format reference: `docs/FORMATS.md`.
|
||||||
|
|||||||
Reference in New Issue
Block a user