@softspark/ai-toolkit 1.0.0

package/kb/reference/hooks-catalog.md

@@ -0,0 +1,306 @@
+---
+title: "Hooks Catalog"
+category: reference
+service: ai-toolkit
+tags: [hooks, quality, safety, enforcement, settings.json]
+version: "1.0.0"
+created: "2026-03-27"
+last_updated: "2026-04-02"
+description: "Complete reference of all ai-toolkit hooks: events, scripts, installation, and runtime behavior."
+---
+
+# Hooks Catalog
+
+## Overview
+
+ai-toolkit provides 15 global hook entries across 12 lifecycle events that enforce quality, safety, and workflow rules across all Claude Code sessions. Hooks are merged into `~/.claude/settings.json` on install, with logic in standalone scripts at `~/.ai-toolkit/hooks/`.
+
+## Installation
+
+```bash
+ai-toolkit install    # copies scripts to ~/.ai-toolkit/hooks/, merges into settings.json
+ai-toolkit update     # re-copies scripts, re-merges (idempotent)
+```
+
+**File locations:**
+- Scripts: `~/.ai-toolkit/hooks/*.sh`
+- Config: `~/.claude/settings.json` → `hooks` key
+- Source: `ai-toolkit/app/hooks/*.sh` + `app/hooks.json`
+
+## Hook Events
+
+### SessionStart — `session-start.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `SessionStart` |
+| Matcher | `startup\|compact` |
+| Script | `~/.ai-toolkit/hooks/session-start.sh` |
+| Fires | Session start + after context compaction |
+
+**Actions:**
+1. Injects MANDATORY reminder to follow CLAUDE.md rules
+2. Injects REMINDER about tests and documentation
+3. Loads session context from `.claude/session-context.md` (if exists)
+4. Loads active instincts from `.claude/instincts/*.md` (if any)
+
+### Notification — inline
+
+| Field | Value |
+|-------|-------|
+| Event | `Notification` |
+| Matcher | *(all)* |
+| Fires | Claude Code waiting for user input |
+
+**Action:** macOS desktop notification via `osascript`.
+
+### PreToolUse (Bash) — `guard-destructive.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `PreToolUse` |
+| Matcher | `Bash` |
+| Script | `~/.ai-toolkit/hooks/guard-destructive.sh` |
+| Fires | Before any Bash command |
+
+**Action:** Blocks (exit 2) commands matching destructive patterns:
+- `rm -rf`, `sudo rm`
+- `DROP TABLE`, `DROP DATABASE`, `TRUNCATE`
+- `format /`, `dd if=`
+- `git push --force`
+- `chmod -R 777`
+
+### PreToolUse (file ops) — `guard-path.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `PreToolUse` |
+| Matcher | `Bash\|Read\|Edit\|Write\|MultiEdit\|Glob\|Grep\|NotebookEdit\|mcp__filesystem__.*` |
+| Script | `~/.ai-toolkit/hooks/guard-path.sh` |
+| Fires | Before any file access tool (including Bash, MCP filesystem) |
+
+**Action:** Blocks (exit 2) when a path contains `/Users/<wrong>` or `/home/<wrong>` that doesn't match the actual `$HOME`. Prevents Claude from hallucinating or confusing similar usernames (common with non-ASCII names like Polish names).
+
+**Feedback to Claude:** Tells it to use `~`, `$HOME`, or run `echo $HOME` instead of guessing.
+
+### UserPromptSubmit — `user-prompt-submit.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `UserPromptSubmit` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/user-prompt-submit.sh` |
+| Fires | Before Claude starts working on a submitted prompt |
+
+**Action:** Adds a lightweight governance reminder: plan mode for architectural work, evidence-first debugging, KB-first research, and validation expectations.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### UserPromptSubmit (usage tracking) — `track-usage.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `UserPromptSubmit` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/track-usage.sh` |
+| Fires | Before Claude starts working on a submitted prompt |
+
+**Action:** Records skill invocations (slash commands like `/commit`, `/review`) to `~/.ai-toolkit/stats.json` for local usage analytics. Non-slash prompts are ignored.
+
+### PostToolUse (edit feedback) — `post-tool-use.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `PostToolUse` |
+| Matcher | `Edit\|MultiEdit\|Write` |
+| Script | `~/.ai-toolkit/hooks/post-tool-use.sh` |
+| Fires | After file edit/write tool operations |
+
+**Action:** Adds a lightweight reminder to run relevant validation, tests, and documentation updates after edits.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### Stop (quality check) — `quality-check.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `Stop` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/quality-check.sh` |
+| Fires | After every Claude response |
+
+**Action:** Runs language-appropriate linter:
+- Python: `ruff check .`
+- TypeScript: `npx tsc --noEmit`
+- PHP: `vendor/bin/phpstan analyse`
+- Dart: `dart analyze`
+- Go: `go vet ./...`
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### Stop (session save) — `save-session.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `Stop` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/save-session.sh` |
+| Fires | After every Claude response |
+
+**Action:** Writes session context to `.claude/session-context.md` for cross-session persistence.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### TaskCompleted — `quality-gate.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `TaskCompleted` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/quality-gate.sh` |
+| Fires | When an Agent Teams task is marked complete |
+
+**Action:** Runs lint/typecheck. **Blocks completion (exit 2)** if errors found. Strict profile also runs `mypy --strict`.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### SubagentStart — `subagent-start.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `SubagentStart` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/subagent-start.sh` |
+| Fires | When a subagent is spawned |
+
+**Action:** Reminds subagents to stay narrow in scope, gather evidence first, and return explicit validation notes.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### SubagentStop — `subagent-stop.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `SubagentStop` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/subagent-stop.sh` |
+| Fires | When a subagent completes |
+
+**Action:** Enforces a concise handoff checklist: findings, files touched, tests run, risks, and docs follow-up.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### PreCompact — `pre-compact.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `PreCompact` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/pre-compact.sh` |
+| Fires | Before context compaction |
+
+**Actions:**
+1. Injects reminder to re-read CLAUDE.md files after compaction
+2. Preserves session context from `.claude/session-context.md` (if exists)
+3. Preserves active instincts from `.claude/instincts/*.md` (if any)
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### SessionEnd — `session-end.sh`
+
+| Field | Value |
+|-------|-------|
+| Event | `SessionEnd` |
+| Matcher | *(all)* |
+| Script | `~/.ai-toolkit/hooks/session-end.sh` |
+| Fires | When a Claude session ends |
+
+**Action:** Writes `.claude/session-end.md` with a lightweight handoff note for the next session and reminds the next session to review preserved context.
+
+Skipped when `TOOLKIT_HOOK_PROFILE=minimal`.
+
+### TeammateIdle — inline
+
+| Field | Value |
+|-------|-------|
+| Event | `TeammateIdle` |
+| Matcher | *(all)* |
+| Fires | Agent Teams teammate going idle |
+
+**Action:** Reminds teammate to verify: files modified, tests written, docs updated.
+
+## Runtime Profiles
+
+Set in `.claude/settings.local.json`:
+
+```json
+{ "env": { "TOOLKIT_HOOK_PROFILE": "standard" } }
+```
+
+| Profile | Behavior |
+|---------|----------|
+| `minimal` | Only destructive guard + SessionStart |
+| `standard` | All hooks (default) |
+| `strict` | Standard + mypy --strict on task completion |
+
+## Architecture
+
+```
+~/.ai-toolkit/
+├── rules/          # Registered rules (add-rule.sh)
+└── hooks/          # Hook scripts (copied on install)
+    ├── _profile-check.sh    # Shared: profile skip logic (sourced by hooks)
+    ├── session-start.sh
+    ├── guard-destructive.sh
+    ├── guard-path.sh
+    ├── user-prompt-submit.sh
+    ├── post-tool-use.sh
+    ├── quality-check.sh
+    ├── quality-gate.sh
+    ├── save-session.sh
+    ├── subagent-start.sh
+    ├── subagent-stop.sh
+    ├── track-usage.sh
+    ├── pre-compact.sh
+    └── session-end.sh
+
+~/.claude/settings.json
+└── hooks:          # Hook definitions referencing ~/.ai-toolkit/hooks/
+    ├── SessionStart → session-start.sh
+    ├── Notification → osascript (inline)
+    ├── PreToolUse   → guard-destructive.sh, guard-path.sh
+    ├── UserPromptSubmit → user-prompt-submit.sh, track-usage.sh
+    ├── PostToolUse  → post-tool-use.sh
+    ├── Stop         → quality-check.sh, save-session.sh
+    ├── TaskCompleted → quality-gate.sh
+    ├── TeammateIdle → echo (inline)
+    ├── SubagentStart → subagent-start.sh
+    ├── SubagentStop  → subagent-stop.sh
+    ├── PreCompact    → pre-compact.sh
+    └── SessionEnd    → session-end.sh
+```
+
+**Key design decisions:**
+- Scripts **copied** (not symlinked) — user can customize without breaking git
+- Hooks in `settings.json` (not `hooks.json`) — Claude Code only reads settings files
+- `_source: "ai-toolkit"` tag on every entry — allows idempotent merge/strip
+- Hooks are **global only** — `--local` does not install hooks into project settings
+
+## Troubleshooting
+
+**Hooks not loading:**
+1. Run `/hooks` in Claude Code — lists all active hooks
+2. Check `claude --debug hooks` — shows matcher resolution
+3. Verify JSON: `python3 -c "import json; json.load(open('$HOME/.claude/settings.json'))"`
+
+**Hook script not found:**
+```bash
+ls ~/.ai-toolkit/hooks/     # should list 12 .sh files (plus _profile-check.sh helper)
+ai-toolkit update            # re-copies scripts
+```
+
+**Legacy cleanup:**
+```bash
+rm ~/.claude/hooks.json      # old format, no longer used
+rm -rf ~/.claude/hooks       # old symlink, no longer used
+```

