compound-workflow 1.5.0 → 1.6.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "compound-workflow",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Clarify -> plan -> execute -> verify -> capture workflow: commands, skills, and agents for Claude Code",
   "author": {
     "name": "Compound Workflow"

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "compound-workflow",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Clarify -> plan -> execute -> verify -> capture workflow for Cursor",
   "author": {
     "name": "Compound Workflow"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compound-workflow",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Clarify → plan → execute → verify → capture. One Install action for Cursor, Claude, and OpenCode.",
   "license": "MIT",
   "repository": {

package/scripts/install-cli.mjs

@@ -364,6 +364,19 @@ function main() {
   const args = parseArgs(process.argv);
   const targetRoot = realpathSafe(args.root);
 
+  const genScript = path.join(PACKAGE_ROOT, "scripts", "generate-platform-artifacts.mjs");
+  if (fs.existsSync(genScript)) {
+    const result = spawnSync(process.execPath, [genScript], {
+      cwd: PACKAGE_ROOT,
+      stdio: "pipe",
+      encoding: "utf8",
+    });
+    if (result.status !== 0) {
+      console.error("Failed to regenerate manifest:", result.stderr || result.error || "unknown");
+      process.exit(1);
+    }
+  }
+
   try {
     GENERATED_MANIFEST = readGeneratedManifest();
     PACKAGE_COMMAND_ROOT = GENERATED_MANIFEST.commandRoot;

package/src/.agents/commands/workflow/plan.md

@@ -833,6 +833,8 @@ Write the complete plan file to `docs/plans/YYYY-MM-DD-<type>-<slug>-plan.md`. T
 
 Confirm: "Plan written to docs/plans/[filename]"
 
+**Auto technical review (when Fidelity is Medium or High):** After writing the plan file, if the declared **Fidelity is Medium or High**, automatically run technical review: run **Task planning-technical-reviewer(plan_path)** when the environment can run the Task, or load the `technical-review` skill so the subagent is used when available. Use the plan path just written. If Fidelity is Low, skip this step; the user can still choose "Technical review" from Post-Generation Options or call `/workflow:tech-review` later.
+
 **Non-interactive mode:** When the invocation is non-interactive (e.g., `workflow:plan` run by automation, CI, or with an explicit non-interactive flag/convention), skip AskQuestion calls and do not present Post-Generation Options. For determinism, the repo should define the flag or convention (e.g., in `AGENTS.md` Repo Config Block or a documented env var). Still **declare** Fidelity, Confidence, Solution scope, Spike evaluation, Spikes needed, Research mode, and Open questions in the required announcement format before writing the plan. Use these defaults when user input is unavailable: fidelity = Medium, confidence = Medium, solution_scope = full_remediation, spike evaluation = not-required unless risky-work triggers are present, spikes needed = n/a when spike evaluation is not required, research mode = local + external for Medium/High risk topics else local only. Proceed directly to writing the plan file and then exit or return the plan path as output.
 
 **Required in plan frontmatter:** Add these fields to the plan file:

package/src/.agents/commands/workflow/tech-review.md

@@ -0,0 +1,28 @@
+---
+name: tech-review
+invocation: workflow:tech-review
+description: Run technical review on a plan (technical correctness before build). Optional plan path or latest in docs/plans/.
+argument-hint: "[optional: plan path]"
+---
+
+# /workflow:tech-review
+
+Run technical review on a feature approach or plan document. Checks technical alignment with architecture, code standards, and quality before build. Does not edit the plan; use `document-review` after technical review to apply agreed changes.
+
+Contract precedence: if this command conflicts with other workflow docs, follow `docs/principles/workflow-baseline-principles.md`, then `src/AGENTS.md`, then this command.
+
+## Inputs
+
+- **Plan path (optional):** `$ARGUMENTS` — path to the plan file (e.g. `docs/plans/YYYY-MM-DD-<type>-<slug>-plan.md`).
+- If not provided: use the plan from context, or discover the most recent plan in `docs/plans/` (e.g. by date prefix) or `docs/brainstorms/`.
+
+## Execution
+
+1. Resolve the plan document (from argument, context, or discovery).
+2. Load the `technical-review` skill and run it on that plan. The skill runs **Task planning-technical-reviewer(plan_path)** when the environment can run the Task, then synthesizes the verdict and findings queue.
+3. After technical review, if the user agrees to changes, recommend loading `document-review` to update the plan, then proceed to build when ready.
+
+## Guardrails
+
+- Do not modify the plan in this command; technical review is read-only. Apply changes via document-review or user edit.
+- Do not create commits, push branches, or create pull requests.

package/src/.agents/skills/technical-review/SKILL.md

@@ -23,9 +23,8 @@ Primary execution model: run an independent planning-phase pass first using `pla
 
 ## Step 1.5: Independent Fresh-Context Pass (Required)
 
-- If `planning-technical-reviewer` exists under `.agents/agents/review/`, run it on the plan first.
-- Treat its blocking findings as pre-build blockers.
-- If the agent is not available, explicitly state: "planning-technical-reviewer unavailable; running direct technical review (degraded bias resistance)".
+- Run **Task planning-technical-reviewer(plan_path)** when the environment can run the Task; treat its output as the independent pass and its blocking findings as pre-build blockers.
+- If the Task cannot be run (e.g. no subagent/mcp_task support), explicitly state: "planning-technical-reviewer unavailable; running direct technical review (degraded bias resistance)" and perform the review in-context (load the planning-technical-reviewer agent doc and execute that review in this conversation), then synthesize the verdict.
 
 ## Step 1.6: Build Findings Queue (Required)
 

package/src/AGENTS.md

@@ -30,9 +30,10 @@ This `.agents` workspace is portable and command-first.
 4. `/workflow:review` -> validate quality
 5. `/workflow:compound` -> capture durable learnings
 
-Optional manual step:
+Optional manual steps:
 
 - `/workflow:triage` -> explicitly curate/prioritize backlog items before execution when needed
+- `/workflow:tech-review` -> run technical review on a plan (technical correctness before build); optional plan path
 
 Continuous improvement:
 
@@ -43,9 +44,9 @@ Onboarding:
 
 - `/install` -> one action: writes opencode.json, merges AGENTS.md, creates dirs, preserves Repo Config Block (run `npx compound-workflow install` in the project)
 
-This workspace currently implements `brainstorm`, `plan`, `triage`, `work`, `review`, `compound`, and optional QA utilities.
+This workspace currently implements `brainstorm`, `plan`, `triage`, `work`, `review`, `tech-review`, `compound`, and optional QA utilities.
 
-Use the canonical command names (`/workflow:plan`, `/workflow:work`, `/workflow:review`, etc.). This template does not ship aliases.
+Use the canonical command names (`/workflow:plan`, `/workflow:work`, `/workflow:review`, `/workflow:tech-review`, etc.). This template does not ship aliases.
 
 ## Contract Precedence
 
@@ -168,7 +169,7 @@ worktree_bootstrap_notes:
 
 ## Implemented Components (Current Scope)
 
-- Commands: `workflow:brainstorm`, `workflow:plan`, `workflow:triage`, `workflow:work`, `workflow:review`, `workflow:compound` (under `.agents/commands/workflow/`), plus `test-browser`, `metrics`, `assess`, `install` (root commands)
+- Commands: `workflow:brainstorm`, `workflow:plan`, `workflow:triage`, `workflow:work`, `workflow:review`, `workflow:tech-review`, `workflow:compound` (under `.agents/commands/workflow/`), plus `test-browser`, `metrics`, `assess`, `install` (root commands)
 - Skills: `brainstorming`, `document-review`, `technical-review`, `compound-docs` (alias: `compound_doc`), `capture-skill`, `file-todos`, `agent-browser`, `git-worktree`, `process-metrics`, `react-ddd-mvc-frontend`, `xstate-actor-orchestration`, `standards`, `pii-protection-prisma`, `financial-workflow-integrity`, `audit-traceability`, `data-foundations`
 - Agents:
   - `repo-research-analyst`

package/src/generated/opencode.managed.json

@@ -44,6 +44,11 @@
       "description": "Review a PR/branch/diff with structured findings. Does not implement fixes unless explicitly requested.",
       "rel": "workflow/review.md"
     },
+    {
+      "id": "workflow:tech-review",
+      "description": "Run technical review on a plan (technical correctness before build). Optional plan path or latest in docs/plans/.",
+      "rel": "workflow/tech-review.md"
+    },
     {
       "id": "workflow:triage",
       "description": "Manual triage command to prioritize todo files into an executable ready queue (priority, dependencies, recommended action)",