@vpxa/aikit 0.1.99 → 0.1.100

package/scaffold/dist/adapters/zed.mjs

@@ -0,0 +1,4 @@
+import{AGENTS as e}from"../definitions/agents.mjs";import{PROMPTS as t}from"../definitions/prompts.mjs";function n(e){return e.replace(/^./,e=>e.toLowerCase())}function r(e){return e?.length?[`## Skills`,``,`| Skill | When to load |`,`|-------|--------------|`,...e.map(([e,t])=>`| ${e} | ${t} |`)].join(`
+`):``}function i(e,t,r,i,a){let o=[`# ${e} - ${t}`,``,`> ${r}`,``,`You are the **${e}**, ${n(r)}.`];return i&&o.push(``,i.trim()),a&&o.push(``,a),o.push(``),o.join(`
+`)}function a(){let n=[];for(let[e,r]of Object.entries(t)){let t=[`# aikit ${e}`,``,`> ${r.description}`,``,r.content.trim(),``].join(`
+`);n.push({path:`.zed/prompts/aikit-${e}.md`,content:t})}for(let[t,a]of Object.entries(e)){let e=a.title||t,o=r(a.skills);if(a.variants){for(let[r,s]of Object.entries(a.variants)){let c=`${t}-${r}`,l=s.description||a.description;n.push({path:`.zed/prompts/agent-${c}.md`,content:i(c,e,l,s.bodyAddendum,o)})}continue}n.push({path:`.zed/prompts/agent-${t}.md`,content:i(t,e,a.description,``,o)})}return n}export{a as generateZed};

package/scaffold/dist/definitions/agents.mjs

