class-ai-agent 1.2.3 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # AI Agent Project
 
-**Production-grade configuration for [Claude Code](https://code.claude.com/docs) and [Cursor](https://cursor.com)** — shared rules, specialized agents, workflow prompts, and checklists you can drop into any repository.
+**Production-grade configuration for [Claude Code](https://code.claude.com/docs), [Cursor](https://cursor.com), and [Kiro](https://kiro.dev)** — shared rules, specialized agents, workflow prompts, and checklists you can drop into any repository.
 
 <div align="center">
 
@@ -18,7 +18,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
   <a href="https://www.npmjs.com/package/class-ai-agent"><img src="https://img.shields.io/npm/v/class-ai-agent?label=npm&logo=npm&style=flat-square" alt="npm version" /></a>
   <img src="https://img.shields.io/badge/node-%3E%3D16.7-339933?logo=node.js&logoColor=white&style=flat-square" alt="Node.js 16.7+" />
   <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License MIT" />
-  <img src="https://img.shields.io/badge/version-1.2.3-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-1.4.0-blue?style=flat-square" alt="Version" />
 </p>
 
 </div>
@@ -29,6 +29,8 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
 
 - [Why use this](#why-use-this)
 - [Install (quick)](#install-quick)
+- [CodeGraph (code intelligence)](#codegraph-code-intelligence)
+- [Agent continuity (cross-tool)](#agent-continuity-cross-tool)
 - [Overview](#overview)
 - [Development workflow](#development-workflow)
 - [Project structure](#project-structure)
@@ -38,6 +40,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
 - [Using commands & agents](#using-commands--agents)
 - [Key concepts](#key-concepts)
 - [Security](#security)
+- [Release notes](#release-notes)
 - [Contributing](#contributing)
 - [Publishing to npm (maintainers)](#publishing-to-npm-maintainers)
 - [Credits](#credits)
@@ -48,13 +51,32 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
 
 | You get | Details |
 |--------|---------|
-| **Two layouts** | **`.claude/`** for Claude Code (`.md` rules) and **`.cursor/`** for Cursor (`.mdc` rules + `CURSOR.md`) |
+| **Three layouts** | **`.claude/`** (Claude Code), **`.cursor/`** (Cursor), **`.kiro/`** (Kiro steering + MCP) |
 | **One workflow** | Spec → Plan → Build → Test → Review → Ship |
 | **10 agent personas** | Frontend, backend, architect, review, QA, security, PM, UX, SEO, test engineer |
 | **13 topic rules** | Code style, security, API, DB, testing, git, and more (same ideas in both trees) |
 | **`npx` installer** | Copies the folders into your project in one command |
+| **CodeGraph** | MCP + usage rules for Cursor and Kiro; local index via [CodeGraph](https://github.com/colbymchenry/codegraph) |
+| **Agent continuity** | Committed **`.agent/SESSION.md`** — `/resume` and `/handoff` across Cursor, Claude Code, and Kiro |
 
-Root **`AGENTS.md`** points Cursor at **`.cursor/CURSOR.md`**.
+Root **`AGENTS.md`** links hubs: **`.cursor/CURSOR.md`**, **`.kiro/KIRO.md`**, **`.claude/CLAUDE.md`**.
+
+---
+
+## Agent continuity (cross-tool)
+
+When one agent stops and another starts (new chat, different IDE, or teammate), **`npx class-ai-agent`** installs **`.agent/SESSION.md`** — a committed handoff file shared by all tools.
+
+| Command | When |
+|---------|------|
+| **`/resume`** | Session start — read SESSION, `tasks/todo.md`, linked spec; summarize and continue |
+| **`/handoff`** | Session end — update SESSION, sync tasks, note blockers |
+
+**Read order:** `.agent/SESSION.md` → `tasks/todo.md` → `SPEC.md` (from SESSION pointers).
+
+Rules: `.cursor/rules/agent-continuity.mdc`, `.claude/rules/agent-continuity.md`, `.kiro/steering/agent-continuity.md`. Reference: `.cursor/references/agent-continuity.md`.
+
+Do **not** put secrets or PII in `SESSION.md`. See [`.agent/README.md`](.agent/README.md).
 
 ---
 
@@ -66,12 +88,21 @@ Requires **Node.js [16.7+](https://nodejs.org/)**.
 npx class-ai-agent
 ```
 
-Install into another directory, or only Claude / only Cursor:
+The installer also runs **`npx @colbymchenry/codegraph init -i`** in the target directory (builds `.codegraph/` and adds it to `.gitignore`). **Node 20+** is recommended for CodeGraph. First run may take a minute while the index builds.
+
+Skip indexing (copy-only, e.g. CI):
+
+```bash
+CODEGRAPH_SKIP_INIT=1 npx class-ai-agent
+```
+
+Install into another directory, or only one agent target:
 
 ```bash
 npx class-ai-agent --dir /path/to/your/project
 npx class-ai-agent --claude
 npx class-ai-agent --cursor
+npx class-ai-agent --kiro
 npx class-ai-agent --force    # overwrite existing
 npx class-ai-agent --help
 ```
@@ -85,29 +116,48 @@ npm exec -- class-ai-agent --dir /path/to/your/project
 # or: node bin/class-ai-agent.cjs --dir /path/to/your/project
 ```
 
-**Manual copy:** copy **`.claude/`**, **`.cursor/`**, and **`AGENTS.md`** into your project root.
+**Manual copy:** copy **`.agent/`**, **`.claude/`**, **`.cursor/`**, **`.kiro/`**, and **`AGENTS.md`** into your project root. Copy `.agent/SESSION.template.md` → `.agent/SESSION.md` if needed. Then run `npx @colbymchenry/codegraph init -i` and reload Cursor / restart Kiro.
+
+---
+
+## CodeGraph (code intelligence)
+
+[class-ai-agent](https://www.npmjs.com/package/class-ai-agent) integrates **[CodeGraph](https://github.com/colbymchenry/codegraph)** — a local knowledge graph of symbols, call edges, and routes — so agents can answer structural questions with fewer grep/read tool calls.
+
+| Topic | Details |
+|-------|---------|
+| **What you get** | Cursor + Kiro MCP config, usage rules, auto `init -i`, `.codegraph/` gitignored |
+| **Cursor** | `.cursor/mcp.json`, `.cursor/rules/codegraph.mdc` — reload window after install |
+| **Kiro** | `.kiro/settings/mcp.json`, `.kiro/steering/codegraph.md` — restart Kiro after install |
+| **Claude Code** | Not wired by this package — `codegraph install --target=claude` (see `.claude/references/codegraph.md`) |
+| **Manual index** | `npx @colbymchenry/codegraph init -i` if auto-init failed |
+| **Opt-out** | `CODEGRAPH_SKIP_INIT=1` when running `npx class-ai-agent` |
+| **Troubleshooting** | [CodeGraph README](https://github.com/colbymchenry/codegraph#troubleshooting) · `.cursor/references/codegraph.md` |
 
 ---
 
 ## Overview
 
-This repo ships **two parallel trees** so you can use the same habits in Claude Code and Cursor:
+This repo ships **three parallel trees** so you can use the same habits in Claude Code, Cursor, and Kiro:
 
 | Layout | Tool | What you use |
 |--------|------|----------------|
 | **`.claude/`** | Claude Code | Slash commands, **`CLAUDE.md`**, rules as **`.md`** |
 | **`.cursor/`** | Cursor | Project rules as **`.mdc`**, hub **`CURSOR.md`**, **`@`** file mentions |
+| **`.kiro/`** | Kiro | **Steering** as **`.md`** in `.kiro/steering/`, hub **`KIRO.md`**, **`.kiro/settings/mcp.json`** |
 
 What is inside:
 
 - **Structured workflow** (Spec → Plan → Build → Test → Review → Ship)
 - **10 specialized agents** (markdown personas under `agents/`)
 - **13 mandatory topic rules** (plus **`cursor-overview.mdc`** under `.cursor/rules/`)
-- **9 workflow prompts** under `commands/`
-- **6 skills** (TDD, code review, incremental implementation, deploy, security review, UI/UX Pro Max)
-- **4 reference checklists** (security, testing, performance, accessibility)
+- **11 workflow prompts** under `commands/` (includes `handoff`, `resume`)
+- **9 skills** (TDD, code review, incremental implementation, deploy, security review, agent continuity, UI/UX Pro Max, **supabase**, **supabase-postgres-best-practices**)
+- **7 reference docs** (security, testing, performance, accessibility, codegraph, agent-continuity, **supabase**)
+- **`.agent/SESSION.md`** for cross-tool session handoff
+- **CodeGraph + Supabase MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`)
 
-Keep **`.claude/`** and **`.cursor/`** in sync when you change standards.
+Keep **`.claude/`**, **`.cursor/`**, and **`.kiro/`** in sync when you change standards. After editing `.cursor/`, run **`npm run sync:kiro`** (or `node scripts/sync-kiro-from-cursor.mjs`) to refresh `.kiro/`.
 
 ---
 
@@ -129,22 +179,33 @@ Keep **`.claude/`** and **`.cursor/`** in sync when you change standards.
 | **Review** | `/review` | Five-axis code review |
 | **Ship** | `/deploy` | Build, test, deploy |
 
-**Supporting:** `/debug`, `/simplify`, `/fix-issue` (see `commands/`).
+**Supporting:** `/debug`, `/simplify`, `/fix-issue`, `/handoff`, `/resume` (see `commands/`).
+
+At session boundaries, use **`/handoff`** before switching tools and **`/resume`** when picking work back up.
 
 ---
 
 ## Project Structure
 
+### `.agent/` (cross-tool)
+
+```
+.agent/
+├── README.md
+├── SESSION.md              # Live handoff (committed; seeded on install)
+└── SESSION.template.md     # Schema reference
+```
+
 ### `.claude/` (Claude Code)
 
 ```
 .claude/
 ├── CLAUDE.md                 # Main configuration
-├── commands/                 # 9 workflow prompts (spec, plan, build, …)
+├── commands/                 # 11 workflow prompts (spec, plan, build, handoff, resume, …)
 ├── agents/                   # 10 personas
-├── rules/                    # 13 mandatory topic rules (.md)
+├── rules/                    # 14 mandatory topic rules (.md)
 ├── skills/                   # TDD, review, deploy, …
-├── references/               # Checklists
+├── references/               # Checklists + codegraph.md
 └── settings.json
 ```
 
@@ -155,21 +216,51 @@ Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. D
 | Item | Role |
 |------|------|
 | **`CURSOR.md`** | Hub (like `CLAUDE.md`, Cursor-focused) |
-| **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`** and **`cursor-overview.mdc`** are central |
+| **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`**, **`cursor-overview.mdc`**, **`codegraph.mdc`** are central |
+| **`mcp.json`** | MCP servers (CodeGraph) |
 | **`settings.json`** | Path hints (mirrors Claude layout) |
 | **`AGENTS.md`** (repo root) | Entry pointer for Cursor |
 
 ```
 .cursor/
 ├── CURSOR.md
+├── mcp.json                  # CodeGraph + Supabase MCP
 ├── settings.json
 ├── commands/
 ├── agents/
-├── rules/                    # 14 × .mdc (13 topics + cursor-overview)
+├── rules/                    # 16 × .mdc (13 topics + cursor-overview + codegraph + agent-continuity)
+├── skills/
+└── references/               # includes codegraph.md
+```
+
+After install, **`.codegraph/`** (generated index) lives at the project root and should stay gitignored.
+
+### `.kiro/` (Kiro)
+
+Mirrors `.cursor/` for `commands/`, `agents/`, `skills/`, `references/`. Kiro uses **steering** instead of `.mdc` rules:
+
+| Item | Role |
+|------|------|
+| **`KIRO.md`** | Hub (like `CURSOR.md`) |
+| **`steering/*.md`** | Project standards (`inclusion: always` / `fileMatch` / `manual`) |
+| **`settings/mcp.json`** | MCP servers (CodeGraph) |
+| **`settings.json`** | Path hints |
+
+```
+.kiro/
+├── KIRO.md
+├── settings/
+│   └── mcp.json              # CodeGraph + Supabase MCP
+├── settings.json
+├── steering/                 # kiro-overview.md, security.md, codegraph.md, …
+├── commands/
+├── agents/
 ├── skills/
 └── references/
 ```
 
+Regenerate from `.cursor/` after rule changes: `npm run sync:kiro`.
+
 ### Skill notes
 
 - **`ui-ux-pro-max/`**: A UI/UX-oriented skill bundle (includes datasets under `data/` and helper scripts under `scripts/`) to support design-system decisions and UX guidelines.
@@ -271,13 +362,29 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
 
 ---
 
+## Release notes
+
+### 1.4.0 — 2026-06-02
+
+- Bundle official **Supabase Agent Skills** (`supabase`, `supabase-postgres-best-practices`) for Cursor, Claude Code, and Kiro
+- Add **Supabase MCP** (`https://mcp.supabase.com/mcp?features=docs`) alongside CodeGraph in `.cursor/mcp.json` and `.kiro/settings/mcp.json`
+- Add `.cursor/references/supabase.md`, `THIRD_PARTY_NOTICES.md`, and maintainer command `npm run sync:supabase-skills` (pinned to [supabase/agent-skills](https://github.com/supabase/agent-skills) v0.1.5)
+
+### 1.3.0 — 2026-06-02
+
+- Add **Kiro** support (steering, commands, MCP) with `npm run sync:kiro` to keep `.kiro/` aligned with `.cursor/`
+- Ship **CodeGraph** rules, references, and MCP config for Cursor, Claude Code, and Kiro
+- Add **agent continuity**: `.agent/SESSION.md` template, `/resume` and `/handoff` commands, and cross-tool rules
+- Document `codegraph_context` (`task`) vs `codegraph_search` (`query`) so agents avoid MCP parameter errors
+- Include **UI/UX Pro Max** skill and expanded production skills, commands, and specialized agents
+
 ## Contributing
 
 1. Follow the workflow (`/spec` → `/plan` → `/build`, or the same prompts under `.cursor/commands/`).
 2. Keep tests green.
 3. Run **`/review`** before opening a PR.
 4. Use [conventional commits](https://www.conventionalcommits.org/).
-5. Update **both** `.claude/` and `.cursor/` when rules or workflows change.
+5. Update **`.claude/`**, **`.cursor/`**, and **`.kiro/`** when rules or workflows change (run `npm run sync:kiro` after `.cursor/` edits; run `npm run sync:supabase-skills` to refresh vendored Supabase skills).
 
 ---
 
@@ -318,3 +425,4 @@ That advances **`patch`** (e.g. `1.2.0` → `1.2.1`). Use **`npm version minor`*
 
 - **[Royal Solution](https://codewebkhongkho.com/portfolios)** — project and scaffolding.
 - Upstream inspiration: [fdhhhdjd/Class-AI-Agent](https://github.com/fdhhhdjd/Class-AI-Agent), [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills).
+- **CodeGraph:** [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph) (MIT).

package/bin/class-ai-agent.cjs

@@ -3,6 +3,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { spawnSync } = require('child_process');
 
 const PKG_ROOT = path.resolve(__dirname, '..');
 
@@ -12,7 +13,7 @@ function readPkg() {
 }
 
 function printHelp() {
-  console.log(`class-ai-agent — Install Claude Code & Cursor AI agent scaffolding
+  console.log(`class-ai-agent — Install Claude Code, Cursor & Kiro AI agent scaffolding
 
 Usage:
   npx class-ai-agent [init] [options]
@@ -20,15 +21,31 @@ Usage:
 Options:
   -d, --dir <path>   Target directory (default: current working directory)
       --claude       Install only .claude/
-      --cursor       Install only .cursor/ and AGENTS.md
+      --cursor       Install only .cursor/
+      --kiro         Install only .kiro/
   -f, --force        Overwrite existing files or directories
   -h, --help         Show help
   -v, --version      Print version
 
+AGENTS.md is installed with --cursor, --kiro, or a full install (no --*-only flags).
+
+.agent/:
+  Cross-tool session handoff (.agent/SESSION.md). Seeded from template on install;
+  existing SESSION.md is never overwritten unless you use --force on .agent/.
+
+CodeGraph:
+  After install, runs "npx @colbymchenry/codegraph init -i" in the target directory
+  (Node 20+ recommended). Set CODEGRAPH_SKIP_INIT=1 to skip indexing.
+
+Supabase:
+  Bundled skills under skills/supabase/ and skills/supabase-postgres-best-practices/.
+  MCP: https://mcp.supabase.com/mcp (OAuth on first use). Reload Cursor / restart Kiro after install.
+
 Examples:
   npx class-ai-agent
   npx class-ai-agent --dir ./my-app
-  npx class-ai-agent --cursor --force
+  npx class-ai-agent --kiro --force
+  CODEGRAPH_SKIP_INIT=1 npx class-ai-agent
 `);
 }
 
@@ -38,6 +55,7 @@ function parseArgs(argv) {
     dir: process.cwd(),
     claudeOnly: false,
     cursorOnly: false,
+    kiroOnly: false,
     force: false,
     help: false,
     version: false,
@@ -70,6 +88,10 @@ function parseArgs(argv) {
       opts.cursorOnly = true;
       continue;
     }
+    if (a === '--kiro') {
+      opts.kiroOnly = true;
+      continue;
+    }
     if (a === '-d' || a === '--dir') {
       const v = argv[++i];
       if (!v) {
@@ -120,14 +142,126 @@ function copyFile(src, dest, { force }) {
   fs.copyFileSync(src, dest);
 }
 
-function run(opts) {
-  const full =
-    (!opts.claudeOnly && !opts.cursorOnly) ||
-    (opts.claudeOnly && opts.cursorOnly);
+const CODEGRAPH_GITIGNORE_ENTRY = '.codegraph/';
+
+function ensureCodegraphGitignore(targetDir) {
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  const entry = CODEGRAPH_GITIGNORE_ENTRY;
+
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    if (content.includes(entry) || content.includes('.codegraph')) {
+      return;
+    }
+    const suffix = content.endsWith('\n') ? '' : '\n';
+    fs.appendFileSync(gitignorePath, `${suffix}${entry}\n`);
+    console.log(`Updated: ${gitignorePath} (${entry})`);
+    return;
+  }
+
+  fs.writeFileSync(gitignorePath, `${entry}\n`);
+  console.log(`Created: ${gitignorePath} (${entry})`);
+}
+
+function runCodegraphInit(targetDir) {
+  if (process.env.CODEGRAPH_SKIP_INIT === '1') {
+    console.log('\nCodeGraph: skipped (CODEGRAPH_SKIP_INIT=1).');
+    return;
+  }
+
+  console.log('\nCodeGraph: building local index (npx @colbymchenry/codegraph init -i)...');
+  const result = spawnSync(
+    'npx',
+    ['-y', '@colbymchenry/codegraph@latest', 'init', '-i'],
+    {
+      cwd: targetDir,
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+    }
+  );
+
+  if (result.status === 0) {
+    console.log(`CodeGraph: index ready under ${path.join(targetDir, '.codegraph')}`);
+    console.log(
+      'CodeGraph: reload Cursor (.cursor/mcp.json) and/or restart Kiro (.kiro/settings/mcp.json).'
+    );
+    return;
+  }
+
+  console.warn(
+    '\nCodeGraph: init failed (network, Node version, or permissions). Scaffolding was installed.'
+  );
+  console.warn(
+    '  Retry: npx @colbymchenry/codegraph init -i  (Node 20+ recommended)'
+  );
+}
+
+function shouldInstallTarget(target, opts) {
+  const only = {
+    claude: opts.claudeOnly,
+    cursor: opts.cursorOnly,
+    kiro: opts.kiroOnly,
+  };
+  const anyOnly = only.claude || only.cursor || only.kiro;
+  if (!anyOnly) return true;
+  return only[target];
+}
+
+function shouldInstallAgentDir(opts) {
+  const anyOnly = opts.claudeOnly || opts.cursorOnly || opts.kiroOnly;
+  return !anyOnly;
+}
+
+function installAgentContinuity(targetDir, { force }) {
+  const srcDir = path.join(PKG_ROOT, '.agent');
+  const destDir = path.join(targetDir, '.agent');
+  const templateSrc = path.join(srcDir, 'SESSION.template.md');
+  const sessionDest = path.join(destDir, 'SESSION.md');
 
-  const installClaude = full || (opts.claudeOnly && !opts.cursorOnly);
-  const installCursor = full || (opts.cursorOnly && !opts.claudeOnly);
-  const installAgents = full || opts.cursorOnly;
+  if (!fs.existsSync(srcDir)) {
+    console.error(`Error: template missing from package: ${srcDir}`);
+    process.exit(1);
+  }
+
+  if (fs.existsSync(destDir)) {
+    if (force) {
+      fs.rmSync(destDir, { recursive: true, force: true });
+      fs.cpSync(srcDir, destDir, { recursive: true });
+      console.log(`Installed: ${destDir} (overwritten)`);
+    } else {
+      const readmeSrc = path.join(srcDir, 'README.md');
+      const readmeDest = path.join(destDir, 'README.md');
+      if (fs.existsSync(readmeSrc) && (!fs.existsSync(readmeDest) || force)) {
+        ensureParentDir(readmeDest);
+        fs.copyFileSync(readmeSrc, readmeDest);
+        console.log(`Updated: ${readmeDest}`);
+      }
+      const templateDest = path.join(destDir, 'SESSION.template.md');
+      if (fs.existsSync(templateSrc) && (!fs.existsSync(templateDest) || force)) {
+        ensureParentDir(templateDest);
+        fs.copyFileSync(templateSrc, templateDest);
+        console.log(`Updated: ${templateDest}`);
+      }
+      console.log(`Skipped overwrite: ${destDir} (existing; use --force to replace)`);
+    }
+  } else {
+    fs.mkdirSync(path.dirname(destDir), { recursive: true });
+    fs.cpSync(srcDir, destDir, { recursive: true });
+    console.log(`Installed: ${destDir}`);
+  }
+
+  if (!fs.existsSync(sessionDest) && fs.existsSync(templateSrc)) {
+    ensureParentDir(sessionDest);
+    fs.copyFileSync(templateSrc, sessionDest);
+    console.log(`Created: ${sessionDest} (from template)`);
+  }
+}
+
+function run(opts) {
+  const installClaude = shouldInstallTarget('claude', opts);
+  const installCursor = shouldInstallTarget('cursor', opts);
+  const installKiro = shouldInstallTarget('kiro', opts);
+  const installAgents = installCursor || installKiro;
 
   fs.mkdirSync(opts.dir, { recursive: true });
 
@@ -147,6 +281,13 @@ function run(opts) {
     console.log(`Installed: ${dest}`);
   }
 
+  if (installKiro) {
+    const src = path.join(PKG_ROOT, '.kiro');
+    const dest = path.join(opts.dir, '.kiro');
+    copyDir(src, dest, copyOpts);
+    console.log(`Installed: ${dest}`);
+  }
+
   if (installAgents) {
     const src = path.join(PKG_ROOT, 'AGENTS.md');
     const dest = path.join(opts.dir, 'AGENTS.md');
@@ -154,10 +295,29 @@ function run(opts) {
     console.log(`Installed: ${dest}`);
   }
 
+  if (shouldInstallAgentDir(opts)) {
+    installAgentContinuity(opts.dir, copyOpts);
+  }
+
+  ensureCodegraphGitignore(opts.dir);
+  runCodegraphInit(opts.dir);
+
   const hints = [];
   if (installClaude) hints.push('.claude/CLAUDE.md');
   if (installCursor) hints.push('.cursor/CURSOR.md');
-  console.log(`\nDone. Next steps: read ${hints.join(' and ')}.`);
+  if (installKiro) hints.push('.kiro/KIRO.md');
+  console.log(`\nDone. Next steps: read ${hints.join(', ')}.`);
+  if (installCursor) {
+    console.log('  Cursor: reload the window so MCP loads (.cursor/mcp.json — CodeGraph + Supabase).');
+    console.log('  Supabase: complete OAuth in the browser when you first use Supabase MCP tools.');
+  }
+  if (installKiro) {
+    console.log('  Kiro: restart IDE/CLI so MCP loads (.kiro/settings/mcp.json — CodeGraph + Supabase).');
+    console.log('  Supabase: complete OAuth when you first use Supabase MCP tools.');
+  }
+  if (shouldInstallAgentDir(opts)) {
+    console.log('  Continuity: edit .agent/SESSION.md at session end (/handoff); read at start (/resume).');
+  }
 }
 
 const argv = process.argv.slice(2);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "class-ai-agent",
-  "version": "1.2.3",
-  "description": "Production-grade AI agent configuration for Claude Code & Cursor",
+  "version": "1.4.0",
+  "description": "Production-grade AI agent configuration for Claude Code, Cursor & Kiro",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -15,6 +15,9 @@
     "claude",
     "claude-code",
     "cursor",
+    "kiro",
+    "codegraph",
+    "supabase",
     "ai",
     "agent",
     "scaffold"
@@ -27,13 +30,18 @@
   },
   "files": [
     "bin",
+    ".agent",
     ".claude",
     ".cursor",
+    ".kiro",
     "AGENTS.md",
     "royal-solution-logo-v2.svg"
   ],
   "scripts": {
-    "prepack": "node -e \"const fs=require('fs');['.claude','.cursor','AGENTS.md'].forEach(p=>{if(!fs.existsSync(p))process.exit(1)})\"",
-    "test:cli": "node bin/class-ai-agent.cjs --help && node bin/class-ai-agent.cjs --version"
+    "prepack": "node -e \"const fs=require('fs');['.agent','.claude','.cursor','.kiro','AGENTS.md'].forEach(p=>{if(!fs.existsSync(p))process.exit(1)})\"",
+    "sync:kiro": "node scripts/sync-kiro-from-cursor.mjs",
+    "sync:supabase-skills": "node scripts/sync-supabase-skills.mjs",
+    "release:readme": "node scripts/update-readme-release.mjs",
+    "test:cli": "node bin/class-ai-agent.cjs --help && node bin/class-ai-agent.cjs --version && node -e \"const fs=require('fs');const c=JSON.parse(fs.readFileSync('.cursor/mcp.json','utf8'));const k=JSON.parse(fs.readFileSync('.kiro/settings/mcp.json','utf8'));if(!c.mcpServers?.codegraph||!k.mcpServers?.codegraph)throw new Error('missing codegraph MCP');if(!c.mcpServers?.supabase?.url?.includes('mcp.supabase.com')||!k.mcpServers?.supabase?.url?.includes('mcp.supabase.com'))throw new Error('missing supabase MCP');if(!fs.existsSync('.cursor/skills/supabase/SKILL.md')||!fs.existsSync('.cursor/skills/supabase-postgres-best-practices/SKILL.md'))throw new Error('missing supabase skills');if(!fs.existsSync('.claude/skills/supabase/SKILL.md'))throw new Error('missing claude supabase skill');if(!fs.existsSync('.cursor/references/supabase.md'))throw new Error('missing supabase reference');if(!fs.existsSync('scripts/sync-supabase-skills.mjs'))throw new Error('missing sync-supabase-skills');if(!fs.existsSync('.cursor/rules/codegraph.mdc'))throw new Error('missing codegraph.mdc');if(!fs.existsSync('.kiro/steering/codegraph.md'))throw new Error('missing kiro codegraph steering');if(!fs.existsSync('.agent/SESSION.template.md'))throw new Error('missing SESSION.template');if(!fs.existsSync('.cursor/rules/agent-continuity.mdc'))throw new Error('missing agent-continuity.mdc');if(!fs.existsSync('.kiro/steering/agent-continuity.md'))throw new Error('missing kiro agent-continuity steering');if(!fs.existsSync('.cursor/commands/handoff.md')||!fs.existsSync('.cursor/commands/resume.md'))throw new Error('missing handoff/resume commands');\""
   }
 }