cohorte 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 Entries are shown by `/update-pipeline` ("What's new") after a core refresh. Keep them short,
 user-facing, most recent first. One `## <version> — <YYYY-MM-DD>` section per release.
 
+## 1.3.1 — 2026-07-30
+
+- **`/cycle <feature_id> [max_rounds]`** — a launcher command for the full dev-cycle workflow,
+  so you don't have to phrase the request in prose. It resolves `workflows/cycle.js`
+  (bundled or global), checks the runtime is available (missing ⇒ it hands you the
+  conversational `/build` → `/smoke` → `/review` path instead), sanity-checks the spec is
+  frozen, launches the workflow in the background, then relays the verdict: outcome,
+  contract re-authorings to eyeball, the `questions` array verbatim, and the next step
+  (`/ship` on SHIP-READY, rerun `/cycle` or `/fix` otherwise). Kanban card moves included.
+
 ## 1.3.0 — 2026-07-30
 
 **Token economy — immediate wins, no workflow needed:**

package/README.md

@@ -214,6 +214,7 @@ it in `.claude/pipeline/VERSION` and bundled repos in their committed `pipeline.
 | `/brainstorm`        | Interactive persona panel that pressure-tests a feature idea.                         |
 | `/spec`              | Freeze the feature spec + contract into `specs/<id>.md` (UI features also get a standalone design brief at `specs/design/<id>.md`). Also applies review returns. |
 | `/build <id>`        | Lead authors the contract, then dispatches one implementer per surface in parallel.   |
+| `/cycle <id>`        | Launch the full dev-cycle **workflow** on a frozen spec: build → smoke ∥ review → fix until zero findings; deferred questions in the output. Needs workflows enabled (falls back to the conversational path). |
 | `/smoke <id>`        | Run the feature for real: infra up, contract endpoints, UI flows, design conformance. |
 | `/review <id>`       | Read-only review agents (one per touched surface, parallel) audit the diff vs the spec. |
 | `/fix <id>`          | Apply a review/smoke report: remediation into the spec, re-dispatch only the surfaces with findings. |

package/core/commands/cycle.md

@@ -0,0 +1,54 @@
+---
+model: sonnet
+description: Launch the full dev-cycle workflow (contract → build → smoke ∥ review → fix, until zero findings) for a frozen spec; relay its verdict + deferred questions.
+argument-hint: <feature_id> [max_rounds]
+---
+
+You are the **lead**. Launch the full dev-cycle **workflow** for feature **$ARGUMENTS** — the
+deterministic script does the orchestration (SCHEMA.md §Workflows, `cycle.js`); your job is only to
+start it and relay its result. Do NOT run the phases yourself here — that's the conversational path
+(`/build` → `/smoke` → `/review` → `/fix`), which remains the fallback below.
+
+> **Kanban** (SCHEMA.md §Kanban): move card `#<feature_id>` → **Building** at launch. No-op silently
+> if no board.
+
+## 1. Resolve & check (fail fast, before spending anything)
+
+- Parse `$ARGUMENTS`: the first token is `<feature_id>`, an optional second numeric token is
+  `<max_rounds>` (the workflow defaults to 5).
+- Resolve the script: `.claude/workflows/cycle.js` if it exists, else `~/.claude/workflows/cycle.js`
+  (`test -f`). **Missing both** ⇒ the core predates 1.3.0 or is half-copied: tell the human to run
+  `/update-pipeline`, and stop.
+- **Workflow runtime available?** If the `Workflow` tool is not in your toolset (Claude Code
+  < 2.1.154 or workflows disabled), say so and hand over the conversational path instead:
+  `/build <feature_id>` → `/smoke` → `/review` → `/fix` — same phases, interactive. Stop.
+- Quick spec sanity (the workflow re-checks properly — this just saves a doomed launch):
+  `grep '^status:' specs/<feature_id>.md` must say `frozen` or `in-review`; otherwise tell the human
+  to run `/spec` first, and stop.
+
+## 2. Launch
+
+Call the `Workflow` tool: `scriptPath: <resolved cycle.js path>`,
+`args: {"feature": "<feature_id>", "maxRounds": <max_rounds, omit if not given>}`.
+It runs in the background — tell the human it's off and what it will do (build, then smoke ∥ review
+→ fix rounds until zero findings + PASS; no questions mid-run), and that `/workflows` shows live
+progress. Then END YOUR TURN — never poll, never sleep; the completion notification re-wakes you.
+
+## 3. Relay the result (when the task notification arrives)
+
+The workflow returns only a verdict object — the bulk is already on disk
+(`specs/reports/<feature_id>.md`, spec `## Remediation`). Print, without re-reading any of it into
+context:
+
+- `outcome` · rounds used · review verdict · smoke result.
+- `contractChanges` if any — flag them explicitly: the loop re-authored the frozen contract
+  lead-style; the human should eyeball those hunks in the diff.
+- **The `questions` array, verbatim** — this is the human's inbox from the run (empty when the spec
+  pre-answered everything). Each one is a decision to make, usually by sharpening the spec.
+- The `next` line: **SHIP-READY** ⇒ `/ship <feature_id>` (DoD ticked + freshness stamped — ship is a
+  straight shot, its human confirmation stays). **STOPPED** ⇒ answer the questions, then rerun
+  `/cycle <feature_id>` (it picks up from the spec's Remediation) or finish conversationally with
+  `/fix <feature_id>` + `/review <feature_id>`.
+- **Kanban:** outcome SHIP-READY ⇒ move card → **Review** (the cycle's last verdict is a review);
+  otherwise → **Fix**. No-op silently if no board.
+- **Recommend a `/clear`** — everything the next command needs is on disk.

package/core/commands/doctor.md

@@ -37,7 +37,7 @@ fix only with the human's go-ahead (or hand them the command).
    (`review.md`, `release.md`, `smoke.md`, `profile-reader.md` — repo or `~/.claude/agents/`) must
    each carry their `model:` line too (sonnet/haiku/sonnet/haiku). **Command pins:** every mechanical command file
    (`build`, `review`, `fix`, `smoke`, `ship`, `audit`, `refactor`, `doctor`, `align-ds`,
-   `update-pipeline` — in `.claude/commands/` or `~/.claude/commands/`) carries `model: sonnet` in
+   `update-pipeline`, `cycle` — in `.claude/commands/` or `~/.claude/commands/`) carries `model: sonnet` in
    its frontmatter — ⚠️ if missing (the lead's orchestration turn then bills at the session model,
    e.g. Opus/Fable). `brainstorm`, `spec`, and `init-pipeline` are intentionally unpinned
    (interactive — they inherit the session model).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cohorte",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Portable, stack-agnostic multi-agent development pipeline for Claude Code — install the core, run /init-pipeline, and it adapts to your project's stack.",
   "bin": {
     "cohorte": "bin/cli.js"

package/profile/SCHEMA.md

@@ -318,7 +318,9 @@ Workflow runtime executes instead of the lead reasoning out the fan-out turn by
 `<core>/workflows/review.js`, `audit.js`, `refactor.js` (installed to `.claude/workflows/` bundled or
 `~/.claude/workflows/` global). The conversational commands (`/review`, `/audit`, `/refactor`)
 **remain the default path and the fallback** — a workflow runs only when the human explicitly asks
-for it ("run the review workflow"), and requires Claude Code ≥ **2.1.154** with workflows enabled.
+for it ("run the review workflow", or via the `/cycle <id>` launcher command, which resolves
+`cycle.js` and invokes the runtime for them), and requires Claude Code ≥ **2.1.154** with workflows
+enabled.
 `/doctor` reports which path a session will take. The interactive commands (`/init-pipeline`,
 `/brainstorm`, `/spec`) and the dispatch-only ones (`/build`, `/ship`) have **no** workflow variant on
 purpose: they're interviews or already a single parallel dispatch — a script adds nothing.

package/scripts/validate-core.mjs

@@ -23,7 +23,7 @@ const frontmatter = (text) => {
 // orchestration turn silently bills at the session model — Opus/Fable).
 // Interactive commands must stay unpinned (they inherit on purpose).
 const PINNED = ["build", "review", "fix", "smoke", "ship", "audit",
-  "refactor", "doctor", "align-ds", "update-pipeline"];
+  "refactor", "doctor", "align-ds", "update-pipeline", "cycle"];
 const UNPINNED = ["brainstorm", "spec", "init-pipeline"];
 
 for (const f of readdirSync(join(root, "core/commands"))) {