@agents-inc/cli 0.82.4 → 0.84.0

package/dist/components/wizard/step-sources.test.js

@@ -11,9 +11,9 @@ import {
 } from "../../chunk-66UDJBF6.js";
 import {
   WEB_PAIR_MATRIX
-} from "../../chunk-3BDCU5QB.js";
-import "../../chunk-AD2UT2TN.js";
-import "../../chunk-IMO6EQKT.js";
+} from "../../chunk-ZYTLL3MM.js";
+import "../../chunk-AZLM7OCV.js";
+import "../../chunk-DFFH7HQZ.js";
 import {
   afterEach,
   beforeEach,
@@ -24,11 +24,11 @@ import {
 } from "../../chunk-XY3XDVMI.js";
 import {
   StepSources
-} from "../../chunk-3PB7KSF7.js";
+} from "../../chunk-2AHXUWHO.js";
 import "../../chunk-V36FRPAU.js";
 import "../../chunk-K77I4XGL.js";
 import "../../chunk-6XEZLWG5.js";
-import "../../chunk-5BRHJD7Q.js";
+import "../../chunk-23UI23AW.js";
 import "../../chunk-7SOPVGDV.js";
 import "../../chunk-SB2R5KHJ.js";
 import "../../chunk-P2FHS5IS.js";
@@ -37,17 +37,17 @@ import "../../chunk-XO6X5QE5.js";
 import "../../chunk-KUV24B5M.js";
 import {
   useWizardStore
-} from "../../chunk-LQ3EJBUN.js";
+} from "../../chunk-KJX5G75S.js";
 import "../../chunk-HK53FRMU.js";
-import "../../chunk-KB6LCTCD.js";
-import "../../chunk-XTVWVOLD.js";
+import "../../chunk-PTKJKDYH.js";
+import "../../chunk-XAVVPPWP.js";
 import {
   initializeMatrix
-} from "../../chunk-3MXMYHO3.js";
-import "../../chunk-32HQMUEJ.js";
-import "../../chunk-WYHFSJ7O.js";
+} from "../../chunk-HQNFKBZW.js";
+import "../../chunk-2BF4WAYU.js";
+import "../../chunk-2XLBC3W6.js";
 import "../../chunk-6PGL2XMY.js";
-import "../../chunk-IMP35ETG.js";
+import "../../chunk-NPMMU4GY.js";
 import {
   init_esm_shims
 } from "../../chunk-DHET7RCE.js";

package/dist/components/wizard/step-stack.js

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 import {
   StepStack
-} from "../../chunk-63E7LOLB.js";
-import "../../chunk-K76AXQ7A.js";
+} from "../../chunk-3JTBSJDE.js";
+import "../../chunk-LI5NJ4VQ.js";
 import "../../chunk-K77I4XGL.js";
 import "../../chunk-4QA5TIBU.js";
 import "../../chunk-WJXWYSBT.js";
-import "../../chunk-LQ3EJBUN.js";
-import "../../chunk-KB6LCTCD.js";
-import "../../chunk-XTVWVOLD.js";
-import "../../chunk-3MXMYHO3.js";
-import "../../chunk-32HQMUEJ.js";
-import "../../chunk-WYHFSJ7O.js";
+import "../../chunk-KJX5G75S.js";
+import "../../chunk-PTKJKDYH.js";
+import "../../chunk-XAVVPPWP.js";
+import "../../chunk-HQNFKBZW.js";
+import "../../chunk-2BF4WAYU.js";
+import "../../chunk-2XLBC3W6.js";
 import "../../chunk-6PGL2XMY.js";
