compound-workflow 0.1.6 → 0.1.8

package/README.md

@@ -23,11 +23,11 @@ npx compound-workflow install
 
 **2. Choose how you use it:**
 
-- **Cursor:** If your project already has a `.cursor` directory, Install will create a symlink at `.cursor/skills/compound-workflow` so Cursor discovers the workflow skills. No plugin needed for skills. For full commands and agents, use the plugin from this repo (see repo docs for loading a local plugin).
+- **Cursor:** If your project already has a `.cursor` directory, Install will create the correct structure: one symlink per skill under `.cursor/skills/`, plus `.cursor/agents`, `.cursor/commands`, and `.cursor/references` (each symlinked to the package). No plugin needed. Use the plugin from this repo if you need a different loading method.
 - **OpenCode:** Install writes `opencode.json` and a symlink at `.agents/compound-workflow-skills`; OpenCode loads from the package. Run `/install` or `npx compound-workflow install` in the project.
 - **Claude:** Add the compound-workflow plugin from this repo. In any repo, run `/install` or the CLI above.
 
-**What Install does:** Merges `AGENTS.md` (preserves your Repo Config Block), creates standard dirs (`docs/`, `todos/`), writes `opencode.json` (for OpenCode), and—if the project has a `.cursor` directory—creates a symlink at `.cursor/skills/compound-workflow` so Cursor picks up skills. All paths reference `node_modules/compound-workflow`; no file copying.
+**What Install does:** Merges `AGENTS.md` (preserves your Repo Config Block), creates standard dirs (`docs/`, `todos/`), writes `opencode.json` (for OpenCode), and—if the project has a `.cursor` directory—creates `.cursor/skills/<skill>`, `.cursor/agents`, `.cursor/commands`, and `.cursor/references` (symlinks into the package). All paths reference `node_modules/compound-workflow`; no file copying.
 
 **CLI options:** `--dry-run` (preview), `--root /path/to/project`, `--no-config` (skip Repo Config Block reminder).
 
@@ -40,7 +40,7 @@ To update to a new release, see [Updating compound-workflow](#updating-compound-
 ## Updating compound-workflow
 
 - **Cursor (plugin):** If you load the plugin from this repo, pull latest and reload the plugin in Cursor.
-- **Cursor (npm + .cursor):** Run `npm update compound-workflow`, then run **Install** again (`npx compound-workflow install`) to refresh the `.cursor/skills/compound-workflow` symlink and AGENTS.md.
+- **Cursor (npm + .cursor):** Run `npm update compound-workflow`, then run **Install** again (`npx compound-workflow install`) to refresh the `.cursor/skills`, `.cursor/agents`, `.cursor/commands`, and `.cursor/references` symlinks and AGENTS.md.
 - **OpenCode / npm:** Run `npm update compound-workflow` (or bump the version in `package.json` and `npm install`), then run **Install** again. This refreshes `opencode.json`, merges the latest `AGENTS.md` template, and ensures dirs exist; Repo Config Block is preserved.
 - **Claude (plugin):** Update via the editor’s plugin; if from repo, pull latest and reload.
 
@@ -151,9 +151,9 @@ Full “when to use what” and reference standards: [src/AGENTS.md](src/AGENTS.
 
 ## Troubleshooting
 
-**Skills not showing in Cursor?** Cursor discovers skills from (1) the plugin’s `skills/` directory when you load the plugin from this repo, or (2) the project’s `.cursor/skills/` when you use npm: ensure the project has a `.cursor` directory and run `npx compound-workflow install`—Install creates a symlink at `.cursor/skills/compound-workflow`. If skills still don’t appear, check Cursor Settings → Rules and any `permission.skill` settings.
+**Skills not showing in Cursor?** Cursor discovers skills from (1) the plugin’s `skills/` directory when you load the plugin from this repo, or (2) the project’s `.cursor/skills/` when you use npm: ensure the project has a `.cursor` directory and run `npx compound-workflow install`—Install creates the full structure (`.cursor/skills/<skill>`, `.cursor/agents`, `.cursor/commands`, `.cursor/references`). If skills still don’t appear, check Cursor Settings → Rules and any `permission.skill` settings.
 
-**Skills not showing in OpenCode?** OpenCode uses the `.agents/compound-workflow-skills` symlink and `opencode.json` `skills.paths`. Run Install from the project root (`npx compound-workflow install`).
+**Skills not showing in OpenCode?** OpenCode uses the `.agents/compound-workflow-skills` symlink and `opencode.json` `skills.paths`. Run Install from the project root (`npx compound-workflow install`). The learnings-capture skill is named **compound-docs** (hyphen, plural); **compound_doc** (underscore) is an alias that resolves to the same skill.
 
 ---
 

package/package.json

@@ -1 +1 @@
-{"name":"compound-workflow","version":"0.1.6","description":"Clarify → plan → execute → verify → capture. One Install action for Cursor, Claude, and OpenCode.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/cjerochim/compound-workflow.git"},"bin":{"compound-workflow":"scripts/install-cli.mjs"},"files":["src","scripts",".cursor-plugin",".claude-plugin","skills"],"engines":{"node":">=18"}}
+{"name":"compound-workflow","version":"0.1.8","description":"Clarify → plan → execute → verify → capture. One Install action for Cursor, Claude, and OpenCode.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/cjerochim/compound-workflow.git"},"bin":{"compound-workflow":"scripts/install-cli.mjs"},"files":["src","scripts",".cursor-plugin",".claude-plugin","skills"],"engines":{"node":">=18"}}

