@softspark/ai-toolkit 1.3.15 → 1.4.1

package/CHANGELOG.md

@@ -7,6 +7,42 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.4.1 — Documentation Fix: --local Behavior (2026-04-09)
+
+### Fixed
+- README Per-Project Setup, Quick Start, and CLI table now correctly state that `--local` installs Claude Code only by default, with `--editors` flag for other tools.
+
+---
+
+## v1.4.0 — Full Platform Parity: 11 Editors, Directory-Based Rules, --editors Flag (2026-04-09)
+
+### Added
+- **Google Antigravity support** — new editor integration with `.agent/rules/` (6 rule files) and `.agent/workflows/` (13 workflow templates with YAML frontmatter). Full agent/skill catalog parity with other platforms.
+- **Directory-based rules for all editors** — every platform now gets modern directory-based configs in addition to legacy single-file formats:
+  - Cursor: `.cursor/rules/*.mdc` with YAML frontmatter (`alwaysApply`, `globs`, `description`)
+  - Windsurf: `.windsurf/rules/*.md`
+  - Cline: `.cline/rules/*.md`
+  - Roo Code: `.roo/rules/*.md` (shared rules for all modes)
+  - Augment: `.augment/rules/ai-toolkit-*.md` with `auto_attached` globs per file type
+  - Aider: `CONVENTIONS.md` (auto-loaded as read-only context)
+- **`--editors` flag** for `install --local` — selective editor installation:
+  - `--editors all` — install all 8 editors
+  - `--editors cursor,aider` — install only selected
+  - (no flag) — auto-detect from existing project files
+  - `update --local` auto-detects editors from existing configs
+- **`--lang` flag** — explicit language selection for rules (`--lang typescript`, `--lang go,python`) with aliases (`go`→`golang`, `c++`→`cpp`, `cs`→`csharp`)
+- **Two-phase language detection** — marker files (package.json, go.mod, etc.) + source file extension scanning (.py, .ts, .go, etc.)
+- **Shared rule content module** (`dir_rules_shared.py`) — all platforms get identical agent/skill catalog, guidelines, and rules from a single source of truth
+- **7 new CLI commands**: `cursor-mdc`, `windsurf-dir-rules`, `cline-dir-rules`, `roo-dir-rules`, `augment-dir-rules`, `conventions-md`, `antigravity-rules`
+- **71 generator tests** — file existence, content verification, user file preservation, idempotency, stale cleanup, cross-platform parity check
+
+### Changed
+- `install --local` now installs only Claude Code configs by default (no editor bloat); editors require `--editors` flag or auto-detect from existing files
+- All directory-based generators use `ai-toolkit-` prefix to prevent overwriting user files
+- Total test count: 377 → 408
+
+---
+
 ## v1.3.15 — Quality Guardrails: Anti-Rationalization, Confidence Scoring, Verification Checklists (2026-04-08)
 
 ### Added

package/README.md

@@ -1,12 +1,12 @@
 # ai-toolkit
 