-import "../../chunk-IMP35ETG.js";
+import "../../chunk-NPMMU4GY.js";
 import "../../chunk-DHET7RCE.js";
 export {
   StepStack

package/dist/components/wizard/step-stack.test.js

@@ -16,7 +16,7 @@ import {
   TEST_CATEGORIES,
   createMockMatrix,
   createMockResolvedStack
-} from "../../chunk-IMO6EQKT.js";
+} from "../../chunk-DFFH7HQZ.js";
 import {
   afterEach,
   beforeEach,
@@ -27,23 +27,23 @@ import {
 } from "../../chunk-XY3XDVMI.js";
 import {
   StepStack
-} from "../../chunk-63E7LOLB.js";
-import "../../chunk-K76AXQ7A.js";
+} from "../../chunk-3JTBSJDE.js";
+import "../../chunk-LI5NJ4VQ.js";
 import "../../chunk-K77I4XGL.js";
 import "../../chunk-4QA5TIBU.js";
 import "../../chunk-WJXWYSBT.js";
 import {
   useWizardStore
-} from "../../chunk-LQ3EJBUN.js";
-import "../../chunk-KB6LCTCD.js";
-import "../../chunk-XTVWVOLD.js";
+} from "../../chunk-KJX5G75S.js";
+import "../../chunk-PTKJKDYH.js";
+import "../../chunk-XAVVPPWP.js";
 import {
   initializeMatrix
-} from "../../chunk-3MXMYHO3.js";
-import "../../chunk-32HQMUEJ.js";
-import "../../chunk-WYHFSJ7O.js";
+} from "../../chunk-HQNFKBZW.js";
+import "../../chunk-2BF4WAYU.js";
+import "../../chunk-2XLBC3W6.js";
 import "../../chunk-6PGL2XMY.js";
-import "../../chunk-IMP35ETG.js";
+import "../../chunk-NPMMU4GY.js";
 import {
   init_esm_shims
 } from "../../chunk-DHET7RCE.js";

package/dist/components/wizard/wizard-layout.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   WizardLayout
-} from "../../chunk-LOB3OU2D.js";
+} from "../../chunk-IG5B34MJ.js";
 import "../../chunk-YVFGISUO.js";
 import "../../chunk-V36FRPAU.js";
-import "../../chunk-FS4YWW36.js";
-import "../../chunk-AAW3PYXA.js";
-import "../../chunk-LQ3EJBUN.js";
+import "../../chunk-ND4ZJOT7.js";
+import "../../chunk-TE4LD3WR.js";
+import "../../chunk-KJX5G75S.js";
 import "../../chunk-HK53FRMU.js";
-import "../../chunk-KB6LCTCD.js";
-import "../../chunk-XTVWVOLD.js";
-import "../../chunk-3MXMYHO3.js";
-import "../../chunk-32HQMUEJ.js";
-import "../../chunk-WYHFSJ7O.js";
+import "../../chunk-PTKJKDYH.js";
+import "../../chunk-XAVVPPWP.js";
+import "../../chunk-HQNFKBZW.js";
+import "../../chunk-2BF4WAYU.js";
+import "../../chunk-2XLBC3W6.js";
 import "../../chunk-6PGL2XMY.js";
-import "../../chunk-IMP35ETG.js";
+import "../../chunk-NPMMU4GY.js";
 import "../../chunk-DHET7RCE.js";
 export {
   WizardLayout

package/dist/components/wizard/wizard.js

@@ -1,44 +1,44 @@
 #!/usr/bin/env node
 import {
   Wizard
-} from "../../chunk-JQDOUNHF.js";
-import "../../chunk-LOB3OU2D.js";
+} from "../../chunk-XCRX5WVX.js";
+import "../../chunk-IG5B34MJ.js";
 import "../../chunk-YVFGISUO.js";
-import "../../chunk-5AHKXBNC.js";
-import "../../chunk-3PB7KSF7.js";
+import "../../chunk-DGZ7HWIG.js";
+import "../../chunk-2AHXUWHO.js";
 import "../../chunk-V36FRPAU.js";
-import "../../chunk-63E7LOLB.js";
-import "../../chunk-K76AXQ7A.js";
-import "../../chunk-35ESNSF5.js";
-import "../../chunk-M2CS5EOK.js";
+import "../../chunk-3JTBSJDE.js";
+import "../../chunk-LI5NJ4VQ.js";
+import "../../chunk-LVIMGRFS.js";
+import "../../chunk-3PECYFYB.js";
 import "../../chunk-FQTYF3OU.js";
 import "../../chunk-K77I4XGL.js";
-import "../../chunk-C4I4Q33M.js";
+import "../../chunk-4IAGARTF.js";
 import "../../chunk-6XEZLWG5.js";
