runtime-adapters git:20260604.6f4a12aA

Immutable. This exact content is served forever at /api/v1/blob/994b9a00a8642abb.

---
name: runtime-adapters
description: "Use when creating Codex, Claude Code, Gemini CLI, Cursor, or AGENTS.md runtime adapters from one canonical agent core. Use whenever a generated repo needs multiple AI runtimes without duplicating instructions."
---

# Runtime Adapters

## Rules

- `AGENTS.md` is canonical.
- `.claude/`, `.codex/`, `.gemini/`, `.cursor/`, and root `skills/` are thin
  adapters or mirrors.
- Adapter text should point back to `AGENTS.md`.
- Do not claim identical behavior across runtimes. Say the canonical core is
  portable and each adapter maps it into local conventions.

## Required Adapters

- Codex: plugin manifest plus skill.
- Claude Code: command, agent, and skill adapter.
- Gemini CLI: `GEMINI.md`.
- Generic: root `AGENTS.md`.