tuncss-plan-kit 0.2.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # tuncss-plan-kit
 
-Four skills for spec-driven development, installable into Claude Code, Codex CLI, and OpenCode:
+Four skills for spec-driven development, installable into Claude Code, Codex CLI, and Antigravity:
 
 - **`/brainstorm`** — turn an idea into an approved spec (`docs/specs/`)
 - **`/plan-universal`** — turn a spec into an executable plan (`docs/plans/`)
@@ -23,8 +23,8 @@ The installer auto-detects which platform(s) the project uses and writes the rig
 |---|---|
 | `.claude/` or `CLAUDE.md` | Claude Code |
 | `.codex/` | Codex CLI |
-| `.opencode/` | OpenCode |
-| `AGENTS.md` (alone) | Both Codex and OpenCode (they share `AGENTS.md`) |
+| `.agents/` | Antigravity |
+| `AGENTS.md` (alone) | Codex and Antigravity (they share `AGENTS.md`) |
 
 If nothing is detected, pass an explicit target:
 
@@ -44,13 +44,17 @@ Restart your coding agent after install so it picks up the new skills and slash
 |---|---|---|---|
 | Claude Code | `.claude/skills/<n>/SKILL.md` | *(none — skills auto-expose as slash)* | `CLAUDE.md` |
 | Codex CLI | `.agents/skills/<n>/SKILL.md` | `.codex/prompts/<n>.md` | `AGENTS.md` |
-| OpenCode | `.opencode/skills/<n>/SKILL.md` | `.opencode/commands/<n>.md` | `AGENTS.md` |
+| Antigravity | `.agents/skills/<n>/SKILL.md` | *(none — skills auto-expose as slash)* | `AGENTS.md` |
 
-Claude Code automatically exposes any skill named `foo` as `/foo`, so the kit doesn't write wrapper command files for it. Codex and OpenCode don't auto-expose, so wrappers are written there to give you the same `/brainstorm`, `/plan-universal`, `/handoff-plan` UX everywhere.
+Claude Code and Antigravity automatically expose any skill named `foo` as `/foo`, so the kit doesn't write wrapper command files for them. Codex doesn't auto-expose, so wrappers are written there to give you the same `/brainstorm`, `/plan-universal`, `/handoff-plan`, `/changelog` UX everywhere.
 
-With `--global` the same files go to user-wide locations (`~/.claude/`, `~/.agents/`, `~/.codex/`).
+Antigravity and Codex share `.agents/skills/`, so installing both writes those files once — the second platform reports them as already written.
 
-**OpenCode `--global` is supported via an npm-plugin route**: the kit installs itself into `~/.config/opencode/node_modules/`, registers itself in `~/.config/opencode/opencode.json`'s `plugin` array, and drops command wrappers into `~/.config/opencode/commands/`. After install, restart OpenCode — skills appear in every project. (For Claude and Codex, `--global` is a plain file copy.)
+Note: `agy changelog` is Antigravity's own built-in subcommand for release notes. The kit's `/changelog` is a slash command inside the agent session — same word, different place.
+
+With `--global` the same files go to user-wide locations (`~/.claude/`, `~/.agents/`, `~/.codex/`, `~/.gemini/config/`).
+
+**Antigravity `--global` is a plain file copy to `~/.gemini/config/`** — a single location the desktop app, the `agy` CLI, and the IDE all read, so one install covers them all.
 
 Project-local is still the default for all three — recommended unless you specifically want the kit available everywhere.
 
@@ -102,7 +106,7 @@ npx tuncss-plan-kit init [--target=<list>] [--global] [--force]
 
 | Flag | Effect |
 |------|--------|
-| `--target=<list>` | Comma-separated. Values: `claude`, `codex`, `opencode`, `all`. Auto-detected if omitted. |
+| `--target=<list>` | Comma-separated. Values: `claude`, `codex`, `antigravity`, `all`. Auto-detected if omitted. |
 | `--global` | Install to user-wide locations instead of the current project. |
 | `--force` | Overwrite existing skill/command files without warning. |
 
@@ -110,6 +114,11 @@ npx tuncss-plan-kit init [--target=<list>] [--global] [--force]
 
 Existing kits ship dozens of agents and skills you'll never use, but every one of them sits in your context and burns tokens each turn. `tuncss-plan-kit` ships four files that cover the only loop most projects need: design → plan → execute (here or elsewhere) → record. That's it.
 