@@ -62,7 +62,7 @@ During multi-model decision sessions, apply the **Executor** lens:
 - Reject elegant theory that can't survive contact with the codebase
 
 Your lens: implementation feasibility + executor. Prefer \`measure\` + \`blast_radius\` +
-\`analyze_patterns\` over abstract reasoning.`}}},"Code-Reviewer":{title:`The Quality Guardian`,description:`Code review specialist analyzing code for quality, security, performance, and maintainability`,argumentHint:`File path, PR, or code to review`,toolRole:`reviewer`,sharedBase:`code-reviewer-base`,category:`review`,skills:[[`aikit`,`**Always** — AI Kit tool signatures, search, analysis`],[`typescript`,`When reviewing TypeScript code — type patterns, best practices`]],variants:{Alpha:{description:`Primary code reviewer`,identity:`, the primary Code-Reviewer agent. Your lens is **compliance and red-teaming** — you hunt for correctness bugs, security holes, and contract violations that will break in production.`,bodyAddendum:`## Review Lens: Compliance & Red-Team
+\`analyze({ aspect: "patterns", ... })\` over abstract reasoning.`}}},"Code-Reviewer":{title:`The Quality Guardian`,description:`Code review specialist analyzing code for quality, security, performance, and maintainability`,argumentHint:`File path, PR, or code to review`,toolRole:`reviewer`,sharedBase:`code-reviewer-base`,category:`review`,skills:[[`aikit`,`**Always** — AI Kit tool signatures, search, analysis`],[`typescript`,`When reviewing TypeScript code — type patterns, best practices`]],variants:{Alpha:{description:`Primary code reviewer`,identity:`, the primary Code-Reviewer agent. Your lens is **compliance and red-teaming** — you hunt for correctness bugs, security holes, and contract violations that will break in production.`,bodyAddendum:`## Review Lens: Compliance & Red-Team
 
 Your primary focus areas (in order of priority):
 1. **Correctness** — Logic errors, race conditions, null/undefined paths, off-by-one

package/scaffold/dist/definitions/bodies.mjs

@@ -377,7 +377,7 @@ status({})                                                     # Check AI Kit he
 # If onboard not run → onboard({ path: "." })                 # First-time codebase analysis
 flow_list({})                                                  # See available flows
 # Select flow based on task → flow_start({ flow: "<name>", topic: "<task>" })  # Start flow — creates .flows/{topic}/
-list()                                                         # See stored knowledge
+knowledge({ action: "list" })                                 # See stored knowledge
 search({ query: "SESSION CHECKPOINT", origin: "curated" })     # Resume prior work
 \`\`\`
 
@@ -388,14 +388,14 @@ search({ query: "SESSION CHECKPOINT", origin: "curated" })     # Resume prior wo
 | Intermediate result | \`stash({ key, value })\` |
 | Parallel A/B exploration (read-only) | \`lane({ action: 'create', name })\` → explore → \`lane({ action: 'diff', names })\` |
 | Milestone completed | \`checkpoint({ action: "save", name })\` |
-| Architecture decision made | \`remember({ title, content, category: "decisions" })\` |
-| Pattern discovered | \`remember({ title, content, category: "patterns" })\` |
+| Architecture decision made | \`knowledge({ action: "remember", title, content, category: "decisions" })\` |
+| Pattern discovered | \`knowledge({ action: "remember", title, content, category: "patterns" })\` |
 | About to propose new approach | \`search({ query })\` — check if already decided |
 
 ### End (MUST do)
 
 \`session_digest({ persist: true })\`                              # Auto-capture session activity
-\`remember({ title: "Session checkpoint: <topic>", content: "<decisions, blockers, next steps>", category: "conventions" })\`
+\`knowledge({ action: "remember", title: "Session checkpoint: <topic>", content: "<decisions, blockers, next steps>", category: "conventions" })\`
 
 ## Flows
 
@@ -419,7 +419,7 @@ Load the \`aikit\` skill for full tool documentation, workflow chains, and sessi
 
 ## Planning Workflow
 
-1. **AI Kit Recall** — Search for past plans, architecture decisions, known patterns. Check \`list()\` for stored knowledge.
+1. **AI Kit Recall** — Search for past plans, architecture decisions, known patterns. Check \`knowledge({ action: "list" })\` for stored knowledge.
 2. **FORGE Classify** — \`forge_classify({ task, files, root_path: "." })\` to determine complexity tier
 3. **FORGE Ground** — \`forge_ground\` to scope map, seed unknowns, load constraints
 4. **Research** — Delegate to Explorer and Researcher agents to gather context
@@ -501,7 +501,7 @@ When subagents complete, their visual outputs (from \`present\`) are NOT visible
 | \`c4-architecture\` | When the plan involves architectural changes — generate C4 diagrams |
 | \`adr-skill\` | When the plan involves non-trivial technical decisions — create executable ADRs |
 | \`session-handoff\` | When context window is filling up, planning session ending, or major milestone completed |
-| \`repo-access\` | When the plan involves accessing private, enterprise, or self-hosted repositories |`,Implementer:"**Read `AGENTS.md`** in the workspace root for project conventions and AI Kit protocol.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.\n\n## Implementation Protocol\n\n1. **Understand scope** — Read the phase objective, identify target files\n2. **Write test first** (Red) — Create failing tests that define expected behavior\n3. **Implement** (Green) — Write minimal code to make tests pass\n4. **Refactor** — Clean up while keeping tests green\n5. **Validate** — `check`, `test_run`, `blast_radius`\n6. **Persist** — `remember` any decisions or patterns discovered\n\n## Rules\n\n- **Test-first always** — No implementation without a failing test\n- **Minimal code** — Don't build what isn't asked for\n- **Follow existing patterns** — Search AI Kit for conventions before creating new ones (`search(\"convention\")`, `list({ category: \"conventions\" })`)\n- **Never modify tests to make them pass** — Fix the implementation instead\n- **Run `check` after every change** — Catch errors early\n- **Loop-break** — If the same test fails 3 times with the same error after your fixes, STOP. Re-read the error from scratch, check your assumptions with `trace` or `symbol`, and try a fundamentally different approach. Do not attempt a 4th fix in the same direction\n- **Think-first for complex tasks** — If a task involves 3+ files or non-obvious logic, outline your approach before writing code. Check existing patterns with `search` first. Design, then implement\n\n## Pre-Edit Checklist (before modifying any file)\n\n1. **Understand consumers** — `graph({action:'find_nodes', name_pattern:'<target>'})` → `graph({action:'neighbors', node_id, direction:'incoming'})`. See who calls/imports before changing a contract.\n2. **Compress, don't raw-read** — `file_summary` then `compact({path, query})` for the specific area. Only `read_file` when you need exact lines for `replace_string_in_file`.\n3. **Snapshot risky edits** — `checkpoint({action:'save', label:'pre-<scope>'})` before cross-cutting changes. `checkpoint({action:'restore', ...})` if `check`/`test_run` fails.\n4. **Estimate blast radius** — `blast_radius({changed_files:[...]})` BEFORE editing when changing a public/shared symbol; re-run AFTER to confirm actual impact matches.\n5. **TDD when tests exist** — write/extend the failing test first, then minimum code to pass.\n\n## Post-Edit Checklist\n\n1. `check({})` — typecheck + lint must pass clean\n2. `test_run({})` — full suite or targeted pattern\n3. If Orchestrator passed a `task_id`: `evidence_map({action:'add', task_id, claim, status:'V', receipt:'file.ts#Lxx'})` for each verified contract/acceptance claim. Do NOT run the gate — Orchestrator owns it.",Frontend:"**Read `AGENTS.md`** in the workspace root for project conventions and AI Kit protocol.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.\n\n## Frontend Protocol\n\n1. **Search KB** for existing component patterns and design tokens\n2. **Write component tests first** — Accessibility, rendering, interaction\n3. **Implement** — Follow existing component patterns, use design system tokens\n4. **Validate** — `check`, `test_run`, visual review\n5. **Persist** — `remember` new component patterns\n\n## Rules\n\n- **Accessibility first** — ARIA attributes, keyboard navigation, screen reader support\n- **Follow design system** — Use existing tokens, don't create one-off values\n- **Responsive by default** — Mobile-first, test all breakpoints\n- **Test-first** — Component tests before implementation\n\n## Frontend Exploration Mode\n\n| Need | Tool |\n|------|------|\n| Component dependency graph | `graph({action:'neighbors', node_id:'src/components/X.tsx', direction:'incoming'})` |\n| Stale / unused components | `dead_symbols({ path:'src/components' })` |\n| React / a11y / library API research | `web_search({ query })`, `web_fetch({ urls })` |\n| Component complexity hotspots | `measure({ path:'src/components' })` |\n| Verify a component's callers | `graph({action:'find_nodes', name_pattern})` → `neighbors` |\n\n## Visual Validation Protocol (post `test_run`)\n\n**Pre-flight (MANDATORY before any browser step):**\n1. Read `package.json` scripts — identify dev command (e.g. `dev`, `start`, `vite`)\n2. Determine default port (check script args, `vite.config.*`, or env)\n3. Check if dev server already running on port (attempt `http({ url:'http://localhost:<port>' })`)\n4. If NOT running, delegate to a helper or use `createAndRunTask` to start `npm run dev`\n   in the background; wait for ready signal\n5. Capture the base URL\n\n**Validation:**\n6. `open_browser_page({ url })` — render target component page\n7. `screenshot_page` + `read_page` — capture visual + DOM\n8. Keyboard-only navigation check: simulate Tab/Enter/Escape via `type_in_page` —\n   verify focus ring, activation, dismiss\n9. Compare against design tokens / Figma URL if supplied\n10. Fail fast if color contrast < 4.5:1 (WCAG AA) or focus indicator missing\n\nIf the pre-flight dev server cannot be started (e.g. sandbox), fall back to\n`compact` inspection of the component source + describe expected visual behavior.",Debugger:`**Read \`AGENTS.md\`** in the workspace root for project conventions and AI Kit protocol.
+| \`repo-access\` | When the plan involves accessing private, enterprise, or self-hosted repositories |`,Implementer:"**Read `AGENTS.md`** in the workspace root for project conventions and AI Kit protocol.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.\n\n## Implementation Protocol\n\n1. **Understand scope** — Read the phase objective, identify target files\n2. **Write test first** (Red) — Create failing tests that define expected behavior\n3. **Implement** (Green) — Write minimal code to make tests pass\n4. **Refactor** — Clean up while keeping tests green\n5. **Validate** — `check`, `test_run`, `blast_radius`\n6. **Persist** — `remember` any decisions or patterns discovered\n\n## Rules\n\n- **Test-first always** — No implementation without a failing test\n- **Minimal code** — Don't build what isn't asked for\n- **Follow existing patterns** — Search AI Kit for conventions before creating new ones (`search(\"convention\")`, `knowledge({ action: \"list\", category: \"conventions\" })`)\n- **Never modify tests to make them pass** — Fix the implementation instead\n- **Run `check` after every change** — Catch errors early\n- **Loop-break** — If the same test fails 3 times with the same error after your fixes, STOP. Re-read the error from scratch, check your assumptions with `trace` or `symbol`, and try a fundamentally different approach. Do not attempt a 4th fix in the same direction\n- **Think-first for complex tasks** — If a task involves 3+ files or non-obvious logic, outline your approach before writing code. Check existing patterns with `search` first. Design, then implement\n\n## Pre-Edit Checklist (before modifying any file)\n\n1. **Understand consumers** — `graph({action:'find_nodes', name_pattern:'<target>'})` → `graph({action:'neighbors', node_id, direction:'incoming'})`. See who calls/imports before changing a contract.\n2. **Compress, don't raw-read** — `file_summary` then `compact({path, query})` for the specific area. Only `read_file` when you need exact lines for `replace_string_in_file`.\n3. **Snapshot risky edits** — `checkpoint({action:'save', label:'pre-<scope>'})` before cross-cutting changes. `checkpoint({action:'restore', ...})` if `check`/`test_run` fails.\n4. **Estimate blast radius** — `blast_radius({changed_files:[...]})` BEFORE editing when changing a public/shared symbol; re-run AFTER to confirm actual impact matches.\n5. **TDD when tests exist** — write/extend the failing test first, then minimum code to pass.\n\n## Post-Edit Checklist\n\n1. `check({})` — typecheck + lint must pass clean\n2. `test_run({})` — full suite or targeted pattern\n3. If Orchestrator passed a `task_id`: `evidence_map({action:'add', task_id, claim, status:'V', receipt:'file.ts#Lxx'})` for each verified contract/acceptance claim. Do NOT run the gate — Orchestrator owns it.",Frontend:"**Read `AGENTS.md`** in the workspace root for project conventions and AI Kit protocol.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.\n\n## Frontend Protocol\n\n1. **Search AI Kit** for existing component patterns and design tokens\n2. **Write component tests first** — Accessibility, rendering, interaction\n3. **Implement** — Follow existing component patterns, use design system tokens\n4. **Validate** — `check`, `test_run`, visual review\n5. **Persist** — `remember` new component patterns\n\n## Rules\n\n- **Accessibility first** — ARIA attributes, keyboard navigation, screen reader support\n- **Follow design system** — Use existing tokens, don't create one-off values\n- **Responsive by default** — Mobile-first, test all breakpoints\n- **Test-first** — Component tests before implementation\n\n## Frontend Exploration Mode\n\n| Need | Tool |\n|------|------|\n| Component dependency graph | `graph({action:'neighbors', node_id:'src/components/X.tsx', direction:'incoming'})` |\n| Stale / unused components | `dead_symbols({ path:'src/components' })` |\n| React / a11y / library API research | `web_search({ query })`, `web_fetch({ urls })` |\n| Component complexity hotspots | `measure({ path:'src/components' })` |\n| Verify a component's callers | `graph({action:'find_nodes', name_pattern})` → `neighbors` |\n\n## Visual Validation Protocol (post `test_run`)\n\n**Pre-flight (MANDATORY before any browser step):**\n1. Read `package.json` scripts — identify dev command (e.g. `dev`, `start`, `vite`)\n2. Determine default port (check script args, `vite.config.*`, or env)\n3. Check if dev server already running on port (attempt `http({ url:'http://localhost:<port>' })`)\n4. If NOT running, delegate to a helper or use `createAndRunTask` to start `npm run dev`\n   in the background; wait for ready signal\n5. Capture the base URL\n\n**Validation:**\n6. `open_browser_page({ url })` — render target component page\n7. `screenshot_page` + `read_page` — capture visual + DOM\n8. Keyboard-only navigation check: simulate Tab/Enter/Escape via `type_in_page` —\n   verify focus ring, activation, dismiss\n9. Compare against design tokens / Figma URL if supplied\n10. Fail fast if color contrast < 4.5:1 (WCAG AA) or focus indicator missing\n\nIf the pre-flight dev server cannot be started (e.g. sandbox), fall back to\n`compact` inspection of the component source + describe expected visual behavior.",Debugger:`**Read \`AGENTS.md\`** in the workspace root for project conventions and AI Kit protocol.
 
 Load the \`aikit\` skill for full tool documentation, workflow chains, and session protocol.
 
@@ -531,7 +531,7 @@ Choose the appropriate loop type:
 ### Phase 2: Reproduce
 
 1. \`search("error patterns")\` — check auto-captured error patterns and known issues
-2. \`list({ tags: ["errors"] })\` — find prior troubleshooting knowledge
+2. \`knowledge({ action: "list", tags: ["errors"] })\` — find prior troubleshooting knowledge
 3. Run the feedback loop — confirm the error fires consistently
 4. If intermittent: add instrumentation, increase loop iterations, check race conditions
 
@@ -573,7 +573,7 @@ Load the \`aikit\` skill for full tool documentation, workflow chains, and sessi
 ## Refactoring Protocol
 
 1. **AI Kit Recall** — Search for established patterns and conventions
-2. **Analyze** — \`graph\` (module dependency map), \`analyze_structure\`, \`analyze_patterns\`, \`dead_symbols\`, \`trace\` (impact chains)
+2. **Analyze** — \`graph\` (module dependency map), \`analyze({ aspect: "structure", ... })\`, \`analyze({ aspect: "patterns", ... })\`, \`dead_symbols\`, \`trace\` (impact chains)
 3. **Ensure test coverage** — Run existing tests, add coverage for untested paths
 4. **Refactor in small steps** — Each step must keep tests green
 5. **Validate** — \`check\`, \`test_run\`, \`blast_radius\` after each step
@@ -636,11 +636,11 @@ Load the \`aikit\` skill for full tool documentation, workflow chains, and sessi
    - \`synthesis-guide.md\` — project overview and architecture
    - \`patterns.md\` — established conventions (check for security-related patterns)
    - \`api-surface.md\` — exported function signatures (attack surface)
-3. \`search("security vulnerabilities conventions")\` + \`list()\` for past findings
+3. \`search("security vulnerabilities conventions")\` + \`knowledge({ action: "list" })\` for past findings
 
 ## Security Review Protocol
 
-1. **AI Kit Recall** — \`search("security findings <area>")\` + \`list()\` for past security decisions and known issues
+1. **AI Kit Recall** — \`search("security findings <area>")\` + \`knowledge({ action: "list" })\` for past security decisions and known issues
 2. **Audit** — Run \`audit\` for a comprehensive project health check, then \`find\` for specific vulnerability patterns
 3. **OWASP Top 10 Scan** — Check each category systematically
 4. **Dependency Audit** — Check for known CVEs in dependencies
@@ -649,7 +649,7 @@ Load the \`aikit\` skill for full tool documentation, workflow chains, and sessi
 7. **Input Validation** — Check all user inputs for injection vectors
 8. **Impact Analysis** — Use \`trace\` on sensitive functions, \`blast_radius\` on security-critical files
 9. **Report** — Severity-ranked findings with remediation guidance
-10. **Persist** — \`remember({ title: "Security: <finding>", content: "<details, severity, remediation>", category: "troubleshooting" })\` for each significant finding
+10. **Persist** — \`knowledge({ action: "remember", title: "Security: <finding>", content: "<details, severity, remediation>", category: "troubleshooting" })\` for each significant finding
 
 ## Severity Levels
 
@@ -679,15 +679,15 @@ Load the \`aikit\` skill for full tool documentation, workflow chains, and sessi
    - \`synthesis-guide.md\` — project overview and architecture
    - \`structure.md\` — file tree and module purposes
    - \`patterns.md\` — established conventions
-3. \`search("documentation conventions")\` + \`list()\` for existing docs and standards
+3. \`search("documentation conventions")\` + \`knowledge({ action: "list" })\` for existing docs and standards
 
 ## Documentation Protocol
 
-1. **AI Kit Recall** — \`search("documentation <area>")\` + \`list()\` for existing docs, conventions, architecture decisions
-2. **Analyze** — \`analyze_structure\`, \`analyze_entry_points\`, \`file_summary\`
+1. **AI Kit Recall** — \`search("documentation <area>")\` + \`knowledge({ action: "list" })\` for existing docs, conventions, architecture decisions
+2. **Analyze** — \`analyze({ aspect: "structure", ... })\`, \`analyze({ aspect: "entry_points", ... })\`, \`file_summary\`
 3. **Draft** — Write documentation following project conventions
 4. **Cross-reference** — Link to related docs, ensure consistency
-5. **Persist** — \`remember({ title: "Docs: <standard>", content: "<details>", category: "conventions" })\` for new documentation standards
+5. **Persist** — \`knowledge({ action: "remember", title: "Docs: <standard>", content: "<details>", category: "conventions" })\` for new documentation standards
 
 ## Documentation Types
 
@@ -745,4 +745,4 @@ Rules adapted from *The Elements of Agent Style* (CC BY 4.0, Yue Zhao) and class
 | \`present\` | When presenting documentation previews, API tables, or architecture visuals to the user |
 | \`c4-architecture\` | When documenting system architecture — generate C4 Mermaid diagrams |
 | \`adr-skill\` | When documenting architecture decisions — create or update ADRs |
-| \`typescript\` | When documenting TypeScript APIs — type signatures, JSDoc patterns |`,Explorer:"**Read `AGENTS.md`** in the workspace root for project conventions and AI Kit protocol.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.\n\n## MANDATORY FIRST ACTION\n\n1. Run `status({})` — if onboard shows ❌, run `onboard({ path: \".\" })` and wait for completion\n2. Note the **Onboard Directory** path from status output\n3. **Before exploring**, read relevant onboard artifacts using `compact({ path: \"<dir>/<file>\" })`:\n   - `synthesis-guide.md` — project overview and architecture\n   - `structure.md` — file tree and module purposes\n   - `symbols.md` + `api-surface.md` — exported symbols\n   - `dependencies.md` — import relationships\n   - `code-map.md` — module graph\n4. Only use `find`, `symbol`, `trace`, `graph` for details NOT covered by artifacts\n\n## Exploration Protocol\n\n1. **AI Kit Recall** — `search` for existing analysis on this area\n2. **Discover** — Use `find`, `symbol`, `scope_map` to locate relevant files\n3. **Analyze** — Use `analyze_structure`, `analyze_dependencies`, `file_summary`\n4. **Compress** — Use `compact` for targeted file sections, `digest` when synthesizing 3+ sources, `stratum_card` for files you'll reference repeatedly\n5. **Map** — Build a picture of the subsystem: files, exports, dependencies, call chains\n6. **Report** — Structured findings with file paths and key observations\n\n## Exploration Modes\n\n| Goal | Tools |\n|------|-------|\n| Find files for a feature | `find`, `scope_map` |\n| Map a symbol's usage | `symbol`, `trace` |\n| Map module relationships | `graph({ action: 'neighbors' })` — import/export edges across packages |\n| Understand a package | `analyze_structure`, `analyze_dependencies`, `file_summary` |\n| Check impact of a change | `blast_radius` |\n\n## Output Format\n\n```markdown\n## Exploration: {topic}\n\n### Files Found\n- path/to/file.ts — purpose, key exports\n\n### Dependencies\n- package A → package B (via import)\n\n### Key Observations\n- Notable patterns, potential issues, architectural notes\n```\n\n## Rules\n\n- **Speed over depth** — Provide a useful map quickly, not an exhaustive analysis\n- **Read-only** — Never create, edit, or delete files\n- **Structured output** — Always return findings in the format above"};export{e as AGENT_BODIES};
+| \`typescript\` | When documenting TypeScript APIs — type signatures, JSDoc patterns |`,Explorer:'**Read `AGENTS.md`** in the workspace root for project conventions and AI Kit protocol.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.\n\n## MANDATORY FIRST ACTION\n\n1. Run `status({})` — if onboard shows ❌, run `onboard({ path: "." })` and wait for completion\n2. Note the **Onboard Directory** path from status output\n3. **Before exploring**, read relevant onboard artifacts using `compact({ path: "<dir>/<file>" })`:\n   - `synthesis-guide.md` — project overview and architecture\n   - `structure.md` — file tree and module purposes\n   - `symbols.md` + `api-surface.md` — exported symbols\n   - `dependencies.md` — import relationships\n   - `code-map.md` — module graph\n4. Only use `find`, `symbol`, `trace`, `graph` for details NOT covered by artifacts\n\n## Exploration Protocol\n\n1. **AI Kit Recall** — `search` for existing analysis on this area\n2. **Discover** — Use `find`, `symbol`, `scope_map` to locate relevant files\n3. **Analyze** — Use `analyze({ aspect: "structure", ... })`, `analyze({ aspect: "dependencies", ... })`, `file_summary`\n4. **Compress** — Use `compact` for targeted file sections, `digest` when synthesizing 3+ sources, `stratum_card` for files you\'ll reference repeatedly\n5. **Map** — Build a picture of the subsystem: files, exports, dependencies, call chains\n6. **Report** — Structured findings with file paths and key observations\n\n## Exploration Modes\n\n| Goal | Tools |\n|------|-------|\n| Find files for a feature | `find`, `scope_map` |\n| Map a symbol\'s usage | `symbol`, `trace` |\n| Map module relationships | `graph({ action: \'neighbors\' })` — import/export edges across packages |\n| Understand a package | `analyze({ aspect: "structure", ... })`, `analyze({ aspect: "dependencies", ... })`, `file_summary` |\n| Check impact of a change | `blast_radius` |\n\n## Output Format\n\n```markdown\n## Exploration: {topic}\n\n### Files Found\n- path/to/file.ts — purpose, key exports\n\n### Dependencies\n- package A → package B (via import)\n\n### Key Observations\n- Notable patterns, potential issues, architectural notes\n```\n\n## Rules\n\n- **Speed over depth** — Provide a useful map quickly, not an exhaustive analysis\n- **Read-only** — Never create, edit, or delete files\n- **Structured output** — Always return findings in the format above'};export{e as AGENT_BODIES};

package/scaffold/dist/definitions/flows.mjs

@@ -58,24 +58,24 @@ If \`docs/\` doesn't exist, run the **Architecture Blueprint Workflow** from the
 \`\`\`
 # Step 1: Generate content with AI Kit tools
 produce_knowledge({ path: "." })                        # → Foundation for docs/README.md
-analyze_structure({ path: "." })                        # → docs/architecture/overview.md structure
-analyze_diagram({ path: "." })                          # → docs/architecture/ Mermaid diagrams
-analyze_dependencies({ path: "." })                     # → docs/architecture/overview.md deps section
-analyze_entry_points({ path: "." })                     # → docs/reference/api.md foundation
-analyze_patterns({ path: "." })                         # → docs/architecture/overview.md patterns
+analyze({ aspect: "structure", path: "." })             # → docs/architecture/overview.md structure
+analyze({ aspect: "diagram", path: "." })               # → docs/architecture/ Mermaid diagrams
+analyze({ aspect: "dependencies", path: "." })          # → docs/architecture/overview.md deps section
+analyze({ aspect: "entry_points", path: "." })          # → docs/reference/api.md foundation
+analyze({ aspect: "patterns", path: "." })              # → docs/architecture/overview.md patterns
 
 # Step 2: Create the docs/ tree from tool outputs
 docs/
 ├── README.md              ← From produce_knowledge + project context
 ├── architecture/
-│   ├── overview.md        ← From analyze_structure + analyze_dependencies + analyze_diagram
-│   └── components/        ← From analyze_symbols per major component
+│   ├── overview.md        ← From analyze(structure|dependencies|diagram)
+│   └── components/        ← From analyze(symbols) per major component
 ├── decisions/
 │   └── index.md           ← ADR log (delegate to adr-skill)
 ├── guides/
-│   └── testing.md         ← From analyze_patterns test info
+│   └── testing.md         ← From analyze(patterns) test info
 └── reference/
-    └── api.md             ← From analyze_entry_points
+   └── api.md             ← From analyze(entry_points)
 \`\`\`
 
 Use the Architecture Blueprint sections from the \`docs\` skill as the template for each document.
@@ -267,7 +267,7 @@ Load these skills BEFORE executing this step:
 
 | Skill | Purpose | When |
 |-------|---------|------|
-| \`aikit\` | Core MCP tools — search, analyze, remember, validate | Always (auto-loaded) |
+| \`aikit\` | Core MCP tools — search, analyze, knowledge, validate | Always (auto-loaded) |
 | \`present\` | Rich rendering for any structured output — assessments, reports, comparisons, reviews, status boards, tables, charts, and all artifact content | Use for ANY output that benefits from rich rendering, not just dashboards |
 | \`multi-agents-development\` | Dispatch templates, task decomposition, review pipeline patterns | Before dispatching any subagent |
 | \`brainstorming\` | Structured ideation for design/creative decisions | Before any design choice or new feature exploration |
@@ -291,13 +291,13 @@ Load these skills BEFORE executing this step:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Design decisions**: Chosen approach and alternatives considered with trade-offs
 - **Architecture patterns**: New patterns introduced or existing patterns that must be followed
 - **Constraints discovered**: Technical limitations, compatibility requirements, or performance boundaries
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/execute/README.md`,content:`---
 name: execute
 description: Implement all tasks from the task breakdown, dispatching agents in parallel where possible.
@@ -392,7 +392,7 @@ Load these skills BEFORE executing this step:
 
 | Skill | Purpose | When |
 |-------|---------|------|
-| \`aikit\` | Core MCP tools — search, analyze, remember, validate | Always (auto-loaded) |
+| \`aikit\` | Core MCP tools — search, analyze, knowledge, validate | Always (auto-loaded) |
 | \`present\` | Rich rendering for any structured output — assessments, reports, comparisons, reviews, status boards, tables, charts, and all artifact content | Use for ANY output that benefits from rich rendering, not just dashboards |
 | \`multi-agents-development\` | Dispatch templates, task decomposition, review pipeline patterns | Before dispatching any subagent |
 | \`brainstorming\` | Structured ideation for design/creative decisions | Before any design choice or new feature exploration |
@@ -436,13 +436,13 @@ Follow the \`multi-agents-development\` skill patterns for dispatch:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Implementation decisions**: Why specific approaches were chosen over alternatives
 - **Patterns established**: New conventions or patterns that future code should follow
 - **Gotchas encountered**: Edge cases, workarounds, or non-obvious behaviors discovered during execution
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/plan/README.md`,content:`---
 name: plan
 description: Analyze the codebase, design the architecture, and create a detailed implementation plan.
@@ -537,7 +537,7 @@ Load these skills BEFORE executing this step:
 
 | Skill | Purpose | When |
 |-------|---------|------|
-| \`aikit\` | Core MCP tools — search, analyze, remember, validate | Always (auto-loaded) |
+| \`aikit\` | Core MCP tools — search, analyze, knowledge, validate | Always (auto-loaded) |
 | \`present\` | Rich rendering for any structured output — assessments, reports, comparisons, reviews, status boards, tables, charts, and all artifact content | Use for ANY output that benefits from rich rendering, not just dashboards |
 | \`multi-agents-development\` | Dispatch templates, task decomposition, review pipeline patterns | Before dispatching any subagent |
 | \`brainstorming\` | Structured ideation for design/creative decisions | Before any design choice or new feature exploration |
@@ -562,13 +562,13 @@ Load these skills BEFORE executing this step:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Task dependencies**: Critical ordering constraints and parallel opportunities
 - **Risk assessment**: Identified risks and mitigation strategies
 - **Resource decisions**: File ownership, module boundaries, and integration points
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/spec/README.md`,content:`---
 name: spec
 description: Elicit requirements, clarify scope, and define acceptance criteria through structured dialogue.
@@ -683,13 +683,13 @@ Load these skills BEFORE executing this step:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Requirements clarified**: Ambiguities resolved and assumptions validated
 - **Scope boundaries**: What the spec covers and explicit exclusions
 - **Acceptance criteria**: Key testable conditions that define "done"
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/task/README.md`,content:`---
 name: task
 description: Break the implementation plan into ordered, atomic tasks with dependencies and agent assignments.
@@ -802,13 +802,13 @@ Load these skills BEFORE executing this step:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Task decomposition rationale**: Why tasks were split this way and what each accomplishes
 - **Interface contracts**: APIs, types, or data shapes that tasks depend on
 - **Coordination points**: Where tasks interact and handoff requirements
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/verify/README.md`,content:`---
 name: verify
 description: Dual code review, architecture review, security review, and comprehensive test validation.
@@ -947,13 +947,13 @@ After all reviews complete:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Test coverage gaps**: Areas that couldn't be fully tested and why
 - **Quality findings**: Issues found during verification and their resolutions
 - **Session checkpoint**: Summarize what was accomplished, decisions made, and any remaining work
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `}],"aikit-basic":[{file:`README.md`,content:"# aikit:basic — Quick Development Flow\n\nQuick development flow for **bug fixes, small features, and refactoring**.\n\n## Steps\n\n| # | Step | Skill | Produces | Requires | Agents |\n|---|------|-------|----------|----------|--------|\n| 1 | **Design Gate** | `steps/design/README.md` | `design-decisions.md` | — | Researcher-Alpha/Beta/Gamma/Delta |\n| 2 | **Assessment** | `steps/assess/README.md` | `assessment.md` | `design-decisions.md` | Explorer, Researcher-Alpha |\n| 3 | **Implementation** | `steps/implement/README.md` | `progress.md` | `assessment.md` | Implementer, Frontend |\n| 4 | **Verification** | `steps/verify/README.md` | `verify-report.md` | `progress.md` | Code-Reviewer-Alpha, Security |\n\n## How It Works\n\nEach step has a **README.md** file that contains the detailed instructions for the agent(s) executing that step. The Orchestrator reads the README.md via `flow_read_instruction` and delegates work accordingly.\n\n### Step 1: Design Gate\n- **Auto-skips** for bug fixes and refactors (produces a minimal `design-decisions.md` noting it was skipped)\n- For small features: runs quick brainstorming, FORGE classification, and optional decision protocol (see Orchestrator's inlined Multi-Model Decision Protocol for the full 3-phase process)\n- Read `steps/design/README.md` for the full decision tree\n\n### Step 2: Assessment\n- Explore the codebase to understand scope and impact\n- Use `search`, `scope_map`, `file_summary`, `compact` to gather context\n- Identify the approach and produce `assessment.md`\n\n### Step 3: Implementation\n- Write code following the assessment plan\n- The Orchestrator dispatches Implementer/Frontend agents with specific file scopes\n- Follow TDD practices where applicable\n\n### Step 4: Verification\n- Code review, test execution, security check\n- Run `check({})` + `test_run({})` + `blast_radius({})`\n- Produce `verify-report.md` with findings\n\n## Using Skills Inside Steps\n\nWhen the Orchestrator activates a step:\n\n1. **Read the instruction first** — `flow_read_instruction` returns the README.md for the current step\n2. **Follow step instructions** — the README.md is the primary guide for what to do\n3. **Delegate to listed agents** — each step lists which agents are appropriate\n4. **Produce the required artifact** — the step's `produces` field specifies what file to create in the artifacts directory\n5. **Check dependencies** — the step's `requires` field lists artifacts from previous steps that must exist\n6. **Report status** — agents report `DONE` | `DONE_WITH_CONCERNS` | `NEEDS_CONTEXT` | `BLOCKED` to the Orchestrator\n\n## Artifacts\n\nAll artifacts are stored in the run directory under `.flows/{topic}/`. The template variable `{{artifacts_path}}` resolves to the actual path at runtime.\n"},{file:`steps/assess/README.md`,content:`---
 name: assess
 description: Understand scope, analyze the codebase, and identify the implementation approach.
@@ -1056,13 +1056,13 @@ Load these skills BEFORE executing this step:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Codebase discoveries**: File locations, architecture patterns, or dependency relationships found during assessment
 - **Problem diagnosis**: Root cause analysis, contributing factors, and affected components
 - **Scope decisions**: What's in scope, what's explicitly excluded, and why
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/design/README.md`,content:`# Design Gate — Basic Flow
 
 Lightweight design gate for bug fixes, small features, and refactoring. Evaluates the task type and determines whether design work is needed before proceeding.
@@ -1174,13 +1174,13 @@ Load these skills BEFORE executing this step:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Design decisions**: Chosen approach and alternatives considered with trade-offs
 - **Architecture patterns**: New patterns introduced or existing patterns that must be followed
 - **Constraints discovered**: Technical limitations, compatibility requirements, or performance boundaries
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/implement/README.md`,content:`---
 name: implement
 description: Write code following the assessment plan, using TDD practices where applicable.
@@ -1305,13 +1305,13 @@ Follow the \`multi-agents-development\` skill patterns for dispatch:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Implementation decisions**: Why specific approaches were chosen over alternatives
 - **Patterns established**: New conventions or patterns that future code should follow
 - **Gotchas encountered**: Edge cases, workarounds, or non-obvious behaviors discovered during implementation
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `},{file:`steps/verify/README.md`,content:`---
 name: verify
 description: Review code changes, run tests, validate correctness and quality.
@@ -1428,11 +1428,11 @@ After all reviews complete:
 
 ## Knowledge Capture
 
-Before completing this step, persist important findings using \`remember()\`:
+Before completing this step, persist important findings using \`knowledge({ action: "remember", ... })\`:
 
 - **Test coverage gaps**: Areas that couldn't be fully tested and why
 - **Quality findings**: Issues found during verification and their resolutions
 - **Session checkpoint**: Summarize what was accomplished, decisions made, and any remaining work
 
-**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`remember()\` now.
+**Every step produces knowledge worth preserving.** If you discovered something that would help a future session, call \`knowledge({ action: "remember", ... })\` now.
 `}]};export{e as FLOWS};

