@softspark/ai-toolkit 4.12.0 → 4.13.0

package/benchmarks/ecosystem-doctor-snapshot.json

@@ -1,5 +1,5 @@
 {
-  "last_run": "2026-07-01T22:55:24Z",
+  "last_run": "2026-07-10T06:43:18Z",
   "schema_version": 1,
   "tools": {
     "aider": {
@@ -24,7 +24,7 @@
       }
     },
     "augment": {
-      "docs_hash": "04b55a2b2d496b45",
+      "docs_hash": "880db45231fef284",
       "headings": [
         "Admin",
         "Auggie CLI",
@@ -65,8 +65,50 @@
         "subagents": true
       }
     },
+    "claude-app": {
+      "docs_hash": "bd1483491a8a64e2",
+      "headings": [
+        "Add global and folder instructions",
+        "Availability",
+        "Claude Cowork plugins",
+        "Claude stopped working on my task",
+        "Current limitations",
+        "Data and analysis",
+        "Document creation",
+        "Example use cases",
+        "File and document management",
+        "Files aren't appearing where expected",
+        "Folder instructions",
+        "Get started",
+        "Get started with Claude Cowork",
+        "Global instructions",
+        "How Claude Cowork runs your tasks",
+        "I don't see Cowork on web or mobile",
+        "I'm hitting usage limits quickly",
+        "I'm seeing "Setting up Claude's workspace" when I start Cowork; what does this mean?",
+        "Key capabilities",
+        "Permission modes",
+        "Permissions",
+        "Permissions and security",
+        "Requirements",
+        "Research and analysis",
+        "Schedule recurring tasks",
+        "Start a Cowork session",
+        "Troubleshooting",
+        "Usage limits",
+        "What is Claude Cowork?",
+        "What to expect during a task"
+      ],
+      "markers": {
+        "Folder instructions": true,
+        "Global instructions": true,
+        "plugins": true,
+        "skills": true,
+        "sub-agents": true
+      }
+    },
     "claude-code": {
-      "docs_hash": "338d55540b385861",
+      "docs_hash": "50b46c4f57d16b9e",
       "headings": [
         "Core concepts",
         "Documentation Index",
@@ -122,10 +164,10 @@
         "slash command": true,
         "sub-agent": true
       },
-      "version": "2.1.198 (Claude Code)"
+      "version": "2.1.206 (Claude Code)"
     },
     "cline": {
-      "docs_hash": "80209baf691558e2",
+      "docs_hash": "1726cf1ff3f402b6",
       "headings": [
         "API Reference",
         "Best Practices",
@@ -172,52 +214,77 @@
       }
     },
     "codex-cli": {
-      "docs_hash": "ad6bbf5e29c7155f",
+      "docs_hash": "46073353f24772e6",
       "headings": [
         "API",
         "API Reference",
-        "Administration",
         "Advertiser API",
+        "Agent configuration",
         "Agents SDK",
-        "Automation",
+        "Available on",
+        "Blog",
         "Build",
+        "Build with Codex",
+        "Capabilities",
         "Categories",
-        "Codex",
-        "Codex for Open Source",
+        "Chats",
+        "Choose the right GPT-5.6 model",
+        "Codex Security",
         "Community",
-        "Configuration",
+        "Config file",
+        "Continue a task on another host",
         "Contribute",
         "Conversion apps",
         "Core Concepts",
         "Core concepts",
+        "Customization",
         "Deploy",
+        "Deployment and model providers",
+        "Development workflows",
         "Docs agent",
+        "Environments",
         "Evaluation",
         "Events",
-        "Explore use cases",
+        "Explore",
+        "Extend ChatGPT and Codex",
+        "Extend and automate",
         "File Upload",
+        "Foundations",
         "Get started",
-        "Getting Started",
+        "Getting started",
         "Going live",
         "Guides",
-        "Learn",
+        "Identity and authentication",
         "Legacy APIs",
         "Measurement",
+        "Overview",
+        "Permissions",
         "Plan",
+        "Plugin and connector controls",
         "Programs",
-        "Quickstart",
+        "Projects",
         "Realtime and audio",
         "Recent",
+        "Reference",
         "Releases",
         "Resources",
         "Run and scale",
-        "Search the Codex docs",
+        "Safety",
+        "Search the docs",
         "Spaces",
         "Specialized models",
         "Suggested",
+        "Take on ambitious work with ChatGPT Work",
+        "Third-party integrations",
         "Tools",
         "Topics",
-        "Using Codex"
+        "Turn demonstrated workflows into reusable skills",
+        "Usage, governance, and compliance",
+        "What should we get done?",
+        "What\u2019s new",
+        "Windows",
+        "Workflows",
+        "Workspace access, policy, and models"
       ],
       "markers": {
         ".agents/skills": false,
@@ -240,10 +307,10 @@
         "mcp_servers": false,
         "sandbox": true
       },
-      "version": "codex-cli 0.142.0"
+      "version": "codex-cli 0.144.1"
     },
     "cursor": {
-      "docs_hash": "080c1289cb353e6c",
+      "docs_hash": "63246f9f6c354976",
       "headings": [],
       "markers": {
         ".cursor/rules": false,
@@ -259,7 +326,7 @@
       }
     },
     "gemini-cli": {
-      "docs_hash": "a0ff94dabdb6cd8a",
+      "docs_hash": "7a28426194187480",
       "headings": [
         "Breadcrumbs",
         "Directory actions",
@@ -302,7 +369,7 @@
       }
     },
     "github-copilot": {
-      "docs_hash": "1f9817b3477c576b",
+      "docs_hash": "788efbd31f39bd11",
       "headings": [
         "About Copilot auto model selection",
         "About Copilot automations",
@@ -336,11 +403,10 @@
       }
     },
     "google-antigravity": {
-      "docs_hash": "4d2e384b2c2add18",
+      "docs_hash": "e484097e498581f4",
       "headings": [],
       "markers": {
         "AGENTS.md": false,
-        "Antigravity": false,
         "GEMINI.md": false,
         "MCP": false,
         "agent manager": false,
@@ -353,7 +419,7 @@
       }
     },
     "opencode": {
-      "docs_hash": "28dcd5b88aeb84e0",
+      "docs_hash": "8713591669c1683f",
       "headings": [
         "Add features",
         "Ask questions",
@@ -413,7 +479,7 @@
       }
     },
     "windsurf": {
-      "docs_hash": "b457c990c531efc4",
+      "docs_hash": "93e7f46747f42e11",
       "headings": [
         "Accounts",
         "Advanced",

package/bin/ai-toolkit.js

@@ -52,6 +52,7 @@ const SCRIPT_COMMANDS = {
   'stats':                { script: 'stats.py' },
   'compile-slm':          { script: 'compile_slm.py' },
   'pack-codebase':        { script: 'pack_codebase.py' },
+  'claude-app':           { script: 'claude_app.py',          toolkitCwd: true },
 };
 
 // ---------------------------------------------------------------------------
@@ -109,6 +110,7 @@ const COMMANDS = {
   'agents-md': 'Regenerate AGENTS.md from agent definitions',
   'compile-slm': 'Compile toolkit into a minimal SLM system prompt (--budget, --model-size, --dry-run)',
   'pack-codebase': 'Pack the current codebase into a single AI-friendly markdown file (--budget, --include, --exclude, --dry-run)',
+  'claude-app': 'Export or verify the uploadable Claude Chat/Desktop/Cowork plugin',
   '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, antigravity, codex, opencode, llms)',
   help: 'Show this help message',
@@ -280,6 +282,10 @@ function showHelp() {
   console.log('  list            Show available plugin packs with install status');
   console.log('  status          Show currently installed plugins with data stats');
   console.log('  --editor <list> Runtime target: claude, codex, or all (default: claude)');
+  console.log('\nOptions for claude-app:');
+  console.log('  export [--output FILE] [--no-custom-rules] [--verify]');
+  console.log('                  Build a ZIP for Customize > Plugins and Cowork instructions');
+  console.log('  verify          Run structural checks and the official Claude plugin validator');
   console.log('\nOptions for mcp:');
   console.log('  list                          List available MCP templates');
   console.log('  editors                       List editors with native MCP config adapters');
@@ -539,6 +545,7 @@ function handleStatus(_args) {
  */
 function handleUpdate(args) {
   const isLocal = args.includes('--local');
+  const isDryRun = args.includes('--dry-run') || args.includes('--list');
   let statePath = path.join(process.env.HOME, '.softspark', 'ai-toolkit', 'state.json');
   // Fallback to legacy path for first run after upgrade (before migration runs)
   if (!fs.existsSync(statePath)) {
@@ -568,7 +575,7 @@ function handleUpdate(args) {
   run(scriptPath('install.py'), [...stateArgs, ...args]);
 
   // After global update (not --local), propagate to all registered projects
-  if (!isLocal) {
+  if (!isLocal && !isDryRun) {
     const registryPath = path.join(process.env.HOME, '.softspark', 'ai-toolkit', 'projects.json');
     if (fs.existsSync(registryPath)) {
       try {
@@ -578,8 +585,19 @@ function handleUpdate(args) {
           console.log('');
           console.log('## Updating registered projects');
           console.log('');
-          // Pass through --skip, --refresh-base flags to project updates
-          const passthrough = args.filter(a => a.startsWith('--skip') || a === '--refresh-base');
+          // Pass project-relevant overrides through. In particular, an
+          // explicit `--editors all` must override each project's saved editor
+          // subset during this propagation run.
+          const passthrough = [];
+          for (let i = 0; i < args.length; i += 1) {
+            const arg = args[i];
+            if (arg.startsWith('--skip') || arg === '--refresh-base' || arg.startsWith('--editors=') || arg.startsWith('--profile=')) {
+              passthrough.push(arg);
+            } else if ((arg === '--editors' || arg === '--profile') && args[i + 1]) {
+              passthrough.push(arg, args[i + 1]);
+              i += 1;
+            }
+          }
           run(scriptPath('update_projects.py'), passthrough);
         }
       } catch (_err) {

package/kb/planning/drop-cascade-hooks-after-sunset.md

@@ -10,16 +10,18 @@ tags:
   - deprecation
   - cleanup
 doc_type: plan
-status: scheduled
+status: completed
 created: "2026-06-10"
-last_updated: "2026-06-10"
-completion: "0%"
+last_updated: "2026-07-10"
+completion: "100%"
 trigger_date: "2026-07-01"
-description: "Scheduled cleanup: remove the deprecated Windsurf Cascade hooks generator (.windsurf/hooks.json) in the first ai-toolkit release after the 2026-07-01 Cascade sunset. The Devin CLI replacement (.devin/hooks.v1.json) shipped in v4.8.0; this plan removes the dead Cascade half once it can no longer run."
+description: "Completed cleanup of the deprecated Windsurf Cascade hooks generator after the 2026-07-01 sunset; Devin CLI .devin/hooks.v1.json is now the sole live hook surface."
 ---
 
 # Plan: Drop Cascade hooks after 2026-07-01 sunset
 
+**Completed in v4.13.0 (2026-07-10).** The deprecated generator and install/test wiring were removed; the Devin hook generator remains.
+
 ## Why this exists
 
 Windsurf rebranded to Devin Desktop on 2026-06-02. The Cascade agent — and its
@@ -72,10 +74,13 @@ removing it before the sunset breaks Cascade users who are still on the old agen
 - `python3 scripts/validate.py --strict` — 0/0 (editor-hooks-honesty must still
   report windsurf as hook-enabled via the `devin` generator alias).
 - `python3 scripts/ecosystem_doctor.py --offline --check` — exit 0.
-- `npm test` — 0 `not ok`; confirm no test still references
-  `generate_windsurf_hooks.py` or `.windsurf/hooks.json`.
-- `grep -rn "generate_windsurf_hooks\|windsurf/hooks.json" scripts/ tests/ kb/ README.md`
-  returns nothing (Art. VI.1 orphan check).
+- `npm test` — 0 `not ok`; no test recreates the deleted
+  `generate_windsurf_hooks.py` generator.
+- `grep -rn "generate_windsurf_hooks" scripts/ tests/` returns nothing
+  (Art. VI.1 orphan check — the deleted generator is fully unwired).
+  `.windsurf/hooks.json` intentionally remains referenced by the one-time
+  migration/strip cleanup (`scripts/install_steps/ai_tools.py`) and its test,
+  and in narrative docs (CHANGELOG, README, `kb/`, docstrings).
 
 ## Do NOT touch
 

package/kb/procedures/ecosystem-sync-sop.md

@@ -3,10 +3,10 @@ title: "SOP: Ecosystem Sync"
 category: procedures
 service: ai-toolkit
 tags: [sop, ecosystem, editors, generators, drift-detection, sync]
-version: "1.0.0"
+version: "1.1.0"
 created: "2026-04-23"
-last_updated: "2026-04-23"
-description: "Quarterly (or event-triggered) sync procedure that detects documentation and capability drift in supported tools (Claude Code + 11 editors), analyses our generators and skills for missing features, and walks through the migration + generator-update workflow."
+last_updated: "2026-07-10"
+description: "Quarterly (or event-triggered) sync procedure that detects documentation and capability drift in supported tools (Claude Code, Claude app, and 11 editors), analyses our generators and skills for missing features, and walks through the migration + generator-update workflow."
 ---
 
 # SOP: Ecosystem Sync
@@ -26,7 +26,7 @@ Keeps ai-toolkit aligned with the tools it integrates with. When an editor adds
 ## Quick Reference
 
 ```bash
-# Full check (all 12 tools, online)
+# Full check (all 13 tools, online)
 python3 scripts/ecosystem_doctor.py --format text
 
 # Single tool
@@ -48,7 +48,7 @@ python3 scripts/ecosystem_doctor.py --offline --format text
 
 | File | Purpose |
 |------|---------|
-| `scripts/ecosystem_tools.json` | Authoritative registry: 12 tools with doc URLs, config paths, our generators, capability markers |
+| `scripts/ecosystem_tools.json` | Authoritative registry: 13 tools with doc URLs, config paths, our generators, capability markers |
 | `benchmarks/ecosystem-doctor-snapshot.json` | Last-seen state (headings, content hash, markers, version) — updated via `--update` |
 | `scripts/ecosystem_doctor.py` | Drift detector |
 | `kb/reference/supported-tools-registry.md` | Human-readable view of the registry |

package/kb/procedures/maintenance-sop.md

@@ -3,9 +3,9 @@ title: "SOP: Claude Toolkit Maintenance"
 category: procedures
 service: ai-toolkit
 tags: [sop, maintenance, agents, skills, install]
-version: "3.1.0"
+version: "3.2.0"
 created: "2026-03-23"
-last_updated: "2026-06-10"
+last_updated: "2026-07-10"
 description: "Standard operating procedures for installing, maintaining, and evolving the ai-toolkit."
 ---
 
@@ -92,6 +92,24 @@ What `install` and `update` do (merge-friendly — user content never overwritte
 
 Re-running updates only toolkit content. Old whole-directory symlinks are auto-upgraded to per-file on next run.
 
+### Install in Claude Chat / Desktop / Cowork
+
+The Claude app does not read Claude Code's `~/.claude/rules/`, `CLAUDE.md`,
+agents, skills, or settings. Build the separate app-native plugin:
+
+```bash
+ai-toolkit claude-app export --verify
+```
+
+1. Open Claude and choose `Customize > Plugins > + > Upload plugin`.
+2. Select `ai-toolkit-claude-app.zip`.
+3. Paste `ai-toolkit-claude-app-global-instructions.md` into
+   `Settings > Cowork > Global instructions`.
+
+The export includes registered rules by default; use `--no-custom-rules` for a
+shareable clean bundle. Re-export and re-upload after toolkit or registered-rule
+updates. Skills work in Chat and Cowork. Hooks and sub-agents run only in Cowork.
+
 ### Install Profiles (v3.0.0)
 
 | Profile | Claude Code core | Editor rules | Gemini hooks | Copilot dir layout | Per-editor hooks / sub-agents / commands | Git hooks |
@@ -150,6 +168,9 @@ ai-toolkit remove-rule my-project-rules
 
 Rule names derive from the filename (`my-project-rules.md` → marker `TOOLKIT:my-project-rules`).
 
+After adding or removing a registered rule, re-export the Claude app plugin if
+that runtime should receive the change.
+
 ---
 
 ## Adding a New Agent
@@ -231,6 +252,21 @@ Use this when Claude appears to ignore `CLAUDE.md`, `.claude/rules/*.md`, output
    scripts/validate.py
    ```
 
+## Troubleshooting Rule Enforcement in Claude Chat / Cowork
+
+Do not use `/memory` or inspect `~/.claude/rules/` for the app runtime; those
+checks apply only to Claude Code.
+
+1. Run `ai-toolkit claude-app verify` and fix any manifest/component error.
+2. Re-export the ZIP and upload it from `Customize > Plugins`.
+3. Confirm `ai-toolkit-rules` appears in the `/` or `+` skill picker.
+4. Confirm the generated standing instructions are saved under
+   `Settings > Cowork > Global instructions`.
+5. In regular Chat, expect skills only. Hooks and sub-agents are intentionally
+   unavailable there; test those in Cowork.
+6. Start a new chat/task after updating the plugin so the new component catalog
+   is loaded.
+
 ## Verification
 
 After changing rule-enforcement behavior, run at minimum:
@@ -238,6 +274,8 @@ After changing rule-enforcement behavior, run at minimum:
 ```bash
 bats tests/test_hooks.bats tests/test_search_first_flow.bats
 bats tests/test_install.bats tests/test_codex.bats
+bats tests/test_claude_app.bats tests/test_hooks_per_editor.bats
+python3 scripts/claude_app.py verify
 python3 scripts/validate.py --strict
 ```
 
@@ -245,7 +283,7 @@ python3 scripts/validate.py --strict
 
 ```bash
 ai-toolkit plugin list                             # show available packs
-ai-toolkit plugin install --editor claude <name>  # install for Claude global target
+ai-toolkit plugin install --editor claude <name>  # install for Claude Code global target
 ai-toolkit plugin install --editor codex <name>   # install for Codex global target
 ai-toolkit plugin install --editor all --all      # install all 11 packs for both runtimes
 ai-toolkit plugin update --editor all --all       # re-apply all installed packs after toolkit updates
@@ -283,7 +321,7 @@ Follow the `documentation-standards` knowledge skill (`app/skills/documentation-
 
 **Every addition — skill, hook, MCP template, agent, rule — MUST be verified against all supported editors before merge.**
 
-This toolkit targets 10 platforms. Each has its own config format, file path conventions, and runtime capabilities. A feature that works in Claude Code may silently break in Cursor, Codex, or Copilot if the editor's official spec diverges.
+The ecosystem registry tracks 13 targets: Claude Code, the Claude Chat/Cowork app, and 11 editor integrations. Each has its own config format, file path conventions, and runtime capabilities. A feature that works in Claude Code may silently break in Cursor, Codex, or Copilot if the editor's official spec diverges.
 
 ### Verification checklist
 

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

@@ -371,7 +371,11 @@ Stage all release files:
 git add package.json manifest.json app/.claude-plugin/plugin.json
 git add package-lock.json
 git add CHANGELOG.md
-git add AGENTS.md llms.txt llms-full.txt
+git add llms.txt llms-full.txt
+# NOTE: AGENTS.md, GEMINI.md, and .github/copilot-instructions.md are generated
+# editor configs and are gitignored — do NOT commit them. `prepublishOnly` runs
+# `npm run generate:all`, so the shipped package (which lists AGENTS.md in
+# package.json `files`) gets a fresh copy at publish time.
 git add -p  # review and stage any other changes
 ```
 

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

@@ -3,10 +3,10 @@ title: "SOP: Release Verification"
 category: procedures
 service: ai-toolkit
 tags: [sop, verification, release, smoke-test, install, update, qa, provenance, sarif]
-version: "1.4.3"
+version: "1.6.0"
 created: "2026-04-08"
-last_updated: "2026-05-19"
-description: "End-to-end smoke test after installing or updating @softspark/ai-toolkit — verifies CLI, install, doctor, validation, tests, eject, npm provenance attestation, SARIF audit, and per-skill permissions. Reflects the v2.8.0 supply-chain standard. v1.3.0 added the single-run npm test discipline; v1.4.0 adds v3.0.0 deep-coverage checks (--profile full, --codex-skills, breaking-change surfaces, idempotence, registry drift, live-JSON parse) and refreshes stale thresholds. v1.4.2 makes the Phase 9.4 idempotence check deterministic by sorting file paths before hashing. v1.4.3 tightens the Phase 8.4 URL pin check so the success-message count includes only entries with a `url:` field, not local `path:` entries, and documents the `sources.json` envelope shape."
+last_updated: "2026-07-02"
+description: "End-to-end smoke test after installing or updating @softspark/ai-toolkit — verifies CLI, installs, Claude app plugin export, doctor, validation, tests, eject, npm provenance attestation, SARIF audit, and per-skill permissions. v1.6.0 adds the Claude Chat/Cowork plugin validation and replaces the retired Cascade hook surface with Devin hooks."
 ---
 
 # SOP: Release Verification
@@ -51,10 +51,11 @@ python3 scripts/audit_skills.py --ci                        # 10. Security audit
 python3 scripts/audit_skills.py --sarif | python3 -c "import json,sys; assert json.load(sys.stdin)['version']=='2.1.0'; print('SARIF OK')"   # 11. SARIF 2.1.0 well-formed?
 python3 scripts/audit_skills.py --permissions | head -30    # 12. Broad-access skills reviewed?
 npm view @softspark/ai-toolkit@X.Y.Z --json | python3 -c "import json,sys; d=json.load(sys.stdin); assert d['dist']['attestations']['provenance']['predicateType']=='https://slsa.dev/provenance/v1'; print('PROVENANCE OK')"   # 13. Provenance attested on npm?
+python3 scripts/claude_app.py verify                         # 14. Claude Chat/Cowork plugin contract valid?
 
 # Deep-coverage verification (Phase 9, v3.0.0+)
 META="generate_agents_md.py|generate_llms_txt.py|generate_language_rules_skills.py"
-diff <(grep -oE 'scripts/generate_[a-z_]+\.py' kb/reference/supported-tools-registry.md | sort -u) <(ls scripts/generate_*.py | grep -vE "$META" | sort -u) && echo "OK: registry matches"   # 14. Registry <-> generators drift?
+diff <(grep -oE 'scripts/generate_[a-z_]+\.py' kb/reference/supported-tools-registry.md | sort -u) <(ls scripts/generate_*.py | grep -vE "$META" | sort -u) && echo "OK: registry matches"   # 15. Registry <-> generators drift?
 ```
 
 ---
@@ -80,7 +81,10 @@ python3 scripts/audit_skills.py --ci
 npm test
 
 # 5. Stage and commit
-git add AGENTS.md llms.txt llms-full.txt
+# AGENTS.md, GEMINI.md, and .github/copilot-instructions.md are generated and
+# gitignored — do NOT commit them (regenerated at prepublishOnly). Only the
+# doc artifacts llms.txt / llms-full.txt are committed.
+git add llms.txt llms-full.txt
 git add -p  # stage your other changes
 git commit -m "feat: your change description"
 ```
@@ -122,7 +126,7 @@ ai-toolkit status
 - [ ] Agents >= 44
 - [ ] Skills >= 99
 - [ ] Hooks merged into settings.json
-- [ ] "Other AI Tools" section lists documented global targets only: aider, augment, cline, codex, gemini, opencode, roo, windsurf (Cursor, Copilot, Antigravity via --local for rules)
+- [ ] "Other AI Tools" section lists documented global targets (with `--editors`): aider, antigravity, augment, cline, codex, copilot, cursor, gemini, opencode, roo, windsurf. Scope varies (v4.12.0+): cursor = `~/.cursor/hooks.json` only, copilot = `~/.copilot/` instructions, antigravity = `~/.gemini/*/skills` pointer; Cursor and Antigravity RULES still install only via `--local` (no mergeable global rules file)
 
 **Verify `status`:**
 - [ ] Version matches expected
@@ -338,12 +342,12 @@ These verify the native-surface generators shipped in v3.0.0 actually emit the r
 D=/tmp/aitk-profile-full-${RANDOM} && mkdir -p "$D" && cd "$D" && git init -q
 ai-toolkit install --local --editors cursor,windsurf,gemini,augment,codex \
   --profile full --codex-skills --dry-run 2>&1 \
-  | grep -E "\\.cursor/(hooks\\.json|agents)|\\.windsurf/hooks\\.json|\\.gemini/(settings\\.json|commands)|\\.augment/(agents|commands)|\\.agents/skills"
+  | grep -E "\\.cursor/(hooks\\.json|agents)|\\.devin/hooks\\.v1\\.json|\\.gemini/(settings\\.json|commands)|\\.augment/(agents|commands)|\\.agents/skills"
 ```
 
 **Verify** — at least the following lines appear:
 - [ ] `.cursor/hooks.json` and `.cursor/agents/`
-- [ ] `.windsurf/hooks.json`
+- [ ] `.devin/hooks.v1.json`
 - [ ] `.gemini/settings.json` hooks AND `.gemini/commands/`
 - [ ] `.augment/agents/` + `.augment/commands/` + `$HOME/.augment/settings.json`
 - [ ] `.agents/skills/` (Codex native discovery path; refreshed by `--codex-skills`)
@@ -401,7 +405,7 @@ The bats suite validates JSON shape at generation time. This re-checks that what
 ```bash
 D=/tmp/aitk-json-${RANDOM} && mkdir -p "$D" && cd "$D" && git init -q
 ai-toolkit install --local --editors cursor,windsurf,gemini,augment --profile full >/dev/null 2>&1
-for f in .cursor/hooks.json .windsurf/hooks.json .gemini/settings.json $HOME/.augment/settings.json; do
+for f in .cursor/hooks.json .devin/hooks.v1.json .gemini/settings.json $HOME/.augment/settings.json; do
   [ -f "$f" ] && python3 -c "import json; json.load(open('$f'))" && echo "OK: $f"
 done
 ```
@@ -421,6 +425,18 @@ diff <(echo "$REG") <(echo "$FS") && echo "OK: registry matches filesystem" || e
 
 **Verify:** prints `OK: registry matches filesystem`. If not, add the missing rows to the registry before tagging the next release.
 
+### 9.7 Claude Chat / Cowork plugin validates and exports
+
+```bash
+python3 scripts/claude_app.py verify
+D=/tmp/aitk-claude-app-${RANDOM}
+python3 scripts/claude_app.py export --output "$D.zip" --no-custom-rules
+python3 -c "import zipfile; z=zipfile.ZipFile('$D.zip'); assert '.claude-plugin/plugin.json' in z.namelist(); assert 'claude-app/skills/ai-toolkit-rules/SKILL.md' in z.namelist(); print('OK: Claude app archive')"
+```
+
+**Verify:** the official validator exits 0; the archive contains the manifest,
+app-native rules skill, bundled agents/skills, and plugin-relative Cowork hooks.
+
 ---
 
 ## Troubleshooting

package/kb/reference/architecture-overview.md

@@ -6,14 +6,14 @@ tags: [architecture, overview, design, structure]
 version: "1.4.6"
 created: "2026-03-23"
 last_updated: "2026-06-10"
-description: "Architecture of ai-toolkit: directory layout, global install model, editor-aware MCP install, Codex translation layer, skill tiers, and integration with projects."
+description: "Architecture of ai-toolkit: directory layout, Claude app export, global install model, editor-aware MCP install, Codex translation layer, skill tiers, and integration with projects."
 ---
 
 # AI Toolkit Architecture
 
 ## Purpose
 
-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.
+Shared, project-agnostic AI development toolkit for Claude Code, Claude Chat/Cowork, and compatible assistants such as Cursor, Devin, Copilot, Gemini, Cline, Roo/Zoo Code, Aider, Augment, and Google Antigravity. Provides agents, skills, lifecycle hooks, persona presets, and runtime-specific plugin packaging.
 
 ## Design Principles
 
@@ -33,6 +33,7 @@ ai-toolkit/
     agents/                  # Agent definitions (.md + YAML frontmatter)
     skills/                  # skills: task, hybrid, knowledge
     rules/                   # Source rules synced into Claude/editor rule files
+    claude-app/              # Generated app-only rules skill, hooks, instructions
     hooks/                   # Hook scripts (copied to ~/.softspark/ai-toolkit/hooks/)
     hooks.json               # Hook definitions (merged into ~/.claude/settings.json)
     constitution.md          # Immutable safety rules, 7 articles (marker-injected)
@@ -62,6 +63,7 @@ ai-toolkit/
     generate_llms_txt.py     # Generates llms.txt
     install_git_hooks.py     # Installs fallback pre-commit hook
     plugin.py                # Plugin pack management (install, remove, list, status)
+    claude_app.py            # Claude Chat/Desktop/Cowork plugin export + validation
     benchmark_ecosystem.py   # Generates ecosystem benchmark snapshot
     harvest_ecosystem.py     # Writes machine-readable ecosystem harvest JSON
     compile_slm.py           # Compiles toolkit into minimal SLM system prompt (2K-16K tokens)
@@ -112,6 +114,8 @@ Machine (global)                              Project (local)
 
 Each editor gets directory-based format (`.cursor/rules/*.mdc`, `.devin/rules/*.md` + `.windsurf/rules/*.md` (dual-emit since the Devin Desktop rebrand), `.github/instructions/*.instructions.md` + `.github/prompts/*.prompt.md` + root `AGENTS.md` for Copilot agent instructions, `.clinerules/*.md`, `.roo/rules/*.md`, `.augment/rules/ai-toolkit-*.md`, `.agents/rules/*.md`, `CONVENTIONS.md`). Full-profile installs also emit native skill pointer catalogues for Cursor, Windsurf, and Cline. Codex local install additionally generates `AGENTS.md` (universal coding rules inlined — Codex reads only AGENTS.md, not `.agents/rules/`), `.agents/skills/*`, and `.codex/hooks.json`. Hooks are global-only — not merged into project settings except for editor-native local hook files such as Codex `.codex/hooks.json`. Experimental plugin packs can also layer a global Codex target in `HOME` (`~/AGENTS.md`, `~/.agents/`, `~/.codex/hooks.json`) when installed with `ai-toolkit plugin install --editor codex`.
 
+Claude Chat/Desktop/Cowork is deliberately outside `--editors`: the app does not scan filesystem configuration under `~/.claude`. `ai-toolkit claude-app export` creates a self-contained plugin ZIP with skills, agents, Cowork hooks, app-native rules, and bundled hook dependencies. It also emits the compact text that users paste into Cowork global instructions. Updating requires re-export and re-upload because the app owns its plugin store.
+
 If a project already has `.mcp.json`, local install mirrors its `mcpServers` entries into `.claude/settings.local.json` plus any selected editors with project-scoped native MCP files (`.cursor/mcp.json`, `.github/mcp.json`).
 
 ## CLI Commands
@@ -120,6 +124,7 @@ If a project already has `.mcp.json`, local install mirrors its `mcpServers` ent
 |---------|--------|-------------|
 | `install` | `~/.claude/` | First-time: per-file symlinks + JSON merge + marker injection + rules |
 | `install --local` | `./` | Claude Code configs + editors via `--editors` (auto-detect or explicit) |
+| `claude-app export` | output ZIP + Markdown | Uploadable Claude Chat/Cowork plugin and global instructions |
 | `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) |