+## A note on OpenCode
+
+OpenCode was supported through v0.3.0. It was dropped in v0.4.0 because nobody
+on the team uses it any more. If you need it, pin `tuncss-plan-kit@0.3.0`.
+
 ## License
 
 MIT

package/bin/cli.js

@@ -3,12 +3,10 @@
 import fs from "fs";
 import path from "path";
 import os from "os";
-import { spawnSync } from "child_process";
 import { fileURLToPath } from "url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = path.resolve(__dirname, "..");
-const PKG_NAME = "tuncss-plan-kit";
 
 const SKILLS = ["brainstorm", "plan-universal", "handoff-plan", "changelog"];
 const COMMANDS = ["brainstorm", "plan-universal", "handoff-plan", "changelog"];
@@ -45,17 +43,24 @@ const PLATFORMS = {
     }),
     commandsSrc: "codex",
   },
-  opencode: {
-    label: "opencode",
+  // Antigravity reads .agents/ in a workspace and ~/.gemini/config/ globally.
+  // One global location serves all three variants (desktop app, agy CLI, IDE).
+  // Like Claude Code, it expands skills into slash commands on its own, so no
+  // wrapper files are written.
+  antigravity: {
+    label: "antigravity",
     project: {
-      skillsDir: ".opencode/skills",
-      commandsDir: ".opencode/commands",
+      skillsDir: ".agents/skills",
+      commandsDir: null,
       instructionsFile: "AGENTS.md",
     },
-    // Global install for OpenCode uses the npm-plugin route, not file-drop.
-    // See installOpenCodeGlobal().
-    global: null,
-    commandsSrc: "opencode",
+    global: (home) => ({
+      skillsDir: path.join(home, ".gemini", "config", "skills"),
+      commandsDir: null,
+      instructionsFile: path.join(home, ".gemini", "config", "AGENTS.md"),
+    }),
+    commandsSrc: null,
+    skipCommands: true,
   },
 };
 
@@ -90,17 +95,14 @@ Usage:
   npx tuncss-plan-kit init [--target=<list>] [--global] [--force]
 
 Commands:
-  init      Install the three skills (brainstorm, plan-universal, handoff-plan)
-            into the target platform(s).
+  init      Install the four skills (brainstorm, plan-universal, handoff-plan,
+            changelog) into the target platform(s).
 
 Options:
   --target  Comma-separated platforms to install for. Supported:
-              claude, codex, opencode, all
+              claude, codex, antigravity, all
             If omitted, auto-detects from the current directory.
   --global  Install to user-wide locations.
-            For OpenCode this uses the npm-plugin route (installs the package
-            into ~/.config/opencode/node_modules/ and registers it in
-            opencode.json's plugin array).
   --force   Overwrite existing skill/command files without warning.
             (Instruction-file marker blocks are always idempotent.)
 
@@ -127,12 +129,12 @@ function detectTargets(cwd) {
     found.add("claude");
   }
   if (exists(path.join(cwd, ".codex"))) found.add("codex");
-  if (exists(path.join(cwd, ".opencode"))) found.add("opencode");
+  // Antigravity discovers .agents/ and reads AGENTS.md as rules. Its project
+  // paths are a subset of Codex's, so adding it here costs no extra files.
+  if (exists(path.join(cwd, ".agents"))) found.add("antigravity");
   if (exists(path.join(cwd, "AGENTS.md"))) {
-    if (!found.has("codex") && !found.has("opencode")) {
-      found.add("codex");
-      found.add("opencode");
-    }
+    found.add("antigravity");
+    if (!found.has("codex")) found.add("codex");
   }
   return [...found];
 }