package/scaffold/dist/definitions/hooks.mjs

@@ -1 +1 @@
-const e={sessionStart:{description:`Run at the start of every agent session`,actions:[`status({})`,`list()`,`search({ query: "SESSION CHECKPOINT", origin: "curated" })`],rationale:`Resume prior work, load existing knowledge`},sessionEnd:{description:`Run at the end of every agent session`,actions:[`remember({ title: "Session checkpoint: <topic>", content: "<decisions, next steps>", category: "conventions" })`],rationale:`Persist decisions for future sessions`},beforeCodeChange:{description:`Run before modifying any code`,actions:[`search({ query: "<what you are changing>" })`,`scope_map({ task: "<description>" })`],rationale:`Check for prior decisions and understand impact`},beforeCommit:{description:`Run before committing changes`,actions:[`check({})`,`test_run({})`,`blast_radius({ changed_files: ["..."] })`],rationale:`Validate changes before they enter version control`}};export{e as HOOKS};
+const e={sessionStart:{description:`Run at the start of every agent session`,actions:[`status({})`,`knowledge({ action: "list" })`,`search({ query: "SESSION CHECKPOINT", origin: "curated" })`],rationale:`Resume prior work, load existing knowledge`},sessionEnd:{description:`Run at the end of every agent session`,actions:[`knowledge({ action: "remember", title: "Session checkpoint: <topic>", content: "<decisions, next steps>", category: "conventions" })`],rationale:`Persist decisions for future sessions`},beforeCodeChange:{description:`Run before modifying any code`,actions:[`search({ query: "<what you are changing>" })`,`scope_map({ task: "<description>" })`],rationale:`Check for prior decisions and understand impact`},beforeCommit:{description:`Run before committing changes`,actions:[`check({})`,`test_run({})`,`blast_radius({ changed_files: ["..."] })`],rationale:`Validate changes before they enter version control`}};export{e as HOOKS};

