clavix 5.1.0 → 5.2.1

package/dist/core/adapters/gemini-adapter.js

@@ -1,54 +1,15 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * Gemini CLI adapter
  * Commands stored as TOML files under .gemini/commands/clavix by default
  */
-export class GeminiAdapter extends BaseAdapter {
-    options;
-    name = 'gemini';
-    displayName = 'Gemini CLI';
-    fileExtension = '.toml';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '{{args}}',
-    };
+export class GeminiAdapter extends TomlFormattingAdapter {
     constructor(options = {}) {
-        super();
-        this.options = options;
-    }
-    get directory() {
-        const useNamespace = this.options.useNamespace ?? true;
-        return useNamespace ? path.join('.gemini', 'commands', 'clavix') : path.join('.gemini', 'commands');
-    }
-    async detectProject() {
-        if (await FileSystem.exists('.gemini')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.gemini');
-        return await FileSystem.exists(homePath);
-    }
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        const commandPath = this.getCommandPath();
-        const namespaced = commandPath.endsWith(path.join('commands', 'clavix'));
-        const baseName = namespaced ? name : `clavix-${name}`;
-        return `${baseName}${this.fileExtension}`;
-    }
-    formatCommand(template) {
-        const description = template.description.trim().length > 0
-            ? `description = ${JSON.stringify(template.description)}\n\n`
-            : '';
-        const content = template.content.replace(/\{\{ARGS\}\}/g, '{{args}}');
-        return `${description}prompt = """\n${content}\n"""\n`;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
+        super({
+            name: 'gemini',
+            displayName: 'Gemini CLI',
+            rootDir: '.gemini',
+        }, options);
     }
 }
 //# sourceMappingURL=gemini-adapter.js.map

package/dist/core/adapters/llxprt-adapter.d.ts

@@ -1,27 +1,11 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * LLXPRT adapter
  * Commands stored as TOML files under .llxprt/commands/clavix by default
  */
-export declare class LlxprtAdapter extends BaseAdapter {
-    private readonly options;
-    readonly name = "llxprt";
-    readonly displayName = "LLXPRT";
-    readonly fileExtension = ".toml";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-    };
+export declare class LlxprtAdapter extends TomlFormattingAdapter {
     constructor(options?: {
         useNamespace?: boolean;
     });
-    get directory(): string;
-    detectProject(): Promise<boolean>;
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-    protected formatCommand(template: CommandTemplate): string;
-    private getHomeDir;
 }
 //# sourceMappingURL=llxprt-adapter.d.ts.map

package/dist/core/adapters/llxprt-adapter.js

@@ -1,54 +1,15 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * LLXPRT adapter
  * Commands stored as TOML files under .llxprt/commands/clavix by default
  */
-export class LlxprtAdapter extends BaseAdapter {
-    options;
-    name = 'llxprt';
-    displayName = 'LLXPRT';
-    fileExtension = '.toml';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '{{args}}',
-    };
+export class LlxprtAdapter extends TomlFormattingAdapter {
     constructor(options = {}) {
-        super();
-        this.options = options;
-    }
-    get directory() {
-        const useNamespace = this.options.useNamespace ?? true;
-        return useNamespace ? path.join('.llxprt', 'commands', 'clavix') : path.join('.llxprt', 'commands');
-    }
-    async detectProject() {
-        if (await FileSystem.exists('.llxprt')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.llxprt');
-        return await FileSystem.exists(homePath);
-    }
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        const commandPath = this.getCommandPath();
-        const namespaced = commandPath.endsWith(path.join('commands', 'clavix'));
-        const baseName = namespaced ? name : `clavix-${name}`;
-        return `${baseName}${this.fileExtension}`;
-    }
-    formatCommand(template) {
-        const description = template.description.trim().length > 0
-            ? `description = ${JSON.stringify(template.description)}\n\n`
-            : '';
-        const content = template.content.replace(/\{\{ARGS\}\}/g, '{{args}}');
-        return `${description}prompt = """\n${content}\n"""\n`;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
+        super({
+            name: 'llxprt',
+            displayName: 'LLXPRT',
+            rootDir: '.llxprt',
+        }, options);
     }
 }
 //# sourceMappingURL=llxprt-adapter.js.map