package/kb/reference/integrations.md

@@ -0,0 +1,88 @@
+---
+title: "AI Toolkit - External Integrations"
+category: reference
+service: ai-toolkit
+tags: [integrations, rules, add-rule]
+version: "1.0.5"
+created: "2026-03-26"
+last_updated: "2026-03-26"
+description: "How external repos inject rules into ~/.claude/CLAUDE.md via ai-toolkit"
+---
+
+# External Integrations
+
+Repos that register rules with ai-toolkit so they are automatically injected into `~/.claude/CLAUDE.md` on every `update`.
+
+---
+
+## How to Register Rules
+
+Use `add-rule` to register a rule file globally. Every subsequent `ai-toolkit update` picks it up automatically.
+
+```bash
+cd /path/to/your-repo
+ai-toolkit add-rule ./jira-rules.md
+ai-toolkit update   # inject now
+```
+
+After registration, `ai-toolkit update` will always re-inject the rule. Registry location: `~/.ai-toolkit/rules/`.
+
+To unregister a rule (removes from `~/.ai-toolkit/rules/` and strips the block from `CLAUDE.md`):
+
+```bash
+ai-toolkit remove-rule jira-rules
+```
+
+---
+
+## How It Works
+
+Both mechanisms use marker-based idempotent injection. Rule name = filename without `.md`.
+
+```
+<!-- TOOLKIT:jira-rules START -->
+
+...rule content...
+
+<!-- TOOLKIT:jira-rules END -->
+```
+
+Content outside markers is never touched. Re-running updates only the marked block.
+
+---
+
+## Adding a New Integration
+
+1. Create `<name>-rules.md` in your repo with Claude-relevant conventions
+2. Register it: `ai-toolkit add-rule ./<name>-rules.md`
+3. Verify it appears in: `~/.ai-toolkit/rules/<name>-rules.md`
+4. On next `install` it will be listed in: `Rules injected: ... <name>-rules`
+5. Add an entry below documenting the integration
+
+---
+
+## Known Integrations
+
+### rag-mcp
+
+**Rule file:** `rag-mcp.md`
+**Marker:** `TOOLKIT:rag-mcp`
+
+Teaches Claude Code the RAG-MCP search protocol: always call `smart_query()` before answering, `kb_id` vs `file_path` distinction, available MCP tools.
+
+```bash
+cd /path/to/rag-mcp
+ai-toolkit add-rule ./rag-mcp-rules.md
+```
+
+### jira-mcp
+
+**Rule file:** `jira-rules.md`
+**Marker:** `TOOLKIT:jira-rules`
+
+Teaches Claude Code the Jira MCP tool set: `sync_tasks`, `read_cached_tasks`, `update_task_status`, `log_task_time`, and key rules (sync first, hours only, check transitions).
+
+```bash
+cd /path/to/jira-mcp
+ai-toolkit add-rule ./jira-rules.md
+```

