| name | ws |
| description | Use when scanning, finding, resuming, merging, branching, or untangling Lev workstreams. |
| skill_type | workflow |
| category | lifecycle |
| output_template | hud |
/ws - Workstream Operations
Workstream YAML is the durable identity for lifecycle work until workstreams are
graph ops. /ws is the projection and repair surface around
.lev/pm/workstreams/*/state/workstream.yaml.
Work Link
Lifecycle lane: Router
Entity movement: unknown | stale | split -> routed | active | paused
Workstream: this skill resolves or updates workstream identity
Upstream: /work, any lifecycle skill missing workstream context
Downstream: /work, /capture, /propose, /exec, /handoff
Router: /work
HUD: end with 🧬 {ws} ⚡{exec_count} 📥{capture_count} ⏸️{paused_count} ✅{done_count} | 🚦{gate}={score} | ⏭️ {next} | 🔁{loop_state}
Commands
/ws # scan all workstreams
/ws list # same as /ws
/ws find <query> # search workstreams and projections
/ws show <id> # show one workstream state
/ws resume <id> # load state, recent projections, and next verb
/ws merge <a> <b> # combine lineages with conflicts called out
/ws branch <id> <name> # fork a workstream
/ws untangle # detangle agents/lane claims
Protocol
steps:
- id: read_state
action: Read matching workstream YAML files.
validation: "At least one state file was read, or no match is explicit."
on_failure: "Do not infer identity from memory only."
- id: associate_projection
action: Link handoffs, plans, captures, decisions, and tasks that mention the workstream.
validation: "Output separates durable state from projection files."
on_failure: "Show durable state only and mark projections unknown."
- id: choose_next_verb
action: Recommend the lifecycle owner for the next entity movement.
validation: "Next verb is one of /capture, /prior-art, /propose, /exec, /close, /handoff."
on_failure: "Route back to /work."
Data Sources
.lev/pm/workstreams/*/state/workstream.yaml
.lev/pm/workstreams/*/captures/*
.lev/pm/tasks/*/{dna.yaml,execution.yaml}
.lev/pm/handoffs/*.md as projections
.lev/pm/plans/*.md, .lev/pm/designs/*.md, .lev/pm/decisions/*
.lev/mail/* when detangling
Rules
- Workstream YAML wins over handoff markdown.
- Merges preserve both lineages and flag conflicting objectives.
- Branches copy the parent state, set provenance to the parent, and clear session extensions.
- Resume reports what changed since the last projection before proposing a next verb.
Related
/work routes after /ws resolves identity.
/handoff writes end-of-session state.
/capture writes workstream capture artifacts.