package/dist/core/adapters/octo-md-generator.d.ts

@@ -4,20 +4,10 @@
  */
 export declare class OctoMdGenerator {
     static readonly TARGET_FILE = "OCTO.md";
-    static readonly START_MARKER = "<!-- CLAVIX:START -->";
-    static readonly END_MARKER = "<!-- CLAVIX:END -->";
     /**
      * Generate or update OCTO.md with Clavix workflows
      */
     static generate(): Promise<void>;
-    /**
-     * Inject or update managed block in OCTO.md
-     */
-    private static injectManagedBlock;
-    /**
-     * Escape special regex characters
-     */
-    private static escapeRegex;
     /**
      * Check if OCTO.md has Clavix block
      */

package/dist/core/adapters/octo-md-generator.js

@@ -1,7 +1,8 @@
-import { FileSystem } from '../../utils/file-system.js';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { FileSystem } from '../../utils/file-system.js';
+import { DocInjector } from '../doc-injector.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -10,60 +11,25 @@ const __dirname = dirname(__filename);
  */
 export class OctoMdGenerator {
     static TARGET_FILE = 'OCTO.md';
-    static START_MARKER = '<!-- CLAVIX:START -->';
-    static END_MARKER = '<!-- CLAVIX:END -->';
     /**
      * Generate or update OCTO.md with Clavix workflows
      */
     static async generate() {
         const templatePath = path.join(__dirname, '../../templates/agents/octo.md');
-        // Check if template exists
         if (!(await FileSystem.exists(templatePath))) {
             throw new Error(`OCTO.md template not found at ${templatePath}`);
         }
         const template = await FileSystem.readFile(templatePath);
-        // Inject into OCTO.md using managed blocks
-        await this.injectManagedBlock(this.TARGET_FILE, template);
-    }
-    /**
-     * Inject or update managed block in OCTO.md
-     */
-    static async injectManagedBlock(filePath, content) {
-        let fileContent = '';
-        // Read existing file or start with empty content
-        if (await FileSystem.exists(filePath)) {
-            fileContent = await FileSystem.readFile(filePath);
-        }
-        const blockRegex = new RegExp(`${this.escapeRegex(this.START_MARKER)}[\\s\\S]*?${this.escapeRegex(this.END_MARKER)}`, 'g');
-        const wrappedContent = `${this.START_MARKER}\n${content}\n${this.END_MARKER}`;
-        if (blockRegex.test(fileContent)) {
-            // Replace existing block
-            fileContent = fileContent.replace(blockRegex, wrappedContent);
-        }
-        else {
-            // Append new block
-            if (fileContent && !fileContent.endsWith('\n\n')) {
-                fileContent += '\n\n';
-            }
-            fileContent += wrappedContent + '\n';
-        }
-        await FileSystem.writeFileAtomic(filePath, fileContent);
-    }
-    /**
-     * Escape special regex characters
-     */
-    static escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        await DocInjector.injectBlock(this.TARGET_FILE, template, {
+            createIfMissing: true,
+            validateMarkdown: false,
+        });
     }
     /**
      * Check if OCTO.md has Clavix block
      */
     static async hasClavixBlock() {
-        if (!(await FileSystem.exists(this.TARGET_FILE))) {
-            return false;
-        }
-        const content = await FileSystem.readFile(this.TARGET_FILE);
-        return content.includes(this.START_MARKER);
+        return DocInjector.hasBlock(this.TARGET_FILE);
     }
 }
 //# sourceMappingURL=octo-md-generator.js.map

package/dist/core/adapters/qwen-adapter.d.ts

