tuncss-plan-kit 0.2.0 → 0.3.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, OpenCode, and Antigravity:
 
 - **`/brainstorm`** — turn an idea into an approved spec (`docs/specs/`)
 - **`/plan-universal`** — turn a spec into an executable plan (`docs/plans/`)
@@ -24,7 +24,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, OpenCode, and Antigravity (they share `AGENTS.md`) |
 
 If nothing is detected, pass an explicit target:
 
@@ -45,14 +46,21 @@ 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 and OpenCode don'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.
+
+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/`).
 
 **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.)
 
-Project-local is still the default for all three — recommended unless you specifically want the kit available everywhere.
+**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 four — recommended unless you specifically want the kit available everywhere.
 
 ## Workflow
 
@@ -102,7 +110,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`, `opencode`, `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. |
 

package/bin/cli.js

@@ -57,6 +57,25 @@ const PLATFORMS = {
     global: null,
     commandsSrc: "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: ".agents/skills",
+      commandsDir: null,
+      instructionsFile: "AGENTS.md",
+    },
+    global: (home) => ({
+      skillsDir: path.join(home, ".gemini", "config", "skills"),
+      commandsDir: null,
+      instructionsFile: path.join(home, ".gemini", "config", "AGENTS.md"),
+    }),
+    commandsSrc: null,
+    skipCommands: true,
+  },
 };
 
 const SUPPORTED = Object.keys(PLATFORMS);
@@ -95,7 +114,7 @@ Commands:
 
 Options:
   --target  Comma-separated platforms to install for. Supported:
-              claude, codex, opencode, all
+              claude, codex, opencode, 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
@@ -128,7 +147,11 @@ function detectTargets(cwd) {
   }
   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"))) {
+    found.add("antigravity");
     if (!found.has("codex") && !found.has("opencode")) {
       found.add("codex");
       found.add("opencode");
@@ -233,7 +256,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)}`);
   }
 
@@ -405,6 +434,7 @@ function init(args) {
   const sharedState = {
     instructionsBlock: loadInstructionsBlock(),
     writtenInstructionFiles: new Set(),
+    writtenSkillFiles: new Set(),
   };
 
   for (const platform of targets) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuncss-plan-kit",
-  "version": "0.2.0",
+  "version": "0.3.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.",