docs(lanes): document per-feature state and archive (B)

2026-08-04 15:06:05 +07:00
parent 3a83e849cf
commit 917f0794d5
5 changed files with 129 additions and 2 deletions
@@ -230,6 +230,10 @@ A lane is a durable unit of parallel agent work — one working directory, many
 | `ccam lanes profile check [<path>]` | Validate a profile — parses, every referenced hook exists and is executable, no leftover `TODO:`, declared ports free. `<path>` defaults to the current directory (not a lane id) |
 | `ccam lanes reset\|remove\|purge <id> [--force] [--keep-db] --yes` | Show preflight facts, then perform a destructive action. Refuses without `--yes`; `--force` is required when commits are unpushed; `--keep-db` (`reset` only) skips dropping/recreating a data-isolated lane's database |
 | `ccam stage <stage> [--evidence <text>] [--note <text>] [--result pass\|fail]` | Declare the lane's current pipeline stage. Called by a skill at each phase boundary |
+| `ccam feature list [<id>]` | List every feature this lane has activated, archived or live |
+| `ccam feature activate <slug> [--title text] [<id>]` | Switch to a feature by slug (echoes the canonicalized slug), archiving the current one first |
+| `ccam feature show <slug> [<id>]` | Show one feature's saved pipeline — works on an archived one too |
+

 **Runtime** — the lane's own application stack, as opposed to `start`/`stop`, which drive its Claude run. Two lifecycles, one lane id. Each requires the repository to declare a profile at `<repo>/.ccam/profile/` ([contract](LANES.md#lane-runtime-running-a-lanes-own-stack)); without one they report that nothing is configured rather than failing.