@cleocode/adapters 2026.5.37 → 2026.5.40

package/src/providers/gemini-cli/install.ts

@@ -2,28 +2,29 @@
  * Gemini CLI Install Provider
  *
  * Handles CLEO installation into Gemini CLI environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures GEMINI.md has CLEO @-references (via CAAMP registry)
  *
  * @task T161
  * @epic T134
+ * @task T9018
  */
 
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
-
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
 /**
  * Install provider for Gemini CLI.
  *
  * Manages CLEO's integration with Gemini CLI by:
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ * 1. Ensuring GEMINI.md contains @-references to CLEO instruction files
+ *    (via CAAMP registry — single source of truth for instruction file name)
  *
  * @remarks
  * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. Only AGENTS.md is managed; Gemini CLI
+ * project produces the same result. Only GEMINI.md is managed; Gemini CLI
  * does not have an MCP or plugin registration mechanism.
  *
  * @task T161
@@ -40,13 +41,16 @@ export class GeminiCliInstallProvider implements AdapterInstallProvider {
   async install(options: InstallOptions): Promise<InstallResult> {
     const { projectDir } = options;
     const installedAt = new Date().toISOString();
-    let instructionFileUpdated = false;
     const details: Record<string, unknown> = {};
 
-    // Step 1: Ensure AGENTS.md has @-references
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    const result = await ensureProviderInstructionFile('gemini-cli', projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+      scope: 'project',
+    });
+
+    const instructionFileUpdated = result.action !== 'intact';
     if (instructionFileUpdated) {
-      details.instructionFile = join(projectDir, 'AGENTS.md');
+      details.instructionFile = result.filePath;
     }
 
     return {
@@ -60,7 +64,7 @@ export class GeminiCliInstallProvider implements AdapterInstallProvider {
   /**
    * Uninstall CLEO from the Gemini CLI environment.
    *
-   * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+   * Does not remove GEMINI.md references (they are harmless if CLEO is not present).
    * @task T161
    */
   async uninstall(): Promise<void> {
@@ -70,15 +74,16 @@ export class GeminiCliInstallProvider implements AdapterInstallProvider {
   /**
    * Check whether CLEO is installed in the Gemini CLI environment.
    *
-   * Checks for CLEO references in AGENTS.md.
+   * Checks for CLEO references in GEMINI.md.
    * @task T161
    */
   async isInstalled(): Promise<boolean> {
-    const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-    if (existsSync(agentsMdPath)) {
+    const instructionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+    const geminiMdPath = join(process.cwd(), 'GEMINI.md');
+    if (existsSync(geminiMdPath)) {
       try {
-        const content = readFileSync(agentsMdPath, 'utf-8');
-        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
+        const content = readFileSync(geminiMdPath, 'utf-8');
+        if (content.includes(instructionRef)) {
           return true;
         }
       } catch {
@@ -90,49 +95,17 @@ export class GeminiCliInstallProvider implements AdapterInstallProvider {
   }
 
   /**
-   * Ensure AGENTS.md contains @-references to CLEO instruction files.
+   * Ensure GEMINI.md contains @-references to CLEO instruction files.
    *
-   * Creates AGENTS.md if it does not exist. Appends any missing references.
+   * Creates GEMINI.md if it does not exist. Appends any missing references.
    *
    * @param projectDir - Project root directory
    * @task T161
    */
   async ensureInstructionReferences(projectDir: string): Promise<void> {
-    this.updateInstructionFile(projectDir);
-  }
-
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @param projectDir - Project root directory
-   * @returns true if the file was created or modified
-   */
-  private updateInstructionFile(projectDir: string): boolean {
-    const agentsMdPath = join(projectDir, 'AGENTS.md');
-    let content = '';
-    let existed = false;
-
-    if (existsSync(agentsMdPath)) {
-      content = readFileSync(agentsMdPath, 'utf-8');
-      existed = true;
-    }
-
-    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-
-    if (missingRefs.length === 0) {
-      return false;
-    }
-
-    const refsBlock = missingRefs.join('\n');
-
-    if (existed) {
-      const separator = content.endsWith('\n') ? '' : '\n';
-      content = content + separator + refsBlock + '\n';
-    } else {
-      content = refsBlock + '\n';
-    }
-
-    writeFileSync(agentsMdPath, content, 'utf-8');
-    return true;
+    await ensureProviderInstructionFile('gemini-cli', projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+      scope: 'project',
+    });
   }
 }

package/src/providers/kimi/install.ts

@@ -2,24 +2,25 @@
  * Kimi Install Provider
  *
  * Handles CLEO installation into Kimi environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures AGENTS.md has CLEO @-references (via CAAMP registry)
  *
  * @task T163
  * @epic T134
+ * @task T9018
  */
 
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
-
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
 /**
  * Install provider for Kimi.
  *
  * Manages CLEO's integration with Kimi by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (via CAAMP registry — single source of truth for instruction file name)
  *
  * @remarks
  * Installation is idempotent -- running install multiple times on the same
@@ -40,13 +41,16 @@ export class KimiInstallProvider implements AdapterInstallProvider {
   async install(options: InstallOptions): Promise<InstallResult> {
     const { projectDir } = options;
     const installedAt = new Date().toISOString();
-    let instructionFileUpdated = false;
     const details: Record<string, unknown> = {};
 
-    // Step 1: Ensure AGENTS.md has @-references
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    const result = await ensureProviderInstructionFile('kimi', projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+      scope: 'project',
+    });
+
+    const instructionFileUpdated = result.action !== 'intact';
     if (instructionFileUpdated) {
-      details.instructionFile = join(projectDir, 'AGENTS.md');
+      details.instructionFile = result.filePath;
     }
 
     return {
@@ -74,11 +78,12 @@ export class KimiInstallProvider implements AdapterInstallProvider {
    * @task T163
    */
   async isInstalled(): Promise<boolean> {
+    const instructionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
     const agentsMdPath = join(process.cwd(), 'AGENTS.md');
     if (existsSync(agentsMdPath)) {
       try {
         const content = readFileSync(agentsMdPath, 'utf-8');
-        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
+        if (content.includes(instructionRef)) {
           return true;
         }
       } catch {
@@ -98,41 +103,9 @@ export class KimiInstallProvider implements AdapterInstallProvider {
    * @task T163
    */
   async ensureInstructionReferences(projectDir: string): Promise<void> {
-    this.updateInstructionFile(projectDir);
-  }
-
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @param projectDir - Project root directory
-   * @returns true if the file was created or modified
-   */
-  private updateInstructionFile(projectDir: string): boolean {
-    const agentsMdPath = join(projectDir, 'AGENTS.md');
-    let content = '';
-    let existed = false;
-
-    if (existsSync(agentsMdPath)) {
-      content = readFileSync(agentsMdPath, 'utf-8');
-      existed = true;
-    }
-
-    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-
-    if (missingRefs.length === 0) {
-      return false;
-    }
-
-    const refsBlock = missingRefs.join('\n');
-
-    if (existed) {
-      const separator = content.endsWith('\n') ? '' : '\n';
-      content = content + separator + refsBlock + '\n';
-    } else {
-      content = refsBlock + '\n';
-    }
-
-    writeFileSync(agentsMdPath, content, 'utf-8');
-    return true;
+    await ensureProviderInstructionFile('kimi', projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+      scope: 'project',
+    });
   }
 }

package/src/providers/openai-sdk/__tests__/openai-sdk-spawn.test.ts

@@ -23,11 +23,14 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 // Hoist shared state so vi.mock factories can reference it
 // ---------------------------------------------------------------------------
 
-const { generateTextCalls, mockRunState, mockFsState } = vi.hoisted(() => {
+const { generateTextCalls, mockRunState, mockFsState, mockCaampState } = vi.hoisted(() => {
   return {
     generateTextCalls: [] as Array<{ model: unknown; system?: string; prompt: string }>,
     mockRunState: { output: 'mock output', shouldThrow: false },
     mockFsState: { exists: false, content: '' },
+    mockCaampState: {
+      action: 'created' as 'created' | 'added' | 'consolidated' | 'updated' | 'intact',
+    },
   };
 });
 
@@ -52,7 +55,7 @@ vi.mock('ai', () => ({
 }));
 
 // ---------------------------------------------------------------------------
-// Mock node:fs for install provider tests
+// Mock node:fs for install provider tests (ensureConfigDir + isInstalled)
 // ---------------------------------------------------------------------------
 
 vi.mock('node:fs', async (importOriginal) => {
@@ -61,6 +64,7 @@ vi.mock('node:fs', async (importOriginal) => {
     ...actual,
     existsSync: vi.fn((path: string) => {
       if (typeof path === 'string' && path.includes('AGENTS.md')) return mockFsState.exists;
+      // .openai config dir: report not existing so we can test creation
       return false;
     }),
     readFileSync: vi.fn(() => mockFsState.content),
@@ -69,6 +73,23 @@ vi.mock('node:fs', async (importOriginal) => {
   };
 });
 
+// ---------------------------------------------------------------------------
+// Mock @cleocode/caamp for install provider tests
+// ---------------------------------------------------------------------------
+
+vi.mock('@cleocode/caamp', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('@cleocode/caamp')>();
+  return {
+    ...actual,
+    ensureProviderInstructionFile: vi.fn(async () => ({
+      filePath: '/tmp/project/AGENTS.md',
+      instructFile: 'AGENTS.md',
+      action: mockCaampState.action,
+      providerId: 'openai-sdk',
+    })),
+  };
+});
+
 // ---------------------------------------------------------------------------
 // Mock cant-context for spawn tests
 // ---------------------------------------------------------------------------
@@ -558,6 +579,7 @@ describe('OpenAiSdkInstallProvider', () => {
     installProvider = new OpenAiSdkInstallProvider();
     mockFsState.exists = false;
     mockFsState.content = '';
+    mockCaampState.action = 'created';
   });
 
   afterEach(() => vi.clearAllMocks());
@@ -577,14 +599,13 @@ describe('OpenAiSdkInstallProvider', () => {
     });
 
     it('marks instructionFileUpdated when AGENTS.md is created', async () => {
-      mockFsState.exists = false;
+      mockCaampState.action = 'created';
       const result = await installProvider.install({ projectDir: '/tmp/project' });
       expect(result.instructionFileUpdated).toBe(true);
     });
 
-    it('does not mark updated when references already present', async () => {
-      mockFsState.exists = true;
-      mockFsState.content = '@~/.cleo/templates/CLEO-INJECTION.md\n@.cleo/memory-bridge.md\n';
+    it('does not mark updated when references already present (intact)', async () => {
+      mockCaampState.action = 'intact';
       const result = await installProvider.install({ projectDir: '/tmp/project' });
       expect(result.instructionFileUpdated).toBe(false);
     });

package/src/providers/openai-sdk/install.ts

@@ -2,24 +2,25 @@
  * OpenAI SDK Install Provider.
  *
  * Handles CLEO installation into OpenAI SDK environments:
- * - Writes an AGENTS.md file with CLEO @-references
+ * - Writes an AGENTS.md file with CLEO @-references (via CAAMP registry)
  * - Creates a `.openai/` config stub if it does not exist
  *
  * @task T582
+ * @task T9018
  */
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
+import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
-
-/** Lines that should appear in AGENTS.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
 /**
  * Install provider for the OpenAI SDK adapter (Vercel AI SDK).
  *
  * Manages CLEO's integration with OpenAI SDK projects by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (via CAAMP registry — single source of truth for instruction file name)
  * 2. Creating the `.openai/` config directory stub if absent
  *
  * @remarks
@@ -38,10 +39,15 @@ export class OpenAiSdkInstallProvider implements AdapterInstallProvider {
     const installedAt = new Date().toISOString();
     const details: Record<string, unknown> = {};
 
-    // Step 1: Ensure AGENTS.md has @-references
-    const instructionFileUpdated = this.updateInstructionFile(projectDir);
+    // Step 1: Ensure AGENTS.md has @-references via CAAMP registry
+    const instructionResult = await ensureProviderInstructionFile('openai-sdk', projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+      scope: 'project',
+    });
+
+    const instructionFileUpdated = instructionResult.action !== 'intact';
     if (instructionFileUpdated) {
-      details.instructionFile = join(projectDir, 'AGENTS.md');
+      details.instructionFile = instructionResult.filePath;
     }
 
     // Step 2: Create .openai config directory stub
@@ -68,7 +74,7 @@ export class OpenAiSdkInstallProvider implements AdapterInstallProvider {
   /**
    * Check whether CLEO is installed in the current OpenAI SDK environment.
    *
-   * Checks for `@~/.cleo/templates/CLEO-INJECTION.md` in AGENTS.md.
+   * Checks for `@~/.local/share/cleo/templates/CLEO-INJECTION.md` in AGENTS.md.
    */
   async isInstalled(): Promise<boolean> {
     // A project is considered installed when AGENTS.md contains the first reference.
@@ -82,44 +88,16 @@ export class OpenAiSdkInstallProvider implements AdapterInstallProvider {
    * @param projectDir - Project root directory.
    */
   async ensureInstructionReferences(projectDir: string): Promise<void> {
-    this.updateInstructionFile(projectDir);
+    await ensureProviderInstructionFile('openai-sdk', projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+      scope: 'project',
+    });
   }
 
   // ---------------------------------------------------------------------------
   // Private helpers
   // ---------------------------------------------------------------------------
 
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @returns `true` if the file was created or modified.
-   */
-  private updateInstructionFile(projectDir: string): boolean {
-    const agentsMdPath = join(projectDir, 'AGENTS.md');
-    let content = '';
-    let existed = false;
-
-    if (existsSync(agentsMdPath)) {
-      content = readFileSync(agentsMdPath, 'utf-8');
-      existed = true;
-    }
-
-    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-    if (missingRefs.length === 0) return false;
-
-    const refsBlock = missingRefs.join('\n');
-
-    if (existed) {
-      const separator = content.endsWith('\n') ? '' : '\n';
-      content = content + separator + refsBlock + '\n';
-    } else {
-      content = refsBlock + '\n';
-    }
-
-    writeFileSync(agentsMdPath, content, 'utf-8');
-    return true;
-  }
-
   /**
    * Create the `.openai/` config directory if it does not exist.
    *

package/src/providers/opencode/__tests__/adapter.test.ts

@@ -54,6 +54,20 @@ vi.mock('node:fs/promises', () => ({
   unlink: vi.fn().mockResolvedValue(undefined),
 }));
 
+// Mock CAAMP's ensureProviderInstructionFile to avoid registry I/O in unit tests.
+vi.mock('@cleocode/caamp', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('@cleocode/caamp')>();
+  return {
+    ...actual,
+    ensureProviderInstructionFile: vi.fn().mockResolvedValue({
+      filePath: '/tmp/test-project/AGENTS.md',
+      instructFile: 'AGENTS.md',
+      action: 'created',
+      providerId: 'opencode',
+    }),
+  };
+});
+
 describe('OpenCodeAdapter', () => {
   let adapter: OpenCodeAdapter;
 

package/src/providers/opencode/install.ts

@@ -2,15 +2,17 @@
  * OpenCode Install Provider
  *
  * Handles CLEO installation into OpenCode environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures AGENTS.md has CLEO @-references via CAAMP
  * - Installs PreCompact hook shell shims + a JS plugin wrapper (T1013)
  *
  * @task T5240
  * @task T1013
+ * @task T9019
  */
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 import {
   type InstallHookTemplatesResult,
@@ -18,26 +20,17 @@ import {
 } from '../shared/hook-template-installer.js';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/**
- * Lines that should appear in AGENTS.md to reference CLEO.
- * The CLEO-INJECTION.md path is resolved dynamically to support non-default
- * XDG / OS installation locations (T916).
- */
-const INSTRUCTION_REFERENCES = [
-  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-  '@.cleo/memory-bridge.md',
-];
-
 /**
  * Install provider for OpenCode.
  *
  * Manages CLEO's integration with OpenCode by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (delegated to CAAMP's canonical {@link ensureProviderInstructionFile}).
  * 2. Installing PreCompact hook shell templates + generating the JS plugin
  *    wrapper that spawns the shim on `experimental.session.compacting` (T1013).
  *
  * @remarks
- * Installation is idempotent -- running install multiple times on the same
+ * Installation is idempotent — running install multiple times on the same
  * project produces the same result. OpenCode's plugin system is the native
  * hook surface (OpenCode has no config-file hook registry like Claude Code or
  * Cursor), so the installer writes a JS plugin that subscribes to the native
@@ -55,13 +48,17 @@ export class OpenCodeInstallProvider implements AdapterInstallProvider {
   async install(options: InstallOptions): Promise<InstallResult> {
     const { projectDir } = options;
     const installedAt = new Date().toISOString();
-    let instructionFileUpdated = false;
     const details: Record<string, unknown> = {};
 
-    // Step 1: Ensure AGENTS.md has @-references
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    // Step 1: Ensure AGENTS.md has @-references via CAAMP canonical API.
+    const instructResult = await ensureProviderInstructionFile('opencode', projectDir, {
+      scope: 'project',
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+    });
+
+    const instructionFileUpdated = instructResult.action !== 'intact';
     if (instructionFileUpdated) {
-      details.instructionFile = join(projectDir, 'AGENTS.md');
+      details.instructionFile = join(projectDir, instructResult.instructFile);
     }
 
     // Step 2 (T1013): Install PreCompact hook templates + generate the JS
@@ -90,69 +87,35 @@ export class OpenCodeInstallProvider implements AdapterInstallProvider {
   /**
    * Check whether CLEO is installed in the current environment.
    *
-   * Checks for CLEO references in AGENTS.md.
+   * Delegates to CAAMP's instruction-file check.
    */
   async isInstalled(): Promise<boolean> {
-    const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-    if (existsSync(agentsMdPath)) {
-      try {
-        const content = readFileSync(agentsMdPath, 'utf-8');
-        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-          return true;
-        }
-      } catch {
-        // Fall through
-      }
+    try {
+      const result = await ensureProviderInstructionFile('opencode', process.cwd(), {
+        scope: 'project',
+        references: [
+          `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+          '@.cleo/memory-bridge.md',
+        ],
+      });
+      return result.action === 'intact';
+    } catch {
+      return false;
     }
-
-    return false;
   }
 
   /**
    * Ensure AGENTS.md contains @-references to CLEO instruction files.
    *
-   * Creates AGENTS.md if it does not exist. Appends any missing references.
+   * Delegates to CAAMP's canonical {@link ensureProviderInstructionFile}.
    *
    * @param projectDir - Project root directory
    */
   async ensureInstructionReferences(projectDir: string): Promise<void> {
-    this.updateInstructionFile(projectDir);
-  }
-
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @returns true if the file was created or modified
-   */
-  private updateInstructionFile(projectDir: string): boolean {
-    const agentsMdPath = join(projectDir, 'AGENTS.md');
-    let content = '';
-    let existed = false;
-
-    if (existsSync(agentsMdPath)) {
-      content = readFileSync(agentsMdPath, 'utf-8');
-      existed = true;
-    }
-
-    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-
-    if (missingRefs.length === 0) {
-      return false;
-    }
-
-    const refsBlock = missingRefs.join('\n');
-
-    if (existed) {
-      // Append missing references
-      const separator = content.endsWith('\n') ? '' : '\n';
-      content = content + separator + refsBlock + '\n';
-    } else {
-      // Create new AGENTS.md with references
-      content = refsBlock + '\n';
-    }
-
-    writeFileSync(agentsMdPath, content, 'utf-8');
-    return true;
+    await ensureProviderInstructionFile('opencode', projectDir, {
+      scope: 'project',
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+    });
   }
 
   /**