package/scaffold/dist/definitions/prompts.mjs

@@ -1,11 +1,11 @@
-const e={ask:{description:`Quick research question — find answer using AI Kit + web search`,agent:`Researcher-Alpha`,tools:[`search`,`web_search`,`web_fetch`,`compact`,`file_summary`,`remember`,`present`],content:`## Quick Research
+const e={ask:{description:`Quick research question — find answer using AI Kit + web search`,agent:`Researcher-Alpha`,tools:[`search`,`web_search`,`web_fetch`,`compact`,`file_summary`,`knowledge`,`present`],content:`## Quick Research
 
-1. **AI Kit Recall** — Search knowledge base for existing answers
+1. **AI Kit Recall** — Search the AI Kit index for existing answers
 2. **Web Search** — If AI Kit has no relevant results, search the web
 3. **Synthesize** — Combine findings into a clear, concise answer
-4. **Remember** — If the answer is broadly useful, persist it to KB
+4. **Remember** — If the answer is broadly useful, persist it with \`knowledge({ action: "remember", ... })\`
 
-**Always cite sources** — AI Kit entries, file paths, or URLs.`},debug:{description:`Systematic error diagnosis: reproduce → trace → diagnose → fix → verify`,agent:`Debugger`,tools:[`search`,`symbol`,`trace`,`blast_radius`,`check`,`test_run`,`parse_output`,`compact`,`remember`,`present`],content:"## Debug Workflow\n\n1. **Parse Error** — Use `parse_output` on the error message/stack trace\n2. **AI Kit Recall** — Search for known issues matching this pattern\n3. **Reproduce** — Run the failing command/test to confirm\n4. **Trace** — Use `symbol` and `trace` to follow the call chain\n5. **Diagnose** — Form hypothesis, gather evidence\n6. **Fix** — Implement minimal fix\n7. **Verify** — `check` + `test_run` to confirm fix and no regressions\n8. **Remember** — Persist the fix with category `troubleshooting`"},implement:{description:`Full lifecycle implementation: plan → build → review → commit`,agent:`Orchestrator`,tools:[`search`,`scope_map`,`forge_ground`,`check`,`test_run`,`blast_radius`,`remember`,`audit`,`present`],content:`## Implementation Pipeline
+**Always cite sources** — AI Kit entries, file paths, or URLs.`},debug:{description:`Systematic error diagnosis: reproduce → trace → diagnose → fix → verify`,agent:`Debugger`,tools:[`search`,`symbol`,`trace`,`blast_radius`,`check`,`test_run`,`parse_output`,`compact`,`knowledge`,`present`],content:'## Debug Workflow\n\n1. **Parse Error** — Use `parse_output` on the error message/stack trace\n2. **AI Kit Recall** — Search for known issues matching this pattern\n3. **Reproduce** — Run the failing command/test to confirm\n4. **Trace** — Use `symbol` and `trace` to follow the call chain\n5. **Diagnose** — Form hypothesis, gather evidence\n6. **Fix** — Implement minimal fix\n7. **Verify** — `check` + `test_run` to confirm fix and no regressions\n8. **Remember** — Persist the fix with `knowledge({ action: "remember", category: "troubleshooting", ... })`'},implement:{description:`Full lifecycle implementation: plan → build → review → commit`,agent:`Orchestrator`,tools:[`search`,`scope_map`,`forge_ground`,`check`,`test_run`,`blast_radius`,`knowledge`,`audit`,`present`],content:`## Implementation Pipeline
 
 Follow the Orchestrator's full workflow:
 
@@ -16,7 +16,7 @@ Follow the Orchestrator's full workflow:
 
 **🛑 MANDATORY STOPS** — After plan, after each batch, after completion.
 
-Refer to the Orchestrator agent's full instructions for the detailed workflow.`},plan:{description:`Create a detailed TDD implementation plan without executing it`,agent:`Planner`,tools:[`search`,`scope_map`,`forge_ground`,`forge_classify`,`file_summary`,`analyze_structure`,`analyze_dependencies`,`remember`,`present`],content:`## Planning Workflow
+Refer to the Orchestrator agent's full instructions for the detailed workflow.`},plan:{description:`Create a detailed TDD implementation plan without executing it`,agent:`Planner`,tools:[`search`,`scope_map`,`forge_ground`,`forge_classify`,`file_summary`,`analyze`,`knowledge`,`present`],content:`## Planning Workflow
 
 1. **AI Kit Recall** — Search for past plans, architecture decisions
 2. **FORGE Ground** — Classify tier, scope map, seed unknowns
@@ -25,7 +25,7 @@ Refer to the Orchestrator agent's full instructions for the detailed workflow.`}
 5. **Dependency Graph** — Group into parallel batches
 6. **Present** — Show plan with open questions
 
-**🛑 MANDATORY STOP** — Wait for user approval. Do NOT implement.`},design:{description:`Collaborative design session — explore ideas, refine requirements, produce a design spec`,agent:`Orchestrator`,tools:[`search`,`scope_map`,`file_summary`,`compact`,`remember`,`forge_classify`,`present`],content:`## Design Session
+**🛑 MANDATORY STOP** — Wait for user approval. Do NOT implement.`},design:{description:`Collaborative design session — explore ideas, refine requirements, produce a design spec`,agent:`Orchestrator`,tools:[`search`,`scope_map`,`file_summary`,`compact`,`knowledge`,`forge_classify`,`present`],content:`## Design Session
 
 Enter Phase 0 (Design Gate) directly — the user is requesting a design session.
 
@@ -34,7 +34,7 @@ Enter Phase 0 (Design Gate) directly — the user is requesting a design session
 3. If Advanced Mode, use the full Multi-Model Decision Protocol (3-phase: research → peer review → verdict, defined in Orchestrator instructions) for unresolved technical choices
 4. Terminal state: brainstorming skill invokes writing-plans skill
 
-**🛑 HARD GATE** — Do NOT skip brainstorming. Do NOT write code. Design first.`},review:{description:`Dual-model code + architecture review pipeline`,agent:`Orchestrator`,tools:[`search`,`blast_radius`,`check`,`test_run`,`analyze_dependencies`,`remember`,`present`],content:`## Review Pipeline
+**🛑 HARD GATE** — Do NOT skip brainstorming. Do NOT write code. Design first.`},review:{description:`Dual-model code + architecture review pipeline`,agent:`Orchestrator`,tools:[`search`,`blast_radius`,`check`,`test_run`,`analyze`,`knowledge`,`present`],content:`## Review Pipeline
 
 ### Step 1: Scope
 Identify changed files and their blast radius.

package/scaffold/dist/definitions/protocols.mjs

@@ -99,15 +99,15 @@ Past decisions, conventions, and patterns are stored in curated knowledge. Auto-
 
 \`\`\`
 search("keywords about the feature/area you're changing")  // check for past decisions
-list({ category: "decisions" })   // scan recent decisions that might apply
-list({ category: "conventions" }) // see project conventions (includes auto-captured)
+knowledge({ action: "list", category: "decisions" })   // scan recent decisions that might apply
+knowledge({ action: "list", category: "conventions" }) // see project conventions (includes auto-captured)
 scope_map("what you need")        // generates a reading plan
 \`\`\`
 
 **Rules:**
 - If results exist → **READ them and FOLLOW** established patterns. Do not silently override.
 - If results conflict with the current task → **surface the conflict** to the user/orchestrator.
-- If no results → proceed, but **\`remember()\` your decisions** afterward for future recall.
+- If no results → proceed, but **persist your decisions with \`knowledge({ action: "remember", ... })\`** afterward for future recall.
 - Never assume "there's nothing stored" — always search first.
 
 ### Step 3: Real-time Exploration (only
@@ -199,7 +199,7 @@ Before making changes, establish expected scope. Flag deviations early.
 
 ## MANDATORY: Memory Persistence Before Completing
 
-**Before finishing ANY task**, you MUST call \`remember()\` if ANY of these apply:
+**Before finishing ANY task**, you MUST call \`knowledge({ action: "remember", ... })\` if ANY of these apply:
 
 - ✅ You discovered how something works that wasn't in onboard artifacts
 - ✅ You made an architecture or design decision
@@ -207,9 +207,10 @@ Before making changes, establish expected scope. Flag deviations early.
 - ✅ You identified a pattern, convention, or project-specific gotcha
 - ✅ You encountered and resolved an error that others might hit
 
-**How to remember:**
+**How to persist knowledge:**
 \`\`\`
-remember({
+knowledge({
+  action: "remember",
   title: "Short descriptive title",
   content: "Detailed finding with context",
   category: "patterns" | "conventions" | "decisions" | "troubleshooting"
@@ -217,13 +218,13 @@ remember({
 \`\`\`
 
 **Examples:**
-- \`remember({ title: "Auth uses JWT refresh tokens with 15min expiry", content: "Access tokens expire in 15 min, refresh in 7 days. Middleware at src/auth/guard.ts validates.", category: "patterns" })\`
-- \`remember({ title: "Build requires Node 20+", content: "Uses Web Crypto API — Node 18 fails silently on crypto.subtle calls.", category: "conventions" })\`
-- \`remember({ title: "Decision: LanceDB over Chroma for vector store", content: "LanceDB is embedded (no Docker), supports WASM, better for user-level MCP.", category: "decisions" })\`
+- \`knowledge({ action: "remember", title: "Auth uses JWT refresh tokens with 15min expiry", content: "Access tokens expire in 15 min, refresh in 7 days. Middleware at src/auth/guard.ts validates.", category: "patterns" })\`
+- \`knowledge({ action: "remember", title: "Build requires Node 20+", content: "Uses Web Crypto API — Node 18 fails silently on crypto.subtle calls.", category: "conventions" })\`
+- \`knowledge({ action: "remember", title: "Decision: LanceDB over Chroma for vector store", content: "LanceDB is embedded (no Docker), supports WASM, better for user-level MCP.", category: "decisions" })\`
 
 **If you complete a task without remembering anything, you likely missed something.** Review what you learned.
 
-For outdated AI Kit entries → \`update(path, content, reason)\`
+For outdated AI Kit entries → \`knowledge({ action: "update", path, content, reason })\`
 
 ---
 
@@ -239,14 +240,14 @@ For outdated AI Kit entries → \`update(path, content, reason)\`
 
 | Phase | What to do | Compress after? |
 |-------|-----------|----------------|
-| **Understand** | Search KB, read summaries, trace symbols | Yes — \`digest\` findings before planning |
+| **Understand** | Search AI Kit, read summaries, trace symbols | Yes — \`digest\` findings before planning |
 | **Plan** | Design approach, identify files to change | Yes — \`stash\` the plan, compact analysis |
 | **Execute** | Make changes, one sub-task at a time | Yes — compact between independent sub-tasks |
 | **Verify** | \`check\` + \`test_run\` + \`blast_radius\` | — |
 
 **Rules:**
 - **Never compact mid-operation** — finish the current sub-task first
-- **Recycle context to files** — save analysis results via \`stash\` or \`remember\`, not just in conversation
+- **Recycle context to files** — save analysis results via \`stash\` or \`knowledge({ action: "remember", ... })\`, not just in conversation
 - **Decompose monolithic work** — break into independent chunks, pass results via artifact files between sub-tasks
 - **One-shot sub-tasks** — for self-contained changes, provide all context upfront to avoid back-and-forth
 
@@ -435,7 +436,7 @@ scope_map("what you need to investigate")
 for code exploration (graph FIRST for module relationships)
 - Use \`graph({ action: 'neighbors' })\` to understand cross-module dependencies before diving into symbol details
 - Use \`file_summary\`, \`compact\` for efficient file reading
-- Use \`analyze_structure\`, \`analyze_dependencies\` for package-level understanding
+- Use \`analyze({ aspect: "structure", ... })\`, \`analyze({ aspect: "dependencies", ... })\` for package-level understanding
 - Use \`web_search\`, \`web_fetch\` for external documentation
 
 ### Phase 3: Synthesis
@@ -454,21 +455,22 @@ Return structured findings. Always include:
 
 ### Phase 5: MANDATORY — Persist Discoveries
 
-**Before returning your report**, you MUST call \`remember()\` for:
+**Before returning your report**, you MUST call \`knowledge({ action: "remember", ... })\` for:
 - ✅ Architecture insights not already in onboard artifacts
 - ✅ Non-obvious findings, gotchas, or edge cases
 - ✅ Trade-off analysis and recommendations made
 - ✅ External knowledge gathered from web_search/web_fetch
 
 \`\`\`
-remember({
+knowledge({
+  action: "remember",
   title: "Short descriptive title",
   content: "Detailed finding with context",
   category: "patterns" | "conventions" | "decisions" | "troubleshooting"
 })
 \`\`\`
 
-**If you complete research without remembering anything, you wasted tokens.** Your research should enrich the knowledge base for future sessions.
+**If you complete research without persisting anything, you wasted tokens.** Your research should enrich the AI Kit knowledge store for future sessions.
 
 ---
 
@@ -561,7 +563,7 @@ Workflow;
 1 ** AI;
 Kit;
 Recall** —
-\`search("conventions relevant-area")\` + \`list()\`
+\`search("conventions relevant-area")\` + \`knowledge({ action: "list" })\`
 for past review findings, patterns
 2. **Blast
 Radius** —
@@ -572,8 +574,9 @@ Radius** —
 6. **Report** — Structured findings
 with verdict
 7. **Persist** —
-\`remember(
+\`knowledge(
 {
+  action: "remember",
   title: 'Review: <finding>', content;
   : "<details>", category: "patterns"
 }
@@ -736,16 +739,17 @@ Workflow;
 1 ** AI;
 Kit;
 Recall** —
-\`search("architecture decisions boundaries")\` + \`list()\`
+\`search("architecture decisions boundaries")\` + \`knowledge({ action: "list" })\`
 for past ADRs, patterns
 2. **Analyze** —
-\`analyze_structure\`, \`analyze_dependencies\`, \`blast_radius\`
+\`analyze({ aspect: "structure", ... })\`, \`analyze({ aspect: "dependencies", ... })\`, \`blast_radius\`
 3. **Evaluate** — Check all dimensions below
 4. **Report** — Structured findings
 with verdict
 5. **Persist** —
-\`remember(
+\`knowledge(
 {
+  action: "remember",
   title: 'Architecture: <finding>', content;
   : "<details>", category: "decisions"
 }
@@ -971,7 +975,7 @@ The Orchestrator synthesizes BOTH layers (original research + peer reviews) into
 Then:
 1. **Present** the verdict using \`present(format: "html" )\` with comparison blocks
 2. **Produce an ADR** via the \`adr-skill\`
-3. **\`remember\`** the decision for future recall
+3. **\`knowledge({ action: "remember", ... })\`** the decision for future recall
 
 ## When to Use (Auto-Trigger Rules)
 
@@ -993,14 +997,14 @@ Trigger the decision protocol when there is an **unresolved non-trivial technica
 - Never make a non-trivial technical decision without multi-model analysis
 - Always present the verdict visually using \`present\`
 - **Produce an ADR** after every decision resolution
-- \`remember\` the decision for future recall
+- \`knowledge({ action: "remember", ... })\` the decision for future recall
 
 ## Shortcut: Floor-Tier Decisions
 
 For decisions classified as **Floor tier** (blast_radius ≤ 2, single concern):
 - Skip Phase 2 (peer review) — synthesis directly from Phase 1
 - Verdict format still required but can be abbreviated
-- ADR is optional (use \`remember\` at minimum)
+- ADR is optional (use \`knowledge({ action: "remember", ... })\` at minimum)
 `,"forge-protocol":`# FORGE Protocol — Quality Overlay
 
 > Follow the FORGE (Fact-Oriented Reasoning with Graduated Evidence) protocol for all code generation and modification tasks.