-import "../../chunk-5BRHJD7Q.js";
+import "../../chunk-23UI23AW.js";
 import "../../chunk-7SOPVGDV.js";
 import "../../chunk-SB2R5KHJ.js";
-import "../../chunk-GEU62YD2.js";
+import "../../chunk-J7VVUJ6I.js";
 import "../../chunk-P2FHS5IS.js";
-import "../../chunk-RTXJLZ7A.js";
-import "../../chunk-FS4YWW36.js";
+import "../../chunk-2EPX6D74.js";
+import "../../chunk-ND4ZJOT7.js";
 import "../../chunk-HSKKGAOW.js";
 import "../../chunk-4QA5TIBU.js";
 import "../../chunk-WJXWYSBT.js";
-import "../../chunk-AAW3PYXA.js";
+import "../../chunk-TE4LD3WR.js";
 import "../../chunk-XO6X5QE5.js";
 import "../../chunk-KUV24B5M.js";
-import "../../chunk-LQ3EJBUN.js";
+import "../../chunk-KJX5G75S.js";
 import "../../chunk-HEQVUIHQ.js";
 import "../../chunk-U3IGFMCY.js";
 import "../../chunk-HK53FRMU.js";
-import "../../chunk-KB6LCTCD.js";
-import "../../chunk-XTVWVOLD.js";
-import "../../chunk-3MXMYHO3.js";
-import "../../chunk-32HQMUEJ.js";
-import "../../chunk-WYHFSJ7O.js";
+import "../../chunk-PTKJKDYH.js";
+import "../../chunk-XAVVPPWP.js";
+import "../../chunk-HQNFKBZW.js";
+import "../../chunk-2BF4WAYU.js";
+import "../../chunk-2XLBC3W6.js";
 import "../../chunk-6PGL2XMY.js";
-import "../../chunk-IMP35ETG.js";
+import "../../chunk-NPMMU4GY.js";
 import "../../chunk-DHET7RCE.js";
 export {
   Wizard

package/dist/config-exports.js

@@ -4,7 +4,7 @@ import {
   defaultRules,
   defaultStacks,
   defineConfig
-} from "./chunk-IMP35ETG.js";
+} from "./chunk-NPMMU4GY.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";

package/dist/hooks/init.js

@@ -1,35 +1,35 @@
 #!/usr/bin/env node
 import {
   showDashboard
-} from "../chunk-FBLRTXEA.js";
-import "../chunk-JQDOUNHF.js";
-import "../chunk-LOB3OU2D.js";
+} from "../chunk-33AA7KWH.js";
+import "../chunk-XCRX5WVX.js";
+import "../chunk-IG5B34MJ.js";
 import "../chunk-YVFGISUO.js";
-import "../chunk-5AHKXBNC.js";
-import "../chunk-3PB7KSF7.js";
+import "../chunk-DGZ7HWIG.js";
+import "../chunk-2AHXUWHO.js";
 import "../chunk-V36FRPAU.js";
-import "../chunk-63E7LOLB.js";
-import "../chunk-K76AXQ7A.js";
-import "../chunk-35ESNSF5.js";
-import "../chunk-M2CS5EOK.js";
+import "../chunk-3JTBSJDE.js";
+import "../chunk-LI5NJ4VQ.js";
+import "../chunk-LVIMGRFS.js";
+import "../chunk-3PECYFYB.js";
 import "../chunk-FQTYF3OU.js";
 import "../chunk-K77I4XGL.js";
-import "../chunk-C4I4Q33M.js";
+import "../chunk-4IAGARTF.js";
 import "../chunk-6XEZLWG5.js";
-import "../chunk-5BRHJD7Q.js";
+import "../chunk-23UI23AW.js";
 import "../chunk-7SOPVGDV.js";
 import "../chunk-SB2R5KHJ.js";
-import "../chunk-GEU62YD2.js";
+import "../chunk-J7VVUJ6I.js";
 import "../chunk-P2FHS5IS.js";
-import "../chunk-RTXJLZ7A.js";
-import "../chunk-FS4YWW36.js";
+import "../chunk-2EPX6D74.js";
+import "../chunk-ND4ZJOT7.js";
 import "../chunk-HSKKGAOW.js";
 import "../chunk-4QA5TIBU.js";
 import "../chunk-WJXWYSBT.js";