-> Professional-grade AI coding toolkit with multi-platform support. Machine-enforced safety, 91 skills, 44 agents, expanded lifecycle hooks, persona presets, experimental opt-in plugin packs, and benchmark tooling — works with Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, and Augment, ready in 60 seconds.
+> Professional-grade AI coding toolkit with multi-platform support. Machine-enforced safety, 91 skills, 44 agents, expanded lifecycle hooks, persona presets, experimental opt-in plugin packs, and benchmark tooling — works with Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, and Google Antigravity, ready in 60 seconds.
 
 [![CI](https://github.com/softspark/ai-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/softspark/ai-toolkit/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Skills](https://img.shields.io/badge/skills-91-brightgreen)](app/skills/)
 [![Agents](https://img.shields.io/badge/agents-44-blue)](app/agents/)
-[![Tests](https://img.shields.io/badge/tests-377%20passing-success)](tests/)
+[![Tests](https://img.shields.io/badge/tests-408%20passing-success)](tests/)
 
 ---
 
@@ -31,12 +31,14 @@ npm install -g @softspark/ai-toolkit@latest && ai-toolkit update
 
 ### Per-Project Setup
 
-After global install, run `--local` in each project to generate project-specific configs (CLAUDE.md, Copilot, Cline, Roo Code, Aider, git hooks):
+After global install, run `--local` in each project. By default, only Claude Code configs are installed (CLAUDE.md, settings, constitution, language rules). Add `--editors` for other tools:
 
 ```bash
 cd your-project/
-ai-toolkit install --local         # first time
-ai-toolkit update --local          # after toolkit updates
+ai-toolkit install --local                     # Claude Code only
+ai-toolkit install --local --editors all       # + all editors (Cursor, Windsurf, Cline, Roo, Aider, Augment, Copilot, Antigravity)
+ai-toolkit install --local --editors cursor,aider  # + specific editors
+ai-toolkit update --local                      # auto-detects editors from existing project files
 ```
 
 ### Plugin Management
@@ -112,20 +114,21 @@ Replaces all symlinks with real files, inlines rules into CLAUDE.md, copies cons
 
 ## Platform Support
 
-| Platform | Config File | How | Scope |
-|----------|------------|-----|-------|
+| Platform | Config Files | How | Scope |
+|----------|-------------|-----|-------|
 | Claude Code | `~/.claude/` | `ai-toolkit install` | global |
-| Cursor | `~/.cursor/rules` | `ai-toolkit install` | global |
-| Windsurf | `~/.codeium/windsurf/memories/global_rules.md` | `ai-toolkit install` | global |
+| Cursor | `~/.cursor/rules` + `.cursor/rules/*.mdc` | `ai-toolkit install` / `--local` | global + project |
+| Windsurf | `~/.codeium/.../global_rules.md` + `.windsurf/rules/*.md` | `ai-toolkit install` / `--local` | global + project |
 | Gemini CLI | `~/.gemini/GEMINI.md` | `ai-toolkit install` | global |
 | GitHub Copilot | `.github/copilot-instructions.md` | `ai-toolkit install --local` | project |
-| Cline | `.clinerules` | `ai-toolkit install --local` | project |
-| Roo Code | `.roomodes` | `ai-toolkit install --local` | project |
-| Aider | `.aider.conf.yml` | `ai-toolkit install --local` | project |
-| Augment | `.augment/rules/ai-toolkit.md` | `ai-toolkit install --local` | project |
+| Cline | `.clinerules` + `.cline/rules/*.md` | `ai-toolkit install --local` | project |
+| Roo Code | `.roomodes` + `.roo/rules/*.md` | `ai-toolkit install --local` | project |
+| Aider | `.aider.conf.yml` + `CONVENTIONS.md` | `ai-toolkit install --local` | project |
+| Augment | `.augment/rules/ai-toolkit-*.md` | `ai-toolkit install --local` | project |
+| Google Antigravity | `.agent/rules/*.md` + `.agent/workflows/*.md` | `ai-toolkit install --local` | project |
 | Codex / OpenCode | `AGENTS.md` | `ai-toolkit agents-md` | project |
 
-> **Note:** Claude Code remains the primary platform with full feature support (agents, lifecycle hooks, safety constitution). Other platforms receive a distilled ruleset generated from the same source. For editors lacking native bash lifecycle hooks, `--local` installs a Git hooks fallback (`.git/hooks/pre-commit`) to enforce quality gates pre-commit.
+> **Note:** Claude Code is always installed (primary platform with full feature support). Other editors are installed on demand with `--editors <list>` or auto-detected from existing project files. All platforms receive the same agent/skill catalog, guidelines, and rules. For editors lacking native bash lifecycle hooks, `--local` installs a Git hooks fallback (`.git/hooks/pre-commit`) to enforce quality gates pre-commit.
 
 ---
 
@@ -523,7 +526,7 @@ ai-toolkit install --local --lang typescript  # explicit language selection
 ai-toolkit install --local --lang go,python   # multiple languages
 ```
 
-`--local` automatically detects languages (via package.json, go.mod, Cargo.toml, etc.) — no need for `--auto-detect`. Rules are injected into `CLAUDE.md` and auto-updated on `ai-toolkit update --local`.
+`--local` automatically detects languages using two-phase detection: config markers (package.json, go.mod, Cargo.toml, etc.) plus source file extension scanning (.py, .ts, .go, etc.). `--lang` accepts aliases (`go`, `c++`, `cs`). Rules are injected into `CLAUDE.md` and auto-updated on `ai-toolkit update --local`.
 
 ---
 
@@ -641,10 +644,13 @@ ai-toolkit install
 # After npm update — re-apply updated components
 ai-toolkit update
 
-# Init project (CLAUDE.md + settings + constitution + Copilot + Cline + Roo + Aider + Git Hooks + MCP Default)
+# Init project (Claude Code configs only: CLAUDE.md, settings, constitution, language rules)
 ai-toolkit install --local
 
-# Update project-local configs after toolkit update
+# Init with all editors (Cursor, Windsurf, Cline, Roo, Aider, Augment, Copilot, Antigravity)
+ai-toolkit install --local --editors all
+
+# Update project — auto-detects editors from existing config files
 ai-toolkit update --local
 ```
 
@@ -719,9 +725,9 @@ Usage: ai-toolkit <command> [options]
 | Command | Description |
 |---------|-------------|
 | `install` | First-time global install into `~/.claude/` + Cursor, Windsurf, Gemini |
-| `install --local` | Also set up project-local configs (CLAUDE.md, settings, constitution, Copilot, Cline, Roo, Aider, Git Hooks, MCP Defaults) |
+| `install --local` | Claude Code configs only; add `--editors all` or `--editors cursor,aider` for other tools |
 | `update` | Re-apply toolkit after `npm install -g @softspark/ai-toolkit@latest` |
-| `update --local` | Re-apply + refresh project-local configs in current dir |
+| `update --local` | Re-apply + auto-detect editors from existing project files |
 | `reset --local` | Wipe all project-local configs and recreate from scratch (clean slate) |
 | `add-rule <rule.md> [name]` | Register rule in `~/.ai-toolkit/rules/` — auto-applied on every `update` |
 | `remove-rule <name> [dir]` | Unregister rule from `~/.ai-toolkit/rules/` and remove its block from `CLAUDE.md` |
@@ -759,7 +765,14 @@ Usage: ai-toolkit <command> [options]
 | `cline-rules` | Generate `.clinerules` in current dir |
 | `roo-modes` | Generate `.roomodes` in current dir |
 | `aider-conf` | Generate `.aider.conf.yml` in current dir |
-| `augment-rules` | Generate `.augment/rules/ai-toolkit.md` in current dir |
+| `conventions-md` | Generate `CONVENTIONS.md` for Aider (auto-loaded) |
+| `augment-rules` | Generate `.augment/rules/ai-toolkit.md` (legacy single file) |
+| `augment-dir-rules` | Generate `.augment/rules/ai-toolkit-*.md` (recommended) |
+| `cursor-mdc` | Generate `.cursor/rules/*.mdc` for Cursor (recommended) |
+| `windsurf-dir-rules` | Generate `.windsurf/rules/*.md` for Windsurf |
+| `cline-dir-rules` | Generate `.cline/rules/*.md` for Cline |
+| `roo-dir-rules` | Generate `.roo/rules/*.md` for Roo Code |
+| `antigravity-rules` | Generate `.agent/rules/` and `.agent/workflows/` for Google Antigravity |
 | `agents-md` | Regenerate `AGENTS.md` from agent definitions |
 | `llms-txt` | Generate `llms.txt` and `llms-full.txt` |
 | `generate-all` | Generate all platform configs at once |
@@ -772,11 +785,12 @@ ai-toolkit install --only agents,hooks   # apply only listed components
 ai-toolkit install --skip hooks          # skip listed components
 ai-toolkit install --profile minimal     # profile preset: minimal | standard | strict
 ai-toolkit install --persona backend-lead # persona preset: backend-lead | frontend-lead | devops-eng | junior-dev
-ai-toolkit install --local               # also set up project-local configs (CLAUDE.md, settings, constitution, Copilot, Cline, Roo, Aider, Git Hooks, MCP Defaults)
-ai-toolkit update --local                # re-apply + refresh project-local configs
+ai-toolkit install --local               # Claude Code only (CLAUDE.md, settings, constitution, language rules)
+ai-toolkit install --local --editors all # Claude Code + all editors (Cursor, Windsurf, Cline, Roo, Aider, Augment, Copilot, Antigravity)
+ai-toolkit install --local --editors cursor,aider  # Claude Code + specific editors
+ai-toolkit update --local                # re-apply; auto-detects editors from existing project files
 ai-toolkit install --list                # dry-run: show what would be applied
 ai-toolkit install --modules core,agents,rules-typescript  # selective module install
-ai-toolkit install --local               # auto-detects language, installs matching rules
 ai-toolkit install --lang typescript     # explicit language for rules install
 ```
 

package/bin/ai-toolkit.js

@@ -76,17 +76,24 @@ const COMMANDS = {
   mcp: 'Manage MCP server templates (list, show, add, remove)',
   plugin: 'Manage plugin packs (install, remove, update, clean, list, status)',
   sync: 'Sync config to/from GitHub Gist (--export, --push, --pull, --import)',
-  'cursor-rules': 'Generate .cursorrules for Cursor IDE',
-  'windsurf-rules': 'Generate .windsurfrules for Windsurf',
+  'cursor-rules': 'Generate .cursorrules for Cursor IDE (legacy)',
+  'cursor-mdc': 'Generate .cursor/rules/*.mdc for Cursor IDE (recommended)',
+  'windsurf-rules': 'Generate .windsurfrules for Windsurf (legacy)',
+  'windsurf-dir-rules': 'Generate .windsurf/rules/*.md for Windsurf (recommended)',
   'copilot-instructions': 'Generate .github/copilot-instructions.md',
   'gemini-md': 'Generate GEMINI.md for Gemini CLI',
-  'cline-rules': 'Generate .clinerules for Cline',
+  'cline-rules': 'Generate .clinerules for Cline (legacy)',
+  'cline-dir-rules': 'Generate .cline/rules/*.md for Cline (recommended)',
   'roo-modes': 'Generate .roomodes for Roo Code',
+  'roo-dir-rules': 'Generate .roo/rules/*.md shared rules for Roo Code',
   'aider-conf': 'Generate .aider.conf.yml for Aider',
-  'augment-rules': 'Generate .augment/rules/ai-toolkit.md for Augment',
+  'conventions-md': 'Generate CONVENTIONS.md for Aider (auto-loaded)',
+  'augment-rules': 'Generate .augment/rules/ai-toolkit.md for Augment (legacy)',
+  'augment-dir-rules': 'Generate .augment/rules/ai-toolkit-*.md for Augment (recommended)',
+  'antigravity-rules': 'Generate .agent/rules/ and .agent/workflows/ for Google Antigravity',
   'agents-md': 'Regenerate AGENTS.md from agent definitions',
   'llms-txt': 'Generate llms.txt and llms-full.txt',
-  'generate-all': 'Generate all platform configs at once (agents, cursor, windsurf, copilot, gemini, cline, roo, aider, augment, llms)',
+  'generate-all': 'Generate all platform configs at once (agents, cursor, windsurf, copilot, gemini, cline, roo, aider, augment, antigravity, llms)',
   help: 'Show this help message',
 };
 
@@ -191,6 +198,9 @@ function showHelp() {
   console.log('  --local         Also set up project-local configs (CLAUDE.md, settings, constitution, copilot, cline, roo, aider, git hooks)');
   console.log('  --profile <p>   Install profile: minimal (agents+skills), standard (default), strict (all+git hooks)');
   console.log('  --modules <list>  Install specific modules (e.g. core,agents,rules-typescript)');
+  console.log('  --lang <list>   Explicitly select language rules (e.g. typescript, go,python)');
+  console.log('  --editors <list> Install editor configs: cursor,windsurf,cline,roo,aider,augment,copilot,antigravity (or "all")');
+  console.log('                  Default with --local: auto-detect from existing project files');
   console.log('  --auto-detect   Detect project languages and install matching rule modules');
   console.log('  --list, --dry-run  Dry-run: show what would be applied');
   console.log('\nOptions for create:');
@@ -372,6 +382,17 @@ function handleGenerateAll(_args) {
   for (const gen of Object.values(GENERATORS)) {
     writeGeneratorOutput(gen);
   }
+  // Directory-based generators (multi-file output)
+  run(scriptPath('generate_antigravity.py'), [CWD]);
+  run(scriptPath('generate_cursor_mdc.py'), [CWD]);
+  run(scriptPath('generate_windsurf_rules.py'), [CWD]);
+  run(scriptPath('generate_cline_rules.py'), [CWD]);
+  run(scriptPath('generate_roo_rules.py'), [CWD]);
+  run(scriptPath('generate_augment_rules.py'), [CWD]);
+  // Single-file generators
+  const conventionsOut = runGenerator('generate_conventions.py');
+  fs.writeFileSync(path.join(CWD, 'CONVENTIONS.md'), conventionsOut);
+  console.log('Generated: CONVENTIONS.md');
   generateLlmsTxt();
 }
 
@@ -429,6 +450,13 @@ const SPECIAL_HANDLERS = {
   'inject-hook':  handleInjectHook,
   'remove-hook':  handleRemoveHook,
   'llms-txt':     (_args) => generateLlmsTxt(),
+  'antigravity-rules': (_args) => run(scriptPath('generate_antigravity.py'), [CWD]),
+  'cursor-mdc':   (_args) => run(scriptPath('generate_cursor_mdc.py'), [CWD]),
+  'windsurf-dir-rules': (_args) => run(scriptPath('generate_windsurf_rules.py'), [CWD]),
+  'cline-dir-rules': (_args) => run(scriptPath('generate_cline_rules.py'), [CWD]),
+  'roo-dir-rules': (_args) => run(scriptPath('generate_roo_rules.py'), [CWD]),
+  'conventions-md': (_args) => { const out = runGenerator('generate_conventions.py'); fs.writeFileSync(path.join(CWD, 'CONVENTIONS.md'), out); console.log('Generated: CONVENTIONS.md'); },
+  'augment-dir-rules': (_args) => run(scriptPath('generate_augment_rules.py'), [CWD]),
   'generate-all': handleGenerateAll,
 };
 

package/kb/procedures/release-verification-sop.md

@@ -0,0 +1,283 @@
+---
+title: "SOP: Release Verification"
+category: procedures
+service: ai-toolkit
+tags: [sop, verification, release, smoke-test, install, update, qa]
+version: "1.1.0"
+created: "2026-04-08"
+last_updated: "2026-04-08"
+description: "End-to-end smoke test after installing or updating @softspark/ai-toolkit — verifies CLI, install, doctor, validation, tests, and eject from user perspective."
+---
+
+# SOP: Release Verification
+
+End-to-end smoke test after installing or updating `@softspark/ai-toolkit`.
+Verifies all critical paths from the user's perspective.
+
+**Use this SOP when:**
+- After `npm install -g @softspark/ai-toolkit@latest`
+- After `ai-toolkit update`
+- Before tagging a new version (`git tag`)
+- Before publishing to npm (`npm publish`)
+- As a smoke test in CI/CD
+
+**Prerequisites:**
+- Node.js >= 18, Python 3, `bats`, git
+- `@softspark/ai-toolkit` installed globally
+
+**Time:** 10-15 minutes (full), 2 minutes (quick checklist)
+
+---
+
+## Quick Checklist (TL;DR)
+
+9 commands — if all pass, the release is ready:
+
+```bash
+# Pre-commit (Phase 0)
+python3 scripts/generate_agents_md.py > AGENTS.md   # 1. Regenerate artifacts
+python3 scripts/generate_llms_txt.py > llms.txt      # 2. Regenerate llms.txt
+python3 scripts/validate.py --strict                 # 3. Validation passed?
+npm test                                             # 4. All tests passed?
+
+# Post-install verification (Phases 1-7)
+ai-toolkit --version                                 # 5. Version OK?
+ai-toolkit status                                    # 6. Status OK?
+ai-toolkit doctor                                    # 7. Health check passed?
+ai-toolkit install --dry-run                         # 8. Global install OK?
+python3 scripts/audit_skills.py --ci                 # 9. Security audit clean?
+```
+
+---
+
+## Phase 0: Pre-Commit & Pre-Push (2 min)
+
+Run these commands **before every commit and push to main**. CI validates
+counts but does NOT auto-regenerate — you must do it locally.
+
+```bash
+# 1. Regenerate generated artifacts
+python3 scripts/generate_agents_md.py > AGENTS.md
+python3 scripts/generate_llms_txt.py > llms.txt
+python3 scripts/generate_llms_txt.py --full > llms-full.txt
+
+# 2. Validate everything (catches stale counts, missing assets)
+python3 scripts/validate.py --strict
+
+# 3. Security audit
+python3 scripts/audit_skills.py --ci
+
+# 4. Run tests
+npm test
+
+# 5. Stage and commit
+git add AGENTS.md llms.txt llms-full.txt
+git add -p  # stage your other changes
+git commit -m "feat: your change description"
+```
+
+**Why local?** Branch protection on `main` requires PRs and status checks.
+CI cannot push directly to `main`, so generated artifacts must be committed
+by the developer as part of their PR.
+
+**One-liner (copy-paste):**
+```bash
+python3 scripts/generate_agents_md.py > AGENTS.md && python3 scripts/generate_llms_txt.py > llms.txt && python3 scripts/generate_llms_txt.py --full > llms-full.txt && python3 scripts/validate.py --strict && python3 scripts/audit_skills.py --ci && npm test
+```
+
+---
+
+## Phase 1: CLI & Version (1 min)
+
+```bash
+ai-toolkit --version
+ai-toolkit --help
+which ai-toolkit
+```
+
+**Verify:**
+- [ ] `--version` returns correct semver (e.g., `1.4.0`)
+- [ ] `--help` displays full command list without errors
+- [ ] `which` points to global npm bin path
+
+---
+
+## Phase 2: Global Install & Status (2 min)
+
+```bash
+ai-toolkit install --dry-run
+ai-toolkit status
+```
+
+**Verify `--dry-run`:**
+- [ ] Agents >= 40
+- [ ] Skills >= 80
+- [ ] Hooks merged into settings.json
+- [ ] "Other AI Tools" section lists cursor, windsurf, gemini, augment (antigravity via --local)
+
+**Verify `status`:**
+- [ ] Version matches expected
+- [ ] Profile: minimal/standard/strict
+- [ ] Modules: list of installed modules
+- [ ] Latest: up to date / update available
+
+---
+
+## Phase 3: Doctor Health Check (1 min)
+
+```bash
+ai-toolkit doctor
+```
+
+**Expected sections (all OK):**
+- Environment: node, bash, python3, bats
+- Global Install: .claude exists, agents/skills symlinks (0 broken), settings.json hooks
+- Hook Scripts: all present and executable
+- Hook Configuration: 12 events registered
+- Generated Artifacts: AGENTS.md, llms.txt, llms-full.txt
+- Planned Assets: plugin.json, benchmarks, plugin packs
+- Benchmark Freshness: < 30 days
+- Stale Rules: all healthy
+
+**Verify:**
+- [ ] `Errors: 0 | Warnings: 0`
+- [ ] `HEALTH CHECK PASSED`
+
+If doctor detects problems: `ai-toolkit doctor --fix` auto-repairs
+(broken symlinks, non-executable hooks, missing scripts, missing llms-full.txt).
+
+---
+
+## Phase 4: Local Install (2 min)
+
+```bash
+mkdir -p /tmp/ai-toolkit-verify && cd /tmp/ai-toolkit-verify
+git init -q
+ai-toolkit install --local --editors all --dry-run
+cd - && rm -rf /tmp/ai-toolkit-verify
+```
+
+**Verify "Project-local" section:**
+- [ ] Would create: CLAUDE.md
+- [ ] Would create: .claude/settings.local.json
+- [ ] Would inject: .claude/constitution.md
+- [ ] Editors: all 8 listed (copilot, cursor, windsurf, cline, roo, aider, augment, antigravity)
+- [ ] Would generate configs for each editor (legacy + directory-based)
+- [ ] Would install: .git/hooks/pre-commit
+- [ ] Would inject language rules (auto-detected)
+
+**Also test auto-detect (no --editors flag):**
+```bash
+ai-toolkit install --local --dry-run
+# → Editors: none (empty project has no existing configs)
+```
+
+---
+
+## Phase 5: Validation & Security Audit (3 min)
+
+```bash
+python3 scripts/validate.py --strict
+python3 scripts/audit_skills.py --ci
+```
+
+**Verify validate.py:**
+- [ ] Agents >= 40, Skills >= 80, Tests >= 350
+- [ ] Hook events: 12, Hook scripts: >= 20
+- [ ] Plugin packs >= 10, KB documents >= 20
+- [ ] `Errors: 0 | Warnings: 0` → `VALIDATION PASSED`
+
+**Verify audit_skills.py:**
+- [ ] `HIGH: 0` (MUST be zero — CI fails otherwise)
+- [ ] `WARN: 0`
+- [ ] `INFO: N` (acceptable — broad-access skills: orchestrate, swarm, teams)
+
+---
+
+## Phase 6: Tests (3-5 min)
+
+```bash
+npm test
+```
+
+**Verify:**
+- [ ] Bats runs tests in parallel (4 jobs)
+- [ ] All `ok` — zero `not ok`
+- [ ] Groups: agents, autodetect, cli, generators, guards, hooks, inject,
+      install, kb, mcp, readme, profiles, uninstall, validate
+
+**Key test areas:**
+- Guards: rm -rf, DROP TABLE, git push --force blocked
+- Install: idempotent, profiles, --only/--skip, orphan cleanup
+- Eject: real files (not symlinks), inlined rules
+- Uninstall: removes toolkit, preserves user content
+
+---
+
+## Phase 7: Eject (1 min)
+
+```bash
+mkdir -p /tmp/ai-toolkit-eject-test
+cd /tmp/ai-toolkit-eject-test
+ai-toolkit eject
+cd - && rm -rf /tmp/ai-toolkit-eject-test
+```
+
+**Verify:**
+- [ ] Agents copied as real files (not symlinks)
+- [ ] Skills copied as real directories
+- [ ] Rules inlined into CLAUDE.md
+- [ ] constitution.md and ARCHITECTURE.md copied
+
+---
+
+## Troubleshooting
+
+### `ai-toolkit: command not found`
+
+```bash
+npm install -g @softspark/ai-toolkit
+# or check PATH:
+export PATH="$(npm config get prefix)/bin:$PATH"
+```
+
+### Doctor: broken symlinks
+
+```bash
+ai-toolkit doctor --fix    # auto-repair
+ai-toolkit update          # or full re-install
+```
+
+### Tests fail: missing bats
+
+```bash
+brew install bats-core     # macOS
+npm install -g bats        # cross-platform
+```
+
+### validate.py: stale counts
+
+README badges don't match the current agents/skills/tests counts.
+Update README.md and re-run.
+
+### Eject: missing skills
+
+```bash
+ai-toolkit update          # re-link missing symlinks
+ai-toolkit eject /tmp/test # retry
+```
+
+---
+
+## Success Criteria
+
+| Area | Criterion |
+|------|-----------|
+| CLI | `--version` correct, `--help` full list, `status` current |
+| Health | `doctor`: 0 errors, 0 warnings, PASSED |
+| Install | `--dry-run` correct counts, `--local` all configs |
+| Quality | `validate.py --strict`: PASSED |
+| Security | `audit_skills.py --ci`: 0 HIGH |
+| Tests | `npm test`: N/N passed, 0 failures |
+| Eject | Standalone .claude/ with real files |
+| Guards | Destructive commands blocked |

package/kb/reference/architecture-overview.md

@@ -3,7 +3,7 @@ title: "AI Toolkit - Architecture Overview"
 category: reference
 service: ai-toolkit
 tags: [architecture, overview, design, structure]
-version: "1.3.15"
+version: "1.4.0"
 created: "2026-03-23"
 last_updated: "2026-04-08"
 description: "Architecture of ai-toolkit: directory layout, global install model, skill tiers, and integration with projects."
@@ -13,7 +13,7 @@ description: "Architecture of ai-toolkit: directory layout, global install model
 
 ## Purpose
 
-Shared, project-agnostic AI development toolkit for Claude Code (and compatible assistants like Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, and Augment). Provides specialized agents, skills (slash commands + knowledge), expanded lifecycle hooks, persona presets, and experimental opt-in plugin packs that teams can adopt separately from the default global install.
+Shared, project-agnostic AI development toolkit for Claude Code (and compatible assistants like Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, and Google Antigravity). Provides specialized agents, skills (slash commands + knowledge), expanded lifecycle hooks, persona presets, and experimental opt-in plugin packs that teams can adopt separately from the default global install.
 
 ## Design Principles
 
@@ -103,14 +103,19 @@ Machine (global)                              Project (local)
 
 **`ai-toolkit update`** — re-apply after `npm install -g @softspark/ai-toolkit@latest` or after `add-rule` / `remove-rule`. Same as `install` but semantically correct for update flows.
 
-**`ai-toolkit install --local`** (or `update --local`) — run per project, creates `CLAUDE.md` template + `.claude/settings.local.json` (only if missing, initialized with MCP defaults), and injects `constitution.md` + Copilot + Cline + Roo Code + Aider configs into local `.claude/` (preserves existing user content). Installs `--local` git hooks as a fallback for quality gates. Hooks are global-only — not merged into project settings.
+**`ai-toolkit install --local`** — run per project. Always installs Claude Code configs (CLAUDE.md, settings.local.json, constitution.md, language rules). Editor configs are opt-in via `--editors`:
+- `--editors all` — install all 8 editors (Cursor, Windsurf, Cline, Roo, Aider, Augment, Copilot, Antigravity)
+- `--editors cursor,aider` — install only selected editors
+- (no flag) — auto-detect from existing project files; `update --local` picks up whatever editors already have configs
+
+Each editor gets both legacy single-file format (for backwards compat) and new directory-based format (`.cursor/rules/*.mdc`, `.windsurf/rules/*.md`, `.cline/rules/*.md`, `.roo/rules/*.md`, `.augment/rules/ai-toolkit-*.md`, `.agent/rules/*.md`, `CONVENTIONS.md`). Hooks are global-only — not merged into project settings.
 
 ## CLI Commands
 
 | Command | Target | What it does |
 |---------|--------|-------------|
 | `install` | `~/.claude/` | First-time: per-file symlinks + JSON merge + marker injection + rules |
-| `install --local` | `./` | Also set up project-local: `CLAUDE.md` + `settings.local.json` + constitution + Copilot + Cline + Roo + Aider + Git Hooks (hooks stay global-only) |
+| `install --local` | `./` | Claude Code configs + editors via `--editors` (auto-detect or explicit) |
 | `update` | `~/.claude/` | Re-apply after npm update or after add-rule/remove-rule |
 | `update --local` | `./` | Re-apply + refresh project-local configs |
 | `uninstall` | `~/.claude/` | Strips toolkit components (preserves user content) |
@@ -120,13 +125,20 @@ Machine (global)                              Project (local)
 | `doctor` | toolkit | Install health, hooks, benchmark freshness, and artifact drift diagnostics |
 | `benchmark-ecosystem` | toolkit | Benchmark snapshot for official Claude Code and external ecosystem repos |
 | `evaluate` | toolkit | Skill quality report |
-| `cursor-rules` | `./` | Generates `.cursorrules` |
-| `windsurf-rules` | `./` | Generates `.windsurfrules` |
+| `cursor-rules` | `./` | Generates `.cursorrules` (legacy) |
+| `cursor-mdc` | `./` | Generates `.cursor/rules/*.mdc` (recommended) |
+| `windsurf-rules` | `./` | Generates `.windsurfrules` (legacy) |
+| `windsurf-dir-rules` | `./` | Generates `.windsurf/rules/*.md` |
 | `copilot-instructions` | `./` | Generates `.github/copilot-instructions.md` |
 | `gemini-md` | `./` | Generates `GEMINI.md` |
-| `cline-rules` | `./` | Generates `.clinerules` |
+| `cline-rules` | `./` | Generates `.clinerules` (legacy) |
+| `cline-dir-rules` | `./` | Generates `.cline/rules/*.md` |
 | `roo-modes` | `./` | Generates `.roomodes` |
+| `roo-dir-rules` | `./` | Generates `.roo/rules/*.md` |
 | `aider-conf` | `./` | Generates `.aider.conf.yml` |
+| `conventions-md` | `./` | Generates `CONVENTIONS.md` (Aider auto-loaded) |
+| `augment-dir-rules` | `./` | Generates `.augment/rules/ai-toolkit-*.md` |
+| `antigravity-rules` | `./` | Generates `.agent/rules/` + `.agent/workflows/` |
 | `agents-md` | toolkit | Regenerates `AGENTS.md` |
 | `llms-txt` | `./` | Generates `llms.txt` |
 | `generate-all` | `./` | Generates all platform configs at once |