@@ -233,7 +235,13 @@ function installPlatform({ platform, isGlobal, force, baseRoot, sharedState }) {
   for (const skill of SKILLS) {
     const src = path.join(PKG_ROOT, "skills", skill, "SKILL.md");
     const dest = path.join(paths.skillsDir, skill, "SKILL.md");
+    // Codex and Antigravity share .agents/skills; don't copy the same file twice.
+    if (sharedState.writtenSkillFiles.has(dest)) {
+      lines.push(`  · ${relPath(dest, displayBase)} (already written this run)`);
+      continue;
+    }
     const r = copyFile(src, dest, force);
+    sharedState.writtenSkillFiles.add(dest);
     lines.push(`  ${statusTag(r.status)} ${relPath(r.dest, displayBase)}`);
   }
 
@@ -268,105 +276,6 @@ function installPlatform({ platform, isGlobal, force, baseRoot, sharedState }) {
   return lines;
 }
 
-function readJsonOrDefault(filePath, fallback) {
-  if (!exists(filePath)) return fallback;
-  try {
-    return JSON.parse(fs.readFileSync(filePath, "utf8"));
-  } catch {
-    return fallback;
-  }
-}
-
-function writeJson(filePath, obj) {
-  ensureDir(path.dirname(filePath));
-  fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + "\n");
-}
-
-function isRunningFromInstalledPackage() {
-  // If our package root contains /node_modules/, we were installed as a dep
-  // (e.g. via `npm install -g` or `npx`). Otherwise we're being run from
-  // source (dev mode).
-  return PKG_ROOT.split(path.sep).includes("node_modules");
-}
-
-function dependencySpec() {
-  // When running from a published install, use a version range so npm
-  // installs from the registry. When running from source (dev), point to
-  // our absolute path with file: so changes are picked up without publish.
-  if (isRunningFromInstalledPackage()) {
-    return `^${readJsonOrDefault(path.join(PKG_ROOT, "package.json"), { version: "0.1.0" }).version || "0.1.0"}`;
-  }
-  return "file:" + PKG_ROOT.split(path.sep).join("/");
-}
-
-function installOpenCodeGlobal() {
-  const home = os.homedir();
-  const ocDir = path.join(home, ".config", "opencode");
-  ensureDir(ocDir);
-  const lines = [];
-
-  // 1. package.json — add or update tuncss-plan-kit dependency
-  const pkgPath = path.join(ocDir, "package.json");
-  const pkg = readJsonOrDefault(pkgPath, {});
-  pkg.dependencies = pkg.dependencies || {};
-  const spec = dependencySpec();
-  const prevSpec = pkg.dependencies[PKG_NAME];
-  pkg.dependencies[PKG_NAME] = spec;
-  writeJson(pkgPath, pkg);
-  lines.push(
-    `  ${prevSpec === spec ? "·" : prevSpec ? "↻" : "✓"} ${relPath(pkgPath, home)} (dep: ${PKG_NAME}@${spec})`
-  );
-
-  // 2. npm install in ocDir
-  // Pass the full command as a single string with shell: true to avoid the
-  // Node DEP0190 warning about unescaped args concatenation. Args are all
-  // hardcoded here so there's no injection surface.
-  const npmBin = process.platform === "win32" ? "npm.cmd" : "npm";
-  const npmRes = spawnSync(`${npmBin} install --silent --no-audit --no-fund`, {
-    cwd: ocDir,
-    stdio: "inherit",
-    shell: true,
-  });
-  if (npmRes.status !== 0) {
-    throw new Error(
-      `npm install failed in ${ocDir} (exit code ${npmRes.status}). Fix the error above and re-run.`
-    );
-  }
-  lines.push(`  ✓ npm install ran in ${relPath(ocDir, home)}`);
-
-  // 3. command wrappers — file-drop into ~/.config/opencode/commands/
-  // (the plugin handles skills via config injection, but command discovery
-  // appears to require file-drop)
-  const cmdDir = path.join(ocDir, "commands");
-  for (const cmd of COMMANDS) {
-    const src = path.join(PKG_ROOT, "commands", "opencode", `${cmd}.md`);
-    const dest = path.join(cmdDir, `${cmd}.md`);
-    const r = copyFile(src, dest, false);
-    lines.push(`  ${statusTag(r.status)} ${relPath(r.dest, home)}`);
-  }
-
-  // 4. opencode.json — add plugin reference (idempotent)
-  const ocJsonPath = path.join(ocDir, "opencode.json");
-  const ocJson = readJsonOrDefault(ocJsonPath, {
-    $schema: "https://opencode.ai/config.json",
-  });
-  ocJson.plugin = ocJson.plugin || [];
-  // Normalize to strings only (we don't use the [string, object] tuple form)
-  const pluginPath = `~/.config/opencode/node_modules/${PKG_NAME}`;
-  const alreadyHas = ocJson.plugin.some(
-    (p) => p === pluginPath || (Array.isArray(p) && p[0] === pluginPath)
-  );
-  if (!alreadyHas) {
-    ocJson.plugin.push(pluginPath);
-  }
-  writeJson(ocJsonPath, ocJson);
-  lines.push(
-    `  ${alreadyHas ? "·" : "✓"} ${relPath(ocJsonPath, home)} (plugin: ${pluginPath})`
-  );
-
-  return lines;
-}
-
 function init(args) {
   const cwd = process.cwd();
 
@@ -405,23 +314,19 @@ function init(args) {
   const sharedState = {
     instructionsBlock: loadInstructionsBlock(),
     writtenInstructionFiles: new Set(),
+    writtenSkillFiles: new Set(),
   };
 
   for (const platform of targets) {
     console.log(`[${platform}]`);
-    if (platform === "opencode" && args.global) {
-      const lines = installOpenCodeGlobal();
-      for (const l of lines) console.log(l);
-    } else {
-      const lines = installPlatform({
-        platform,
-        isGlobal: args.global,
-        force: args.force,
-        baseRoot: cwd,
-        sharedState,
-      });
-      for (const l of lines) console.log(l);
-    }
+    const lines = installPlatform({
+      platform,
+      isGlobal: args.global,
+      force: args.force,
+      baseRoot: cwd,
+      sharedState,
+    });
+    for (const l of lines) console.log(l);
     console.log("");
   }
 

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "tuncss-plan-kit",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
-  "main": ".opencode/plugins/tuncss-plan-kit.js",
   "description": "Four-skill kit for spec-driven development: brainstorm an idea into a spec, turn the spec into an executable plan, hand the plan off to another LLM agent, and record what changed.",
   "bin": {
     "tuncss-plan-kit": "bin/cli.js"
@@ -12,7 +11,6 @@
     "skills/",
     "commands/",
     "templates/",
-    ".opencode/",
     "README.md"
   ],
   "keywords": [

package/.opencode/plugins/tuncss-plan-kit.js

@@ -1,48 +0,0 @@
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillsDir = path.resolve(__dirname, "../../skills");
-
-// Minimal templates: just pass the user's input through. The skill's
-// `description` frontmatter is what triggers the model to invoke the skill
-// when relevant — we don't force-load it from the wrapper, which would
-// dump the full SKILL.md body into the chat in OpenCode's UI.
-const WRAPPERS = {
-  brainstorm: {
-    description: "Turn an idea into an approved spec",
-    template: "$ARGUMENTS\n",
-  },
-  "plan-universal": {
-    description: "Turn an approved spec into an executable implementation plan",
-    template: "$ARGUMENTS\n",
-  },
-  "handoff-plan": {
-    description:
-      "Generate a paste-ready handoff message for another LLM agent to execute the plan",
-    template: "$ARGUMENTS\n",
-  },
-  changelog: {
-    description: "Record what changed in docs/CHANGELOG.md",
-    template: "$ARGUMENTS\n",
-  },
-};
-
-export const TuncssPlanKitPlugin = async () => ({
-  config: async (config) => {
-    config.skills = config.skills || {};
-    config.skills.paths = config.skills.paths || [];
-    if (!config.skills.paths.includes(skillsDir)) {
-      config.skills.paths.push(skillsDir);
-    }
-    config.command = config.command || {};
-    for (const [name, def] of Object.entries(WRAPPERS)) {
-      if (!config.command[name]) {
-        config.command[name] = {
-          template: def.template,
-          description: def.description,
-        };
-      }
-    }
-  },
-});

package/commands/opencode/brainstorm.md

@@ -1,5 +0,0 @@
----
-description: Turn an idea into an approved spec
----
-
-$ARGUMENTS

package/commands/opencode/changelog.md

@@ -1,5 +0,0 @@
----
-description: Record what changed in docs/CHANGELOG.md
----
-
-$ARGUMENTS

package/commands/opencode/handoff-plan.md

@@ -1,5 +0,0 @@
----
-description: Generate a paste-ready handoff message for another LLM agent to execute the plan
----
-
-$ARGUMENTS

package/commands/opencode/plan-universal.md

@@ -1,5 +0,0 @@
----
-description: Turn an approved spec into an executable implementation plan
----
-
-$ARGUMENTS