-import "../chunk-AAW3PYXA.js";
+import "../chunk-TE4LD3WR.js";
 import "../chunk-XO6X5QE5.js";
 import "../chunk-KUV24B5M.js";
-import "../chunk-LQ3EJBUN.js";
+import "../chunk-KJX5G75S.js";
 import "../chunk-HEQVUIHQ.js";
 import "../chunk-U3IGFMCY.js";
 import "../chunk-HK53FRMU.js";
@@ -37,16 +37,16 @@ import "../chunk-B7KZLXHV.js";
 import {
   detectInstallation,
   resolveSource
-} from "../chunk-KB6LCTCD.js";
-import "../chunk-XTVWVOLD.js";
-import "../chunk-3MXMYHO3.js";
+} from "../chunk-PTKJKDYH.js";
+import "../chunk-XAVVPPWP.js";
+import "../chunk-HQNFKBZW.js";
 import {
   EXIT_CODES
-} from "../chunk-X2HE3W74.js";
-import "../chunk-32HQMUEJ.js";
-import "../chunk-WYHFSJ7O.js";
+} from "../chunk-SD3HTFUK.js";
+import "../chunk-2BF4WAYU.js";
+import "../chunk-2XLBC3W6.js";
 import "../chunk-6PGL2XMY.js";
-import "../chunk-IMP35ETG.js";
+import "../chunk-NPMMU4GY.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";

package/dist/{loader-4XPDVCZK.js → loader-LI4IFZB7.js}

@@ -5,9 +5,9 @@ import {
   loadProjectAgents,
   loadSkillsByIds,
   parseFrontmatter
-} from "./chunk-XTVWVOLD.js";
-import "./chunk-32HQMUEJ.js";
-import "./chunk-WYHFSJ7O.js";
+} from "./chunk-XAVVPPWP.js";
+import "./chunk-2BF4WAYU.js";
+import "./chunk-2XLBC3W6.js";
 import "./chunk-6PGL2XMY.js";
 import "./chunk-DHET7RCE.js";
 export {
@@ -17,4 +17,4 @@ export {
   loadSkillsByIds,
   parseFrontmatter
 };
-//# sourceMappingURL=loader-4XPDVCZK.js.map
+//# sourceMappingURL=loader-LI4IFZB7.js.map

package/dist/{source-loader-FMDHHYDQ.js → source-loader-GHDWSV2H.js}

@@ -4,13 +4,13 @@ import {
   extractSourceName,
   loadSkillsMatrixFromSource,
   mergeLocalSkillsIntoMatrix
-} from "./chunk-KB6LCTCD.js";
-import "./chunk-XTVWVOLD.js";
-import "./chunk-3MXMYHO3.js";
-import "./chunk-32HQMUEJ.js";
-import "./chunk-WYHFSJ7O.js";
+} from "./chunk-PTKJKDYH.js";
+import "./chunk-XAVVPPWP.js";
+import "./chunk-HQNFKBZW.js";
+import "./chunk-2BF4WAYU.js";
+import "./chunk-2XLBC3W6.js";
 import "./chunk-6PGL2XMY.js";
