compound-workflow 1.4.5 → 1.4.7

package/.claude-plugin/plugin.json

@@ -1,9 +1,18 @@
 {
   "name": "compound-workflow",
-  "version": "0.1.0",
-  "description": "Clarify → plan → execute → verify → capture workflow: commands, skills, and agents for Claude Code",
-  "author": { "name": "Compound Workflow" },
-  "keywords": ["workflow", "planning", "agents", "skills", "commands"],
+  "version": "1.4.6",
+  "description": "Clarify -> plan -> execute -> verify -> capture workflow: commands, skills, and agents for Claude Code",
+  "author": {
+    "name": "Compound Workflow"
+  },
+  "keywords": [
+    "workflow",
+    "planning",
+    "agents",
+    "skills",
+    "commands",
+    "claude"
+  ],
   "license": "MIT",
   "repository": "https://github.com/cjerochim/compound-workflow",
   "commands": "./src/.agents/commands",

package/.cursor-plugin/plugin.json

@@ -1 +1,20 @@
-{"name":"compound-workflow","version":"0.1.0","description":"Clarify → plan → execute → verify → capture workflow: commands, skills, and agents for Cursor, Claude, and OpenCode","author":{"name":"Compound Workflow"},"keywords":["workflow","cursor","claude","opencode","agents","planning"],"license":"MIT","repository":{"type":"git","url":"https://github.com/cjerochim/compound-workflow"},"agents":"src/.agents/agents","commands":"src/.agents/commands"}
+{
+  "name": "compound-workflow",
+  "version": "1.4.6",
+  "description": "Clarify -> plan -> execute -> verify -> capture workflow for Cursor",
+  "author": {
+    "name": "Compound Workflow"
+  },
+  "keywords": [
+    "workflow",
+    "cursor",
+    "agents",
+    "commands",
+    "skills"
+  ],
+  "license": "MIT",
+  "repository": "https://github.com/cjerochim/compound-workflow",
+  "commands": "src/.agents/commands",
+  "agents": "src/.agents/agents",
+  "skills": "src/.agents/skills"
+}

package/README.md

@@ -2,6 +2,7 @@
 
 Compound Workflow is a portable, command-first system for shipping software with less ambiguity and stronger verification.
 It follows a simple cycle: **clarify -> plan -> execute -> verify -> capture**.
+
 Use it when you want repeatable delivery without ad-hoc process drift.
 
 Inspired by [Compound Engineering](https://every.to/guides/compound-engineering) (Every).
@@ -27,14 +28,19 @@ flowchart LR
 npm install compound-workflow
 ```
 
-`npm install` adds the package and automatically configures your repo (`AGENTS.md`, required directories, and runtime wiring).
+`npm install` adds the package and automatically configures your repo (`AGENTS.md`, required directories, and native OpenCode wiring).
 If your package manager skips lifecycle scripts, run `npx compound-workflow install` manually.
 
 Install configures:
 
 - Workflow template content in `AGENTS.md`
 - Standard workspace directories for plans/todos/docs
-- Runtime configuration used by supported tools
+- `opencode.json` managed entries that reference `node_modules/compound-workflow/src/.agents/*`
+
+## Breaking Change (2.0.0)
+
+2.0.0 removes all legacy compatibility pathways (`/setup`, `/sync`, runtime mirror copies, and Cursor sync fallbacks).
+See migration notes in [docs/migrations/2026-03-03-v2-native-cutover.md](docs/migrations/2026-03-03-v2-native-cutover.md).
 
 ## Critical Path
 
@@ -55,18 +61,18 @@ Optional:
 
 Core flow: `/workflow:brainstorm` -> `/workflow:plan` -> `/workflow:work` -> `/workflow:review` -> `/workflow:compound` -> `/metrics` (optional `/assess` for rollups).
 
-| Command | Purpose | Related skills | Related agents |
-|---|---|---|---|
-| `/install` | Configure workflow files and runtime wiring in the repo | install CLI (no workflow skill routing) | none |
-| `/workflow:brainstorm` | Clarify what to build through structured discussion | `brainstorming` (primary), `document-review` (optional refinement) | `repo-research-analyst` |
-| `/workflow:plan` | Convert intent into an executable plan with fidelity/confidence | state-orchestration skill when needed (for example `xstate-actor-orchestration`) | `repo-research-analyst`, `learnings-researcher`, `best-practices-researcher`, `framework-docs-researcher`, `git-history-analyzer`, `spec-flow-analyzer`, `planning-technical-reviewer` |
-| `/workflow:triage` | Manual queue curation for complex/multi-item backlogs (optional; `/workflow:work` runs triage automatically) | `file-todos` | none |
-| `/workflow:work` | Execute plan/todos with quality gates and validation evidence | `git-worktree`, `file-todos`, `standards`, state-orchestration skill when needed | `repo-research-analyst`, `learnings-researcher`, `best-practices-researcher`, `framework-docs-researcher`, `git-history-analyzer` |
-| `/workflow:review` | Perform independent quality review before completion | `git-worktree` (for non-current targets), `standards` | `learnings-researcher`, `lint`, `bug-reproduction-validator`, `git-history-analyzer`, `framework-docs-researcher`, `agent-native-reviewer` |
-| `/workflow:compound` | Capture reusable implementation learnings in `docs/solutions/` | `compound-docs` (primary), `document-review` (optional) | `learnings-researcher`, `best-practices-researcher`, `framework-docs-researcher` |
-| `/metrics` | Log session outcomes and improvement actions | `process-metrics`, `file-todos` (optional for follow-ups) | none |
-| `/assess` | Aggregate metrics trends and propose process improvements | `file-todos` (for approved follow-up actions) | none |
-| `/test-browser` | Validate affected routes with browser-level checks | `agent-browser`, `git-worktree` (optional branch isolation) | none |
+| Command                | Purpose                                                                                                      | Related skills                                                                   | Related agents                                                                                                                                                                         |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `/install`             | Configure workflow files and runtime wiring in the repo                                                      | install CLI (no workflow skill routing)                                          | none                                                                                                                                                                                   |
+| `/workflow:brainstorm` | Clarify what to build through structured discussion                                                          | `brainstorming` (primary), `document-review` (optional refinement)               | `repo-research-analyst`                                                                                                                                                                |
+| `/workflow:plan`       | Convert intent into an executable plan with fidelity/confidence                                              | state-orchestration skill when needed (for example `xstate-actor-orchestration`) | `repo-research-analyst`, `learnings-researcher`, `best-practices-researcher`, `framework-docs-researcher`, `git-history-analyzer`, `spec-flow-analyzer`, `planning-technical-reviewer` |
+| `/workflow:triage`     | Manual queue curation for complex/multi-item backlogs (optional; `/workflow:work` runs triage automatically) | `file-todos`                                                                     | none                                                                                                                                                                                   |
+| `/workflow:work`       | Execute plan/todos with quality gates and validation evidence                                                | `git-worktree`, `file-todos`, `standards`, state-orchestration skill when needed | `repo-research-analyst`, `learnings-researcher`, `best-practices-researcher`, `framework-docs-researcher`, `git-history-analyzer`                                                      |
+| `/workflow:review`     | Perform independent quality review before completion                                                         | `git-worktree` (for non-current targets), `standards`                            | `learnings-researcher`, `lint`, `bug-reproduction-validator`, `git-history-analyzer`, `framework-docs-researcher`, `agent-native-reviewer`                                             |
+| `/workflow:compound`   | Capture reusable implementation learnings in `docs/solutions/`                                               | `compound-docs` (primary), `document-review` (optional)                          | `learnings-researcher`, `best-practices-researcher`, `framework-docs-researcher`                                                                                                       |
+| `/metrics`             | Log session outcomes and improvement actions                                                                 | `process-metrics`, `file-todos` (optional for follow-ups)                        | none                                                                                                                                                                                   |
+| `/assess`              | Aggregate metrics trends and propose process improvements                                                    | `file-todos` (for approved follow-up actions)                                    | none                                                                                                                                                                                   |
+| `/test-browser`        | Validate affected routes with browser-level checks                                                           | `agent-browser`, `git-worktree` (optional branch isolation)                      | none                                                                                                                                                                                   |
 
 Canonical command docs: [src/.agents/commands/](src/.agents/commands/)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compound-workflow",
-  "version": "1.4.5",
+  "version": "1.4.7",
   "description": "Clarify → plan → execute → verify → capture. One Install action for Cursor, Claude, and OpenCode.",
   "license": "MIT",
   "repository": {
@@ -14,11 +14,12 @@
     "src",
     "scripts",
     ".cursor-plugin",
-    ".claude-plugin",
-    "skills"
+    ".claude-plugin"
   ],
   "scripts": {
     "postinstall": "node scripts/postinstall.mjs",
+    "generate:artifacts": "node scripts/generate-platform-artifacts.mjs",
+    "check:artifacts": "node scripts/generate-platform-artifacts.mjs --check",
     "check:pack-readme": "node scripts/check-pack-readme.mjs",
     "test:install": "node --test tests/install-cli.test.mjs"
   },

package/scripts/generate-platform-artifacts.mjs

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(__dirname, "..");
+const agentsRoot = path.join(repoRoot, "src", ".agents");
+
+function walkFiles(dirAbs, predicate) {
+  const out = [];
+  const stack = [dirAbs];
+  while (stack.length) {
+    const cur = stack.pop();
+    let entries;
+    try {
+      entries = fs.readdirSync(cur, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      const p = path.join(cur, e.name);
+      if (e.isDirectory()) stack.push(p);
+      else if (e.isFile() && predicate(p)) out.push(p);
+    }
+  }
+  out.sort();
+  return out;
+}
+
+function parseFrontmatter(md) {
+  if (!md.startsWith("---\n") && !md.startsWith("---\r\n")) return {};
+  const end = md.indexOf("\n---", 4);
+  if (end === -1) return {};
+  const block = md.slice(4, end + 1);
+  const out = {};
+  for (const line of block.split(/\r?\n/)) {
+    const match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)\s*$/);
+    if (!match) continue;
+    out[match[1]] = (match[2] ?? "").replace(/^"(.*)"$/, "$1").replace(/^'(.*)'$/, "$1");
+  }
+  return out;
+}
+
+function discoverCommands() {
+  const commandsDir = path.join(agentsRoot, "commands");
+  const files = walkFiles(commandsDir, (p) => p.endsWith(".md"));
+  const commands = [];
+
+  for (const fileAbs of files) {
+    const relWithin = path.relative(commandsDir, fileAbs).replaceAll(path.sep, "/");
+    const frontmatter = parseFrontmatter(fs.readFileSync(fileAbs, "utf8"));
+    const id = (frontmatter.invocation || frontmatter.name || path.basename(fileAbs, ".md")).trim();
+    if (!id) continue;
+    commands.push({
+      id,
+      description: (frontmatter.description || id).trim(),
+      rel: relWithin,
+    });
+  }
+
+  return commands.sort((a, b) => a.id.localeCompare(b.id));
+}
+
+function discoverAgents() {
+  const agentDir = path.join(agentsRoot, "agents");
+  const files = walkFiles(agentDir, (p) => p.endsWith(".md"));
+  const agents = [];
+
+  for (const fileAbs of files) {
+    const relWithin = path.relative(agentDir, fileAbs).replaceAll(path.sep, "/");
+    const frontmatter = parseFrontmatter(fs.readFileSync(fileAbs, "utf8"));
+    const id = (frontmatter.name || path.basename(fileAbs, ".md")).trim();
+    if (!id) continue;
+    agents.push({
+      id,
+      description: (frontmatter.description || id).trim(),
+      rel: relWithin,
+    });
+  }
+
+  return agents.sort((a, b) => a.id.localeCompare(b.id));
+}
+
+function normalizeRepoUrl(repoValue) {
+  const raw = typeof repoValue === "string" ? repoValue : repoValue?.url;
+  if (typeof raw !== "string" || raw.trim().length === 0) return "";
+  return raw.replace(/^git\+/, "").replace(/\.git$/, "");
+}
+
+function writeJson(absPath, value, checkOnly, changed) {
+  const next = JSON.stringify(value, null, 2) + "\n";
+  let prev = null;
+  if (fs.existsSync(absPath)) prev = fs.readFileSync(absPath, "utf8");
+
+  if (prev !== next) {
+    changed.push(absPath);
+    if (!checkOnly) {
+      fs.mkdirSync(path.dirname(absPath), { recursive: true });
+      fs.writeFileSync(absPath, next, "utf8");
+      console.log("Wrote:", path.relative(repoRoot, absPath));
+    }
+  }
+}
+
+function main() {
+  const checkOnly = process.argv.includes("--check");
+
+  const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, "package.json"), "utf8"));
+  const repositoryUrl = normalizeRepoUrl(pkg.repository);
+  const commands = discoverCommands();
+  const agents = discoverAgents();
+  const changed = [];
+
+  const claudePlugin = {
+    name: pkg.name,
+    version: pkg.version,
+    description: "Clarify -> plan -> execute -> verify -> capture workflow: commands, skills, and agents for Claude Code",
+    author: { name: "Compound Workflow" },
+    keywords: ["workflow", "planning", "agents", "skills", "commands", "claude"],
+    license: pkg.license,
+    repository: repositoryUrl,
+    commands: "./src/.agents/commands",
+    agents: "./src/.agents/agents",
+    skills: "./src/.agents/skills",
+  };
+
+  const cursorPlugin = {
+    name: pkg.name,
+    version: pkg.version,
+    description: "Clarify -> plan -> execute -> verify -> capture workflow for Cursor",
+    author: { name: "Compound Workflow" },
+    keywords: ["workflow", "cursor", "agents", "commands", "skills"],
+    license: pkg.license,
+    repository: repositoryUrl,
+    commands: "src/.agents/commands",
+    agents: "src/.agents/agents",
+    skills: "src/.agents/skills",
+  };
+
+  const openCodeManaged = {
+    $schema: "https://opencode.ai/config.json",
+    skillsPath: "node_modules/compound-workflow/src/.agents/skills",
+    commandRoot: "node_modules/compound-workflow/src/.agents/commands",
+    agentRoot: "node_modules/compound-workflow/src/.agents/agents",
+    commands,
+    agents,
+  };
+
+  writeJson(path.join(repoRoot, ".claude-plugin", "plugin.json"), claudePlugin, checkOnly, changed);
+  writeJson(path.join(repoRoot, ".cursor-plugin", "plugin.json"), cursorPlugin, checkOnly, changed);
+  writeJson(path.join(repoRoot, "src", "generated", "opencode.managed.json"), openCodeManaged, checkOnly, changed);
+
+  if (checkOnly && changed.length) {
+    console.error("Generated artifacts are stale:");
+    for (const abs of changed) console.error("-", path.relative(repoRoot, abs));
+    process.exit(1);
+  }
+
+  if (!changed.length) {
+    console.log(checkOnly ? "Generated artifacts are up-to-date." : "No artifact updates required.");
+  }
+}
+
+main();