package/kb/reference/language-packs.md

@@ -0,0 +1,52 @@
+---
+title: "AI Toolkit - Language Plugin Packs"
+category: reference
+service: ai-toolkit
+tags: [plugins, languages, rust, java, csharp, kotlin, swift, ruby]
+version: "1.0.0"
+created: "2026-03-29"
+last_updated: "2026-03-29"
+description: "6 language-specific plugin packs providing knowledge skills for Rust, Java, C#, Kotlin, Swift, and Ruby."
+---
+
+# Language Plugin Packs
+
+## Overview
+
+Language packs are domain-scoped plugin packs that provide knowledge skills for specific programming languages. Each pack contains a single knowledge skill with idiomatic patterns, error handling, testing conventions, common frameworks, and performance tips.
+
+## Available Packs
+
+| Pack | Skill | Language | Key Topics |
+|------|-------|----------|------------|
+| `rust-pack` | `rust-patterns` | Rust | Ownership, borrowing, Cargo, tokio, serde |
+| `java-pack` | `java-patterns` | Java | Records, sealed classes, Spring Boot, JUnit 5 |
+| `csharp-pack` | `csharp-patterns` | C# / .NET | Nullable refs, async/await, ASP.NET Core, EF Core |
+| `kotlin-pack` | `kotlin-patterns` | Kotlin | Coroutines, DSLs, sealed classes, Ktor, MockK |
+| `swift-pack` | `swift-patterns` | Swift / iOS | Protocol-oriented, SwiftUI, async/await, SPM |
+| `ruby-pack` | `ruby-patterns` | Ruby | Blocks, Rails conventions, RSpec, ActiveRecord |
+
+## Skill Content Sections
+
+Each language skill follows a consistent structure:
+
+1. **Project Structure** — standard directory layout and build tool configuration
+2. **Idioms / Code Style** — language-specific patterns and conventions
+3. **Error Handling** — error types, patterns, and best practices
+4. **Testing Patterns** — test frameworks, assertion libraries, mocking
+5. **Common Libraries / Frameworks** — ecosystem essentials
+6. **Performance Tips** — optimization techniques and profiling
+7. **Build / Package Management** — dependency management and CI
+
+## How Knowledge Skills Work
+
+These skills have `user-invocable: false` in their frontmatter, meaning they are NOT slash commands. Instead, Claude loads them contextually when the conversation topic matches the skill's description trigger.
+
+For example, when a user asks "How do I handle errors in Rust?", Claude automatically loads `rust-patterns` to provide idiomatic Rust error handling guidance.
+
+## Requesting New Language Packs
+
+File an issue with the `language-pack` label. Include:
+- Language name
+- Key topics to cover
+- Popular frameworks/libraries to include