-import "./chunk-IMP35ETG.js";
+import "./chunk-NPMMU4GY.js";
 import "./chunk-DHET7RCE.js";
 export {
   convertStackToResolvedStack,
@@ -18,4 +18,4 @@ export {
   loadSkillsMatrixFromSource,
   mergeLocalSkillsIntoMatrix
 };
-//# sourceMappingURL=source-loader-FMDHHYDQ.js.map
+//# sourceMappingURL=source-loader-GHDWSV2H.js.map

package/dist/source-manager-7RTGIBQK.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import {
+  addSource,
+  getSourceSummary,
+  removeSource
+} from "./chunk-PTKJKDYH.js";
+import "./chunk-XAVVPPWP.js";
+import "./chunk-HQNFKBZW.js";
+import "./chunk-2BF4WAYU.js";
+import "./chunk-2XLBC3W6.js";
+import "./chunk-6PGL2XMY.js";
+import "./chunk-NPMMU4GY.js";
+import "./chunk-DHET7RCE.js";
+export {
+  addSource,
+  getSourceSummary,
+  removeSource
+};
+//# sourceMappingURL=source-manager-7RTGIBQK.js.map

package/dist/src/agents/meta/agent-summoner/workflow.md

@@ -436,7 +436,7 @@ Boundaries:
 - `researcher/` - Read-only research agents (web-researcher, api-researcher)
 - `planning/` - Planning agents (web-pm)
 - `pattern/` - Pattern discovery agents (pattern-scout, web-pattern-critique)
-- `meta/` - Meta-level agents (agent-summoner, skill-summoner, scribe, convention-keeper)
+- `meta/` - Meta-level agents (agent-summoner, skill-summoner, codex-keeper, convention-keeper)
 - `tester/` - Testing agents (web-tester, cli-tester)
 
 **Directory structure:**
@@ -1493,15 +1493,15 @@ Output formats are determined by the file system with cascading resolution:
 1. **Agent-level**: `src/agents/{category}/{agent-name}/output-format.md`
 2. **Category fallback**: `src/agents/{category}/output-format.md`
 
-| Category   | Example Agents                                            |
-| ---------- | --------------------------------------------------------- |
-| developer  | web-developer, api-developer, cli-developer               |
-| reviewer   | web-reviewer, api-reviewer, cli-reviewer                  |
-| researcher | web-researcher, api-researcher                            |
-| planning   | web-pm, web-architecture                                  |
-| tester     | web-tester, cli-tester                                    |
-| pattern    | pattern-scout, web-pattern-critique                       |
-| meta       | scribe, agent-summoner, skill-summoner, convention-keeper |
+| Category   | Example Agents                                                  |
+| ---------- | --------------------------------------------------------------- |
+| developer  | web-developer, api-developer, cli-developer                     |
+| reviewer   | web-reviewer, api-reviewer, cli-reviewer                        |
+| researcher | web-researcher, api-researcher                                  |
+| planning   | web-pm, web-architecture                                        |
+| tester     | web-tester, cli-tester                                          |
+| pattern    | pattern-scout, web-pattern-critique                             |
+| meta       | codex-keeper, agent-summoner, skill-summoner, convention-keeper |
 
 ---
 

package/{src/agents/meta/scribe → dist/src/agents/meta/codex-keeper}/intro.md

@@ -9,3 +9,5 @@ You work incrementally - building complete documentation over multiple sessions.
 - **Update Mode**: Refresh documentation when user requests updates or when validation detects drift
 
 **When documenting any area, be comprehensive and thorough. Include as many relevant file paths, patterns, and relationships as needed to create complete documentation.**
+
+**Scope boundary:** You handle `.ai-docs/reference/` -- descriptive docs about how systems work. The convention-keeper agent handles `.ai-docs/standards/` -- prescriptive rules for code quality and testing. Do not create or modify files in `standards/`.

package/dist/src/agents/meta/codex-keeper/metadata.yaml

@@ -0,0 +1,12 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/agents-inc/cli/main/src/schemas/agent.schema.json
+id: codex-keeper
+title: Codex Keeper Agent
+description: Creates AI-focused reference documentation (architecture, types, store maps, commands) that helps other agents understand where and how to implement features. Works incrementally, tracking progress over time.
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash

package/dist/src/agents/meta/{scribe → codex-keeper}/output-format.md

@@ -35,7 +35,7 @@ Provide your documentation output in this structure:
 
 ### [filename.md]
 
-**Location:** `/.claude/docs/[filename.md]`
+**Location:** `/.ai-docs/reference/[filename.md]`
 **Purpose:** [What this doc helps agents do]
 
 ```markdown
@@ -64,7 +64,7 @@ Provide your documentation output in this structure:
 
 ## Documentation Map Updates
 
-**File:** `/.claude/docs/DOCUMENTATION_MAP.md`
+**File:** `/.ai-docs/DOCUMENTATION_MAP.md`
 
 **Changes:**
 

package/dist/src/agents/meta/{scribe → codex-keeper}/workflow.md

@@ -53,7 +53,7 @@
 **BEFORE creating or validating ANY documentation:**
 
 1. **Understand the documentation map**
-   - Read `.claude/docs/DOCUMENTATION_MAP.md` if it exists
+   - Read `.ai-docs/DOCUMENTATION_MAP.md` if it exists
    - Identify what's documented vs undocumented
    - Check status of existing documentation
    - Determine your target area for this session
@@ -139,7 +139,7 @@ Only proceed when you have verified requirements are met.
 
 ```bash
 # Check if map exists
-if [ -f .claude/docs/DOCUMENTATION_MAP.md ]; then
+if [ -f .ai-docs/DOCUMENTATION_MAP.md ]; then
   # Read and assess
 else
   # Create new map
@@ -201,9 +201,9 @@ After generating documentation, add a reference to the project's CLAUDE.md so ot
 ```markdown
 ## Generated Documentation
 
-> AI-optimized documentation created by the scribe agent.
+> AI-optimized documentation created by the codex-keeper agent.
 
-- **Documentation Index:** `.claude/docs/DOCUMENTATION_MAP.md`
+- **Documentation Index:** `.ai-docs/DOCUMENTATION_MAP.md`
 - **Last Updated:** [current date]
 ```
 
@@ -831,7 +831,7 @@ EditorPage imports:
 
 ## Documentation Map Structure
 
-**File:** `.claude/docs/DOCUMENTATION_MAP.md`
+**File:** `.ai-docs/DOCUMENTATION_MAP.md`
 
 ```markdown
 # Documentation Map
@@ -849,17 +849,17 @@ EditorPage imports:
 - ⏳ Planned
 - ❌ Not started
 
-## Documentation Status
+## Reference Documentation
 
-| Area               | Status | File                    | Last Updated | Next Action         |
-| ------------------ | ------ | ----------------------- | ------------ | ------------------- |
-| Store/State Map    | ✅     | `store-map.md`          | 2025-01-24   | Validate in 7 days  |
-| Anti-Patterns      | 📝     | `anti-patterns.md`      | 2025-01-20   | Needs validation    |
-| Editor Feature     | ✅     | `features/editor.md`    | 2025-01-24   | None                |
-| Component Patterns | 📝     | `component-patterns.md` | 2025-01-18   | Validate patterns   |
-| User Flows         | 🔄     | `user-flows.md`         | 2025-01-24   | Add checkout flow   |
-| Auth Feature       | ⏳     | -                       | -            | Start documentation |
-| API Routes Map     | ❌     | -                       | -            | Not started         |
+| Area               | Status | File                              | Last Updated | Next Action         |
+| ------------------ | ------ | --------------------------------- | ------------ | ------------------- |
+| Store/State Map    | ✅     | `reference/store-map.md`          | 2025-01-24   | Validate in 7 days  |
+| Anti-Patterns      | 📝     | `reference/anti-patterns.md`      | 2025-01-20   | Needs validation    |
+| Editor Feature     | ✅     | `reference/features/editor.md`    | 2025-01-24   | None                |
+| Component Patterns | 📝     | `reference/component-patterns.md` | 2025-01-18   | Validate patterns   |
+| User Flows         | 🔄     | `reference/user-flows.md`         | 2025-01-24   | Add checkout flow   |
+| Auth Feature       | ⏳     | -                                 | -            | Start documentation |
+| API Routes Map     | ❌     | -                                 | -            | Not started         |
 
 ## Priority Queue
 
@@ -1063,12 +1063,12 @@ This preserves context window while ensuring thorough documentation.
 
 ```bash
 # Check if docs directory exists
-if [ ! -d .claude/docs ]; then
-  mkdir -p .claude/docs
+if [ ! -d .ai-docs ]; then
+  mkdir -p .ai-docs
 fi
 
 # Check if map exists
-if [ ! -f .claude/docs/DOCUMENTATION_MAP.md ]; then
+if [ ! -f .ai-docs/DOCUMENTATION_MAP.md ]; then
   # Create initial map by surveying codebase
   # Use Glob to find major areas
   # Initialize status as "not started"
@@ -1104,24 +1104,49 @@ fi
 
 ## Output Location Standards
 
-**All documentation goes in:** `.claude/docs/`
+**All documentation goes in:** `.ai-docs/`
 
 **Structure:**
 
 ```
-.claude/docs/
+.ai-docs/
 ├── DOCUMENTATION_MAP.md           # Master index
-├── store-map.md                   # State management
-├── anti-patterns.md               # Things to avoid
-├── component-patterns.md          # Component conventions
-├── user-flows.md                  # User workflows
-├── component-relationships.md     # How components relate
-└── features/
-    ├── editor.md                  # Feature-specific docs
-    ├── auth.md
-    └── checkout.md
+├── reference/                     # Descriptive — "how things work" (codex-keeper's domain)
+│   ├── architecture-overview.md
+│   ├── commands.md
+│   ├── type-system.md
+│   ├── store-map.md
+│   ├── component-patterns.md
+│   ├── utilities.md
+│   ├── test-infrastructure.md
+│   └── features/
+│       ├── compilation-pipeline.md
+│       ├── configuration.md
+│       ├── wizard-flow.md
+│       ├── skills-and-matrix.md
+│       └── plugin-system.md
+└── standards/                     # Prescriptive — "how to write code" (convention-keeper's domain)
+    ├── clean-code-standards.md
+    ├── e2e-testing-bible.md
+    ├── e2e/
+    │   ├── README.md
+    │   ├── assertions.md
+    │   ├── anti-patterns.md
+    │   ├── page-objects.md
+    │   ├── patterns.md
+    │   ├── test-data.md
+    │   └── test-structure.md
+    ├── prompt-bible.md
+    ├── loop-prompts-bible.md
+    ├── skill-atomicity-bible.md
+    ├── skill-atomicity-primer.md
+    ├── typescript-types-bible.md
+    ├── documentation-bible.md
+    └── commit-protocol.md
 ```
 
+**Scope split:** You (codex-keeper) create and validate files in `reference/`. The convention-keeper agent manages `standards/`. Do not create or modify files in `standards/`.
+
 **File naming:**
 
 - kebab-case for all files

package/dist/src/agents/meta/convention-keeper/critical-reminders.md

@@ -1,14 +1,14 @@
 ## CRITICAL REMINDERS
 
-**(You MUST read ALL unprocessed findings in `.agents-docs/findings/` before proposing any changes)**
+**(You MUST read ALL unprocessed findings in `.ai-docs/agent-findings/` before proposing any changes)**
 
-**(You MUST cross-reference every finding against existing standards in `docs/standards/` and `CLAUDE.md`)**
+**(You MUST cross-reference every finding against existing standards in `.ai-docs/standards/` and `CLAUDE.md`)**
 
 **(You MUST classify each finding group as: enforcement gap, documentation gap, or convention drift)**
 
 **(You MUST propose surgical additions to existing docs - never rewrite entire documents or create new doc files)**
 
-**(You MUST move processed findings to `findings/done/` after updates are applied - never delete findings)**
+**(You MUST move processed findings to `done/` after updates are applied - never delete findings)**
 
 **(You MUST re-read files after editing to verify changes were written)**
 

package/dist/src/agents/meta/convention-keeper/critical-requirements.md

@@ -1,14 +1,14 @@
 ## CRITICAL: Before Any Work
 
-**(You MUST read ALL unprocessed findings in `.agents-docs/findings/` before proposing any changes)**
+**(You MUST read ALL unprocessed findings in `.ai-docs/agent-findings/` before proposing any changes)**
 
-**(You MUST cross-reference every finding against existing standards in `docs/standards/` and `CLAUDE.md`)**
+**(You MUST cross-reference every finding against existing standards in `.ai-docs/standards/` and `CLAUDE.md`)**
 
 **(You MUST classify each finding group as: enforcement gap, documentation gap, or convention drift)**
 
 **(You MUST propose surgical additions to existing docs - never rewrite entire documents or create new doc files)**
 
-**(You MUST move processed findings to `findings/done/` after updates are applied - never delete findings)**
+**(You MUST move processed findings to `done/` after updates are applied - never delete findings)**
 
 **(You MUST re-read files after editing to verify changes were written)**