package/scripts/install-cli.mjs

@@ -208,23 +208,20 @@ function ensureSkillsSymlink(targetRoot, dryRun) {
   }
 }
 
-const CURSOR_SKILLS_LINK = ".cursor/skills/compound-workflow";
-
-function ensureCursorSkills(targetRoot, dryRun) {
+function ensureCursorDirSymlink(targetRoot, cursorSubdir, pkgSubdir, dryRun, label) {
   const cursorDir = path.join(targetRoot, ".cursor");
   if (!fs.existsSync(cursorDir)) return;
+  const pkgPath = path.join(packageRoot, "src", ".agents", pkgSubdir);
+  if (!fs.existsSync(pkgPath)) return;
 
-  const skillsDir = path.join(cursorDir, "skills");
-  const linkPath = path.join(skillsDir, "compound-workflow");
-  const targetRel = path.join("..", "..", "node_modules", "compound-workflow", "src", ".agents", "skills");
+  const linkPath = path.join(cursorDir, cursorSubdir);
+  const targetRel = path.join("..", "node_modules", "compound-workflow", "src", ".agents", pkgSubdir);
 
   if (dryRun) {
-    console.log("[dry-run] Would create", CURSOR_SKILLS_LINK, "symlink (Cursor detected)");
+    console.log("[dry-run] Would create .cursor/" + cursorSubdir, "symlink (Cursor)");
     return;
   }
 
-  if (!fs.existsSync(skillsDir)) fs.mkdirSync(skillsDir, { recursive: true });
-
   let needCreate = true;
   try {
     const stat = fs.lstatSync(linkPath);
@@ -240,8 +237,66 @@ function ensureCursorSkills(targetRoot, dryRun) {
     } catch (_) {}
     const type = process.platform === "win32" ? "dir" : "dir";
     fs.symlinkSync(targetRel, linkPath, type);
-    console.log("Created", CURSOR_SKILLS_LINK, "-> package skills (Cursor)");
+    console.log("Created", ".cursor/" + cursorSubdir, "->", label || pkgSubdir, "(Cursor)");
+  }
+}
+
+function ensureCursorSkills(targetRoot, dryRun) {
+  const cursorDir = path.join(targetRoot, ".cursor");
+  if (!fs.existsSync(cursorDir)) return;
+
+  const packageSkillsDir = path.join(packageRoot, "src", ".agents", "skills");
+  if (!fs.existsSync(packageSkillsDir)) return;
+
+  const skillNames = [];
+  try {
+    for (const name of fs.readdirSync(packageSkillsDir)) {
+      const skillPath = path.join(packageSkillsDir, name);
+      if (fs.statSync(skillPath).isDirectory() && fs.existsSync(path.join(skillPath, "SKILL.md"))) {
+        skillNames.push(name);
+      }
+    }
+  } catch (_) {
+    return;
   }
+
+  const skillsDir = path.join(cursorDir, "skills");
+  const type = process.platform === "win32" ? "dir" : "dir";
+
+  if (dryRun) {
+    console.log("[dry-run] Would create .cursor/skills/<skill> symlinks for:", skillNames.join(", "));
+    return;
+  }
+
+  if (!fs.existsSync(skillsDir)) fs.mkdirSync(skillsDir, { recursive: true });
+
+  for (const name of skillNames) {
+    const linkPath = path.join(skillsDir, name);
+    const targetRel = path.join("..", "..", "..", "node_modules", "compound-workflow", "src", ".agents", "skills", name);
+    let needCreate = true;
+    try {
+      const stat = fs.lstatSync(linkPath);
+      if (stat.isSymbolicLink()) {
+        fs.realpathSync(linkPath);
+        needCreate = false;
+      }
+    } catch (_) {}
+
+    if (needCreate) {
+      try {
+        fs.unlinkSync(linkPath);
+      } catch (_) {}
+      fs.symlinkSync(targetRel, linkPath, type);
+      console.log("Created", ".cursor/skills/" + name, "-> package skill (Cursor)");
+    }
+  }
+}
+
+function ensureCursorIntegration(targetRoot, dryRun) {
+  ensureCursorSkills(targetRoot, dryRun);
+  ensureCursorDirSymlink(targetRoot, "agents", "agents", dryRun, "package agents");
+  ensureCursorDirSymlink(targetRoot, "commands", "commands", dryRun, "package commands");
+  ensureCursorDirSymlink(targetRoot, "references", "references", dryRun, "package references");
 }
 
 function writeOpenCodeJson(targetRoot, dryRun) {
@@ -369,7 +424,7 @@ function main() {
 
   writeOpenCodeJson(targetRoot, args.dryRun);
   ensureSkillsSymlink(targetRoot, args.dryRun);
-  ensureCursorSkills(targetRoot, args.dryRun);
+  ensureCursorIntegration(targetRoot, args.dryRun);
   writeAgentsMd(targetRoot, args.dryRun);
   ensureDirs(targetRoot, args.dryRun);
 

package/src/.agents/scripts/sync-opencode.mjs

@@ -250,9 +250,16 @@ function main() {
   const existing = readJsonMaybeJsonc(opencodeAbs) ?? {};
   const next = structuredClone(existing);
 
+  const SKILLS_COMPOUND_PATH = ".agents/compound-workflow-skills";
   next.$schema = next.$schema || "https://opencode.ai/config.json";
   next.skills = ensureObject(next.skills);
   next.skills.paths = Array.isArray(next.skills.paths) ? next.skills.paths : [".agents/skills"];
+  const hasCompoundWorkflow =
+    fs.existsSync(path.join(rootAbs, "node_modules", "compound-workflow")) ||
+    fs.existsSync(path.join(rootAbs, SKILLS_COMPOUND_PATH));
+  if (hasCompoundWorkflow && !next.skills.paths.includes(SKILLS_COMPOUND_PATH)) {
+    next.skills.paths.unshift(SKILLS_COMPOUND_PATH);
+  }
   next.command = ensureObject(next.command);
   next.agent = ensureObject(next.agent);
 

package/src/AGENTS.md

@@ -142,7 +142,7 @@ worktree_bootstrap_notes:
 ## Implemented Components (Current Scope)
 
 - Commands: `workflow:brainstorm`, `workflow:plan`, `workflow:work`, `workflow:triage`, `workflow:review`, `workflow:compound` (under `.agents/commands/workflow/`), plus `test-browser`, `metrics`, `assess`, `setup`, `sync` (root commands)
-- Skills: `brainstorming`, `document-review`, `technical-review`, `compound-docs`, `file-todos`, `agent-browser`, `git-worktree`, `process-metrics`, `pii-protection-prisma`, `financial-workflow-integrity`, `audit-traceability`, `data-foundations`
+- Skills: `brainstorming`, `document-review`, `technical-review`, `compound-docs` (alias: `compound_doc`), `file-todos`, `agent-browser`, `git-worktree`, `process-metrics`, `pii-protection-prisma`, `financial-workflow-integrity`, `audit-traceability`, `data-foundations`
 - Agents:
   - `repo-research-analyst`
   - `learnings-researcher`
@@ -197,7 +197,7 @@ Maintenance:
 | `brainstorming` | You need structured idea exploration and clarification without writing code. |
 | `document-review` | You need to review a document/spec and extract issues, gaps, and concrete next actions. |
 | `technical-review` | A plan or feature approach has passed document review and must be checked for technical correctness before build. |
-| `compound-docs` | A durable learning (solved problem or implementation insight) should be captured as institutional knowledge. |
+| `compound-docs` (alias: `compound_doc`) | A durable learning (solved problem or implementation insight) should be captured as institutional knowledge. |
 | `file-todos` | You need a file-backed todo workflow for iterative multi-step changes. |
 | `agent-browser` | You need to inspect available agents/skills and route deterministically. |
 | `git-worktree` | You need isolated parallel work (review/feature) using git worktrees. |