class-ai-agent 1.3.0 → 1.4.1

package/README.md

@@ -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.3.0-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-1.4.1-blue?style=flat-square" alt="Version" />
 </p>
 
 </div>
@@ -53,7 +53,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
 |--------|---------|
 | **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 |
+| **11 agent personas** | Frontend, backend, architect, review, QA, security, BA, 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) |
@@ -150,14 +150,14 @@ 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/`)
+- **13 mandatory topic rules** (plus **`cursor-overview.mdc`**, **`codegraph.mdc`**, and **`agent-continuity.mdc`** under `.cursor/rules/`)
 - **11 workflow prompts** under `commands/` (includes `handoff`, `resume`)
-- **7 skills** (TDD, code review, incremental implementation, deploy, security review, agent continuity, UI/UX Pro Max)
-- **6 reference docs** (security, testing, performance, accessibility, codegraph, agent-continuity)
+- **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 MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`)
+- **CodeGraph + Supabase MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`)
 
-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/`.
+Keep **`.claude/`**, **`.cursor/`**, and **`.kiro/`** in sync when you change standards. After editing `.cursor/` (canonical), run **`npm run sync:all`** to refresh `.claude/` and `.kiro/`.
 
 ---
 
@@ -203,7 +203,7 @@ At session boundaries, use **`/handoff`** before switching tools and **`/resume`
 ├── CLAUDE.md                 # Main configuration
 ├── commands/                 # 11 workflow prompts (spec, plan, build, handoff, resume, …)
 ├── agents/                   # 10 personas
-├── rules/                    # 14 mandatory topic rules (.md)
+├── rules/                    # 15 mandatory topic rules (.md, synced from .cursor/)
 ├── skills/                   # TDD, review, deploy, …
 ├── references/               # Checklists + codegraph.md
 └── settings.json
@@ -224,7 +224,7 @@ Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. D
 ```
 .cursor/
 ├── CURSOR.md
-├── mcp.json                  # CodeGraph MCP (npx @colbymchenry/codegraph)
+├── mcp.json                  # CodeGraph + Supabase MCP
 ├── settings.json
 ├── commands/
 ├── agents/
@@ -250,7 +250,7 @@ Mirrors `.cursor/` for `commands/`, `agents/`, `skills/`, `references/`. Kiro us
 .kiro/
 ├── KIRO.md
 ├── settings/
-│   └── mcp.json              # CodeGraph MCP
+│   └── mcp.json              # CodeGraph + Supabase MCP
 ├── settings.json
 ├── steering/                 # kiro-overview.md, security.md, codegraph.md, …
 ├── commands/
@@ -259,7 +259,7 @@ Mirrors `.cursor/` for `commands/`, `agents/`, `skills/`, `references/`. Kiro us
 └── references/
 ```
 
-Regenerate from `.cursor/` after rule changes: `npm run sync:kiro`.
+Regenerate from `.cursor/` after rule changes: `npm run sync:all`.
 
 ### Skill notes
 
@@ -330,7 +330,9 @@ Use **`.claude/rules/*.md`** or **`.cursor/rules/*.mdc`** (paired content; Curso
 
 **Cursor** — prompts live under **`.cursor/commands/`**. Open the file, copy the section you need, or **`@`** it (e.g. `@.cursor/commands/spec.md`).
 
-**Agents** — describe the role in natural language, or in Cursor **`@`** an agent file, e.g. `@.cursor/agents/code-reviewer.md`.
+**Kiro** — prompts live under **`.kiro/commands/`**. Open the file, paste or attach in chat, or reference it when running a slash workflow. Restart Kiro after install so MCP (CodeGraph, Supabase) connects.
+
+**Agents** — describe the role in natural language, or **`@`** (Cursor) / reference (Claude, Kiro) an agent file, e.g. `@.cursor/agents/code-reviewer.md` or `.kiro/agents/code-reviewer.md`.
 
 ---
 
@@ -366,6 +368,17 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
 
 
 
+### 1.4.1 — 2026-06-17
+
+- Add **Business Analyst** agent persona (BABOK v3) for Cursor, Claude Code, and Kiro
+- Document Business Analyst in hub agent tables (`.cursor/CURSOR.md`, `.claude/CLAUDE.md`, `.kiro/KIRO.md`)
+
+### 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/`
@@ -380,7 +393,7 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
 2. Keep tests green.
 3. Run **`/review`** before opening a PR.
 4. Use [conventional commits](https://www.conventionalcommits.org/).
-5. Update **`.claude/`**, **`.cursor/`**, and **`.kiro/`** when rules or workflows change (run `npm run sync:kiro` after `.cursor/` edits).
+5. Update **`.cursor/`** when rules or workflows change, then run **`npm run sync:all`** to refresh `.claude/` and `.kiro/`; run **`npm run sync:supabase-skills`** to refresh vendored Supabase skills.
 
 ---
 

package/bin/class-ai-agent.cjs

@@ -37,6 +37,10 @@ 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
@@ -304,10 +308,12 @@ function run(opts) {
   if (installKiro) hints.push('.kiro/KIRO.md');
   console.log(`\nDone. Next steps: read ${hints.join(', ')}.`);
   if (installCursor) {
-    console.log('  Cursor: reload the window so CodeGraph MCP loads (.cursor/mcp.json).');
+    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 CodeGraph MCP loads (.kiro/settings/mcp.json).');
+    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).');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "class-ai-agent",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Production-grade AI agent configuration for Claude Code, Cursor & Kiro",
   "license": "MIT",
   "repository": {
@@ -17,6 +17,7 @@
     "cursor",
     "kiro",
     "codegraph",
+    "supabase",
     "ai",
     "agent",
     "scaffold"
@@ -39,7 +40,10 @@
   "scripts": {
     "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:claude": "node scripts/sync-claude-from-cursor.mjs",
+    "sync:all": "node scripts/sync-all.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(!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');\""
+    "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('.claude/rules/codegraph.md'))throw new Error('missing claude codegraph rule');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');\" && node scripts/check-parity.mjs"
   }
 }