package/kb/reference/merge-friendly-install-model.md

@@ -0,0 +1,58 @@
+---
+title: "Merge-Friendly Install Model"
+category: reference
+service: ai-toolkit
+tags: [install, merge, hooks, injection, symlinks]
+version: "1.0.0"
+created: "2026-03-27"
+last_updated: "2026-03-28"
+description: "Reference description of how ai-toolkit preserves user content while installing toolkit components."
+---
+
+# Merge-Friendly Install Model
+
+## Summary
+
+`ai-toolkit` preserves user content while injecting toolkit behavior.
+
+Instead of replacing entire directories or files, the installer uses merge-friendly strategies tailored to each component type.
+
+## Component Strategies
+
+| Component | Strategy | User content behavior |
+|-----------|----------|-----------------------|
+| `agents/*.md` | per-file symlinks | preserved; user file wins on name conflict |
+| `skills/*/` | per-directory symlinks | preserved; user directory wins on name conflict |
+| `settings.json` hooks | JSON merge with `_source: ai-toolkit` | preserved; toolkit entries removable |
+| `constitution.md` | marker injection | preserved outside markers |
+| `ARCHITECTURE.md` | marker injection | preserved outside markers |
+| `CLAUDE.md` | marker injection | preserved outside markers |
+
+## Why this model exists
+
+This avoids two common failure modes:
+1. users losing custom agents / skills due to whole-directory symlinks,
+2. users losing custom hooks or docs due to full-file replacement.
+
+## Operational Consequences
+
+### Positive
+- reversible installs and uninstalls,
+- backward-compatible upgrades,
+- safe coexistence of toolkit and user customizations,
+- idempotent update flow.
+
+### Trade-offs
+- merged / copied artifacts require `ai-toolkit update` to refresh,
+- hook merge logic depends on valid JSON and the `_source` tagging convention,
+- install behavior is more complex than a simple copy or symlink-only model.
+
+## Local Project Setup
+
+Project-local setup uses the same preservation approach for files that should remain repository-specific, especially `CLAUDE.md` and `.claude/settings.local.json`.
+
+## Related Documents
+
+- `kb/reference/distribution-model.md`
+- `kb/reference/global-install-model.md`
+- `kb/reference/hooks-catalog.md`