@@ -1,27 +1,11 @@
-import { BaseAdapter } from './base-adapter.js';
-import { CommandTemplate } from '../../types/agent.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * Qwen Code CLI adapter
  * Commands stored as TOML files under .qwen/commands/clavix by default
  */
-export declare class QwenAdapter extends BaseAdapter {
-    private readonly options;
-    readonly name = "qwen";
-    readonly displayName = "Qwen Code";
-    readonly fileExtension = ".toml";
-    readonly features: {
-        supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
-        argumentPlaceholder: string;
-    };
+export declare class QwenAdapter extends TomlFormattingAdapter {
     constructor(options?: {
         useNamespace?: boolean;
     });
-    get directory(): string;
-    detectProject(): Promise<boolean>;
-    getCommandPath(): string;
-    getTargetFilename(name: string): string;
-    protected formatCommand(template: CommandTemplate): string;
-    private getHomeDir;
 }
 //# sourceMappingURL=qwen-adapter.d.ts.map

package/dist/core/adapters/qwen-adapter.js

@@ -1,54 +1,15 @@
-import * as os from 'os';
-import * as path from 'path';
-import { BaseAdapter } from './base-adapter.js';
-import { FileSystem } from '../../utils/file-system.js';
+import { TomlFormattingAdapter } from './toml-formatting-adapter.js';
 /**
  * Qwen Code CLI adapter
  * Commands stored as TOML files under .qwen/commands/clavix by default
  */
-export class QwenAdapter extends BaseAdapter {
-    options;
-    name = 'qwen';
-    displayName = 'Qwen Code';
-    fileExtension = '.toml';
-    features = {
-        supportsSubdirectories: true,
-        supportsFrontmatter: false,
-        argumentPlaceholder: '{{args}}',
-    };
+export class QwenAdapter extends TomlFormattingAdapter {
     constructor(options = {}) {
-        super();
-        this.options = options;
-    }
-    get directory() {
-        const useNamespace = this.options.useNamespace ?? true;
-        return useNamespace ? path.join('.qwen', 'commands', 'clavix') : path.join('.qwen', 'commands');
-    }
-    async detectProject() {
-        if (await FileSystem.exists('.qwen')) {
-            return true;
-        }
-        const homePath = path.join(this.getHomeDir(), '.qwen');
-        return await FileSystem.exists(homePath);
-    }
-    getCommandPath() {
-        return this.directory;
-    }
-    getTargetFilename(name) {
-        const commandPath = this.getCommandPath();
-        const namespaced = commandPath.endsWith(path.join('commands', 'clavix'));
-        const baseName = namespaced ? name : `clavix-${name}`;
-        return `${baseName}${this.fileExtension}`;
-    }
-    formatCommand(template) {
-        const description = template.description.trim().length > 0
-            ? `description = ${JSON.stringify(template.description)}\n\n`
-            : '';
-        const content = template.content.replace(/\{\{ARGS\}\}/g, '{{args}}');
-        return `${description}prompt = """\n${content}\n"""\n`;
-    }
-    getHomeDir() {
-        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
+        super({
+            name: 'qwen',
+            displayName: 'Qwen Code',
+            rootDir: '.qwen',
+        }, options);
     }
 }
 //# sourceMappingURL=qwen-adapter.js.map

package/dist/core/adapters/toml-formatting-adapter.d.ts

@@ -0,0 +1,50 @@
+import { BaseAdapter } from './base-adapter.js';
+import { CommandTemplate } from '../../types/agent.js';
+/**
+ * Configuration for TOML-based adapters
+ */
+export interface TomlAdapterConfig {
+    /** Internal adapter name (e.g., 'gemini') */
+    name: string;
+    /** Display name for UI (e.g., 'Gemini CLI') */
+    displayName: string;
+    /** Root directory name (e.g., '.gemini') */
+    rootDir: string;
+    /** Whether to use namespace subdirectory by default */
+    useNamespace?: boolean;
+}
+/**
+ * Base adapter for TOML-formatted command files
+ * Used by Gemini CLI, Qwen Code, LLXPRT, and similar tools
+ *
+ * Handles:
+ * - TOML file format with description and prompt fields
+ * - {{args}} placeholder conversion
+ * - Namespace subdirectories (e.g., .gemini/commands/clavix/)
+ * - Home directory detection for global installations
+ */
+export declare abstract class TomlFormattingAdapter extends BaseAdapter {
+    readonly fileExtension = ".toml";
+    readonly features: {
+        supportsSubdirectories: boolean;
+        supportsFrontmatter: boolean;
+        argumentPlaceholder: string;
+    };
+    protected readonly config: TomlAdapterConfig;
+    constructor(config: TomlAdapterConfig, options?: {
+        useNamespace?: boolean;
+    });
+    get name(): string;
+    get displayName(): string;
+    get directory(): string;
+    detectProject(): Promise<boolean>;
+    getCommandPath(): string;
+    getTargetFilename(name: string): string;
+    /**
+     * Format command as TOML with description and prompt fields
+     * Converts {{ARGS}} placeholder to {{args}} for TOML tools
+     */
+    protected formatCommand(template: CommandTemplate): string;
+    protected getHomeDir(): string;
+}
+//# sourceMappingURL=toml-formatting-adapter.d.ts.map

package/dist/core/adapters/toml-formatting-adapter.js

@@ -0,0 +1,74 @@
+import * as os from 'os';
+import * as path from 'path';
+import { BaseAdapter } from './base-adapter.js';
+import { FileSystem } from '../../utils/file-system.js';
+/**
+ * Base adapter for TOML-formatted command files
+ * Used by Gemini CLI, Qwen Code, LLXPRT, and similar tools
+ *
+ * Handles:
+ * - TOML file format with description and prompt fields
+ * - {{args}} placeholder conversion
+ * - Namespace subdirectories (e.g., .gemini/commands/clavix/)
+ * - Home directory detection for global installations
+ */
+export class TomlFormattingAdapter extends BaseAdapter {
+    fileExtension = '.toml';
+    features = {
+        supportsSubdirectories: true,
+        supportsFrontmatter: false,
+        argumentPlaceholder: '{{args}}',
+    };
+    config;
+    constructor(config, options = {}) {
+        super();
+        this.config = {
+            ...config,
+            useNamespace: options.useNamespace ?? config.useNamespace ?? true,
+        };
+    }
+    get name() {
+        return this.config.name;
+    }
+    get displayName() {
+        return this.config.displayName;
+    }
+    get directory() {
+        return this.config.useNamespace
+            ? path.join(this.config.rootDir, 'commands', 'clavix')
+            : path.join(this.config.rootDir, 'commands');
+    }
+    async detectProject() {
+        // Check local project directory
+        if (await FileSystem.exists(this.config.rootDir)) {
+            return true;
+        }
+        // Check home directory for global installation
+        const homePath = path.join(this.getHomeDir(), this.config.rootDir);
+        return await FileSystem.exists(homePath);
+    }
+    getCommandPath() {
+        return this.directory;
+    }
+    getTargetFilename(name) {
+        const commandPath = this.getCommandPath();
+        const namespaced = commandPath.endsWith(path.join('commands', 'clavix'));
+        const baseName = namespaced ? name : `clavix-${name}`;
+        return `${baseName}${this.fileExtension}`;
+    }
+    /**
+     * Format command as TOML with description and prompt fields
+     * Converts {{ARGS}} placeholder to {{args}} for TOML tools
+     */
+    formatCommand(template) {
+        const description = template.description.trim().length > 0
+            ? `description = ${JSON.stringify(template.description)}\n\n`
+            : '';
+        const content = template.content.replace(/\{\{ARGS\}\}/g, '{{args}}');
+        return `${description}prompt = """\n${content}\n"""\n`;
+    }
+    getHomeDir() {
+        return process.env.CLAVIX_HOME_OVERRIDE || os.homedir();
+    }
+}
+//# sourceMappingURL=toml-formatting-adapter.js.map

package/dist/core/adapters/warp-md-generator.d.ts

@@ -4,14 +4,13 @@
  */
 export declare class WarpMdGenerator {
     static readonly TARGET_FILE = "WARP.md";
-    static readonly START_MARKER = "<!-- CLAVIX:START -->";
-    static readonly END_MARKER = "<!-- CLAVIX:END -->";
     /**
      * Generate or update WARP.md with Clavix workflows
      */
     static generate(): Promise<void>;
-    private static injectManagedBlock;
-    private static escapeRegex;
+    /**
+     * Check if WARP.md has Clavix block
+     */
     static hasClavixBlock(): Promise<boolean>;
 }
 //# sourceMappingURL=warp-md-generator.d.ts.map

package/dist/core/adapters/warp-md-generator.js

@@ -1,7 +1,8 @@
-import { FileSystem } from '../../utils/file-system.js';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { FileSystem } from '../../utils/file-system.js';
+import { DocInjector } from '../doc-injector.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
@@ -10,8 +11,6 @@ const __dirname = dirname(__filename);
  */
 export class WarpMdGenerator {
     static TARGET_FILE = 'WARP.md';
-    static START_MARKER = '<!-- CLAVIX:START -->';
-    static END_MARKER = '<!-- CLAVIX:END -->';
     /**
      * Generate or update WARP.md with Clavix workflows
      */
@@ -21,35 +20,16 @@ export class WarpMdGenerator {
             throw new Error(`WARP.md template not found at ${templatePath}`);
         }
         const template = await FileSystem.readFile(templatePath);
-        await this.injectManagedBlock(this.TARGET_FILE, template);
-    }
-    static async injectManagedBlock(filePath, content) {
-        let fileContent = '';
-        if (await FileSystem.exists(filePath)) {
-            fileContent = await FileSystem.readFile(filePath);
-        }
-        const blockRegex = new RegExp(`${this.escapeRegex(this.START_MARKER)}[\\s\\S]*?${this.escapeRegex(this.END_MARKER)}`, 'g');
-        const wrappedContent = `${this.START_MARKER}\n${content}\n${this.END_MARKER}`;
-        if (blockRegex.test(fileContent)) {
-            fileContent = fileContent.replace(blockRegex, wrappedContent);
-        }
-        else {
-            if (fileContent && !fileContent.endsWith('\n\n')) {
-                fileContent += '\n\n';
-            }
-            fileContent += wrappedContent + '\n';
-        }
-        await FileSystem.writeFileAtomic(filePath, fileContent);
-    }
-    static escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        await DocInjector.injectBlock(this.TARGET_FILE, template, {
+            createIfMissing: true,
+            validateMarkdown: false,
+        });
     }
+    /**
+     * Check if WARP.md has Clavix block
+     */
     static async hasClavixBlock() {
-        if (!(await FileSystem.exists(this.TARGET_FILE))) {
-            return false;
-        }
-        const content = await FileSystem.readFile(this.TARGET_FILE);
-        return content.includes(this.START_MARKER);
+        return DocInjector.hasBlock(this.TARGET_FILE);
     }
 }
 //# sourceMappingURL=warp-md-generator.js.map