package/kb/reference/plugin-pack-conventions.md

@@ -0,0 +1,151 @@
+---
+title: "Plugin Pack Conventions"
+category: reference
+service: ai-toolkit
+tags: [plugins, plugin-packs, conventions, manifests, hooks, policy-packs]
+version: "1.0.0"
+created: "2026-03-28"
+last_updated: "2026-04-02"
+description: "Conventions for experimental ai-toolkit plugin packs, policy packs, hook packs, and plugin-creator scaffolding."
+---
+
+# Plugin Pack Conventions
+
+## Purpose
+
+`ai-toolkit` now includes experimental plugin packs under `app/plugins/` to formalize a Claude Code-compatible plugin direction without changing the default global install surface.
+
+## Pack Types
+
+| Type | Purpose | Example |
+|------|---------|---------|
+| `plugin-pack` | Curated bundle of existing assets by domain | `security-pack`, `research-pack` |
+| `policy-pack` | Rules / compliance / governance overlays | future enterprise policy add-ons |
+| `hook-pack` | Optional hook modules or observability bundles | status line, output style |
+
+## Directory Contract
+
+```text
+app/plugins/<pack-name>/
+├── plugin.json
+├── README.md
+├── hooks/        # optional, executable if present
+├── rules/        # optional
+├── skills/       # optional
+├── agents/       # optional
+└── templates/    # optional
+```
+
+## Manifest Contract
+
+Required keys:
+- `name`
+- `description`
+- `version`
+- `domain`
+- `type`
+- `status`
+- `requires`
+- `includes`
+
+`includes` should declare arrays for:
+- `agents`
+- `skills`
+- `rules`
+- `hooks`
+
+## Naming Rules
+
+- Pack directory and `name` should use lowercase-hyphen format
+- Prefer `*-pack` suffix for curated bundles
+- Hook module filenames should be kebab-case and executable
+- Experimental packs should declare `"status": "experimental"`
+
+## Adoption Rules
+
+1. Packs are opt-in and must not be auto-installed by `ai-toolkit install`
+2. Reuse core agents/skills before duplicating definitions
+3. Optional hooks must be documented as opt-in and non-default
+4. Policy packs should be additive and marker-injected where possible
+5. Keep manifests small and reviewable; use README for narrative guidance
+
+## CLI Management
+
+```bash
+ai-toolkit plugin list               # show all 11 packs with install status
+ai-toolkit plugin install <name>     # install a single pack
+ai-toolkit plugin install --all      # install all 11 packs
+ai-toolkit plugin update <name>      # update a pack (remove + reinstall, preserves data)
+ai-toolkit plugin update --all       # update all installed packs
+ai-toolkit plugin clean <name>       # prune data older than 90 days (default)
+ai-toolkit plugin clean <name> --days 30  # prune data older than 30 days
+ai-toolkit plugin remove <name>      # remove a pack
+ai-toolkit plugin remove --all       # remove all installed packs
+ai-toolkit plugin status             # show installed packs with data stats
+```
+
+### What `plugin install` Does
+
+1. **Verifies** referenced agents/skills exist in `~/.claude/` (links them from core if missing)
+2. **Copies** plugin-specific hooks to `~/.ai-toolkit/hooks/plugin-<pack>-<hook>.sh`
+3. **Copies** plugin-specific scripts to `~/.ai-toolkit/plugin-scripts/<pack>/`
+4. **Runs** init scripts if present (e.g. `init_db.py` for memory-pack — safe to re-run, preserves data)
+5. **Merges** plugin hooks into `~/.claude/settings.json` (tagged with `_source: ai-toolkit-plugin-<name>`)
+6. **Records** installed state to `~/.ai-toolkit/plugins.json`
+
+### What `plugin update` Does
+
+1. **Removes** existing plugin hooks, scripts, and settings.json entries (same as `remove`)
+2. **Reinstalls** from the current source (same as `install`)
+3. **Preserves plugin data** (e.g. memory-pack SQLite database is never deleted)
+4. `--all` updates only currently installed packs (not all available)
+
+### What `plugin clean` Does
+
+1. **Prunes** old plugin data based on `--days N` (default 90)
+2. For memory-pack: deletes observations older than N days, removes orphan sessions, runs VACUUM
+3. Shows before/after counts and DB size
+
+### What `plugin remove` Does
+
+1. **Removes** plugin hooks from `~/.ai-toolkit/hooks/`
+2. **Removes** plugin scripts from `~/.ai-toolkit/plugin-scripts/`
+3. **Strips** plugin hook entries from `settings.json` (by `_source` tag)
+4. **Updates** `plugins.json` state
+5. **Leaves** core agents/skills untouched (they belong to the base install)
+6. **Leaves** plugin data intact (e.g. `memory.db` — use `clean` to prune)
+
+### Data Retention (memory-pack)
+
+- **Auto-retention**: `session-summary.sh` hook auto-prunes observations older than 90 days on every session end (configurable via `MEMORY_RETENTION_DAYS` env var)
+- **Manual clean**: `ai-toolkit plugin clean memory-pack --days 30`
+- **Status**: `ai-toolkit plugin status` shows DB size, observation count, date range
+
+## Current Experimental Packs
+
+| Pack | Domain | Agents | Skills | Hooks | Description |
+|------|--------|--------|--------|-------|-------------|
+| `security-pack` | security | 3 | 3 | 2 | Security auditing, threat modeling, OWASP |
+| `research-pack` | research | 4 | 4 | 1 | Multi-source research, synthesis, fact-checking |
+| `frontend-pack` | frontend | 3 | 3 | 1 | React/Vue/CSS, SEO, design engineering |
+| `enterprise-pack` | enterprise | 3 | 3 | 3 | Executive briefings, infra architecture, status |
+| `memory-pack` | memory | 0 | 1 | 2 | SQLite persistent memory with FTS5 search |
+| `rust-pack` | rust | 0 | 1 | 0 | Rust patterns |
+| `java-pack` | java | 0 | 1 | 0 | Java patterns |
+| `csharp-pack` | csharp | 0 | 1 | 0 | C# patterns |
+| `kotlin-pack` | kotlin | 0 | 1 | 0 | Kotlin patterns |
+| `swift-pack` | swift | 0 | 1 | 0 | Swift patterns |
+| `ruby-pack` | ruby | 0 | 1 | 0 | Ruby patterns |
+
+## Optional Hook Modules
+
+`enterprise-pack` provides two optional hook modules:
+- `hooks/status-line.sh` — status line overlay
+- `hooks/output-style.sh` — enterprise reporting style
+
+`memory-pack` provides two hooks:
+- `hooks/observation-capture.sh` — captures tool actions to SQLite (PostToolUse)
+- `hooks/session-summary.sh` — summarizes session on Stop
+
+These are intentionally excluded from the default install until explicitly enabled via `ai-toolkit plugin install`.
+