package/dist/core/doc-injector.js

@@ -198,13 +198,12 @@ Enter conversational mode for iterative prompt development. Discuss your require
 #### /clavix:summarize
 Analyze the current conversation and extract key requirements into a structured prompt and mini-PRD.
 
-### Utility Commands
+### Agentic Utilities
 
-#### /clavix:verify
-Verify implementation against checklist. Run automated checks and generate pass/fail reports.
+These utilities provide structured workflows for common tasks. Invoke them using the slash commands below:
 
-#### /clavix:archive
-Archive completed projects. Move finished PRDs and outputs to the archive for future reference.
+- **Verify** (\`/clavix:verify\`): Check implementation against PRD requirements. Runs automated validation and generates pass/fail reports.
+- **Archive** (\`/clavix:archive\`): Archive completed work. Moves finished PRDs and outputs to archive for future reference.
 
 **When to use which mode:**
 - **Improve mode** (\`/clavix:improve\`): Smart prompt optimization with auto-depth selection

package/dist/templates/agents/agents.md

@@ -87,8 +87,14 @@ All workflows are executed via slash commands that AI agents read and follow:
 | `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
 | `/clavix:start` | Begin conversational session |
 | `/clavix:summarize` | Extract requirements from conversation |
-| `/clavix:verify` | Verify implementation |
-| `/clavix:archive` | Archive completed projects |
+
+### Agentic Utilities (Project Management)
+These utilities provide structured workflows for project completion:
+
+| Utility | Purpose |
+|---------|---------|
+| `/clavix:verify` | Check implementation against PRD requirements, run validation |
+| `/clavix:archive` | Archive completed work to `.clavix/archive/` for reference |
 
 **Quick start:**
 ```bash

package/dist/templates/agents/copilot-instructions.md

@@ -74,8 +74,12 @@ All workflows are executed via slash commands:
 | `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
 | `/clavix:start` | Begin conversational session |
 | `/clavix:summarize` | Extract requirements from conversation |
-| `/clavix:verify` | Verify implementation |
-| `/clavix:archive` | Archive completed projects |
+
+### Agentic Utilities (Project Management)
+| Utility | Purpose |
+|---------|---------|
+| `/clavix:verify` | Check implementation against PRD requirements |
+| `/clavix:archive` | Archive completed work to `.clavix/archive/` |
 
 ---
 

package/dist/templates/agents/octo.md

@@ -135,8 +135,12 @@ Autofix handles edge cases gracefully - let it work.
 | `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
 | `/clavix:start` | Begin conversational session |
 | `/clavix:summarize` | Extract requirements from conversation |
-| `/clavix:verify` | Verify implementation |
-| `/clavix:archive` | Archive completed projects |
+
+### Agentic Utilities (Project Management)
+| Utility | Purpose |
+|---------|---------|
+| `/clavix:verify` | Check implementation against PRD requirements |
+| `/clavix:archive` | Archive completed work to `.clavix/archive/` |
 
 ---
 

package/dist/templates/agents/warp.md

@@ -63,8 +63,12 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 | `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
 | `/clavix:start` | Begin conversational session |
 | `/clavix:summarize` | Extract requirements from conversation |
-| `/clavix:verify` | Verify implementation |
-| `/clavix:archive` | Archive completed projects |
+
+### Agentic Utilities (Project Management)
+| Utility | Purpose |
+|---------|---------|
+| `/clavix:verify` | Check implementation against PRD requirements |
+| `/clavix:archive` | Archive completed work to `.clavix/archive/` |
 
 ### Outputs
 - Project artifacts live under `.clavix/outputs/<project>/`

package/dist/templates/slash-commands/_canonical/archive.md

@@ -234,18 +234,15 @@ Result: Project permanently deleted
 
 ## Agent Transparency (v5.1)
 
-### CLI Reference (Commands I Execute)
-{{INCLUDE:agent-protocols/cli-reference.md}}
+### Agent Manual (Universal Protocols)
+{{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
 
-### Error Handling
-{{INCLUDE:agent-protocols/error-handling.md}}
+### CLI Reference
+{{INCLUDE:agent-protocols/cli-reference.md}}
 
 ### Recovery Patterns
 {{INCLUDE:troubleshooting/vibecoder-recovery.md}}
 
-### Agent Decision Rules
-{{INCLUDE:agent-protocols/decision-rules.md}}
-
 ## Workflow Navigation
 
 **You are here:** Archive (Project Cleanup)