odai: Instructions file for Codex

AGENTS.md

odai AGENTS.md is an instructions file for Codex, OpenCode from orziz/odai. It costs 2,118 tokens per session, scanned A, original, MIT.

Repository instructions that define how to maintain the odai project, including which files are the official source for its skills and how releases are handled.

In plain words
What is it for?
Use them when changing odai, its skills, packaging, release process, or integration with dsh.
Why use it?
They prevent contributors from editing generated copies or bypassing the project's required checks and boundaries.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

This is orziz/odai's own configuration. It tells Codex and OpenCode how to work on odai itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything odai configures →

View source ↗ orziz/odai
Reuse

Borrowing it

Nothing to install: this file belongs to orziz/odai. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/orziz/odai/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/orziz/odai

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for odai AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/orziz/odai/agents-md/github.svg)](https://agentmods.dev/instructions/orziz/odai/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/orziz/odai/agents-md"><img src="https://agentmods.dev/badge/instructions/orziz/odai/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for odai AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/orziz/odai/agents-md"><img src="https://agentmods.dev/badge/instructions/orziz/odai/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,118 This file is loaded in full into every session.
When invoked 2,118 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.02118 $0.02118
Opus 5.5 $0.00847 $0.00847
Sonnet 5.5 $0.00424 $0.00424
Haiku 4.5 $0.00212 $0.00212

Measured today against content hash 6f5646f81f33, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

odai AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 41 lines

How it starts

The opening of the file, as written. The whole thing — 41 lines — stays where its author put it; the contents beside it link to each section on GitHub.

仓库维护约束

odai 必用

  • 本仓库中的每次用户请求都必须使用 canonical skills/odai/SKILL.md 治理。若宿主明确声明当前 odai-dsh-agent 或 odai-dsh-plugin 已把完整 canonical governance 注入系统提示,并给出 skill version、runtime contract 与 bundle digest,则该注入本身视为已完整加载;声明有效且本会话未改动 canonical bundle 期间,不得再调用 skill 或 read 重复载入同一正文。仅当注入声明缺失或不可信、任务直接审查或修改 Odai、或 manifest 声明的 canonical 文件在注入后发生变化时,才须在行动前完整读取当前 SKILL.md,并以新内容继续治理。其他宿主若当前任务尚未完整读取其当下版本,任何调查、判断、修改或测试前先完整读取。
  • 按 odai 的真实缺口决定是否读取支撑资料;使用 odai 不等于自动增加计划、路由、角色、文件、测试或流程,简单任务仍直接完成。
  • 对 odai 自身及其配套机制的修改,明确要解决的问题及必须保持的行为,按实际影响选择已有证据。日常维护和发布不默认要求全量题本、A/B、弱模型或多模型裁判;结构调整和文字压缩本身不触发模型评测。只有具体未决问题会改变实现、保留或退役决定时才做最小实验;超时不自动产生重跑任务。
  • 保留保护用户数据、权限、安装恢复、发布契约和已发生缺陷的程序回归;删除只锁定提示措辞、内部排列或固定 token 估算值的断言。文字整理用全文审阅和完整性检查,执行逻辑改动验证受影响的真实行为,不为测试数量或覆盖率补设施。效果或成本改善的公开声明仍须有可比实测证据,未测的不宣称改善;旧结果不自动证明新版本质量。
  • 评测维护、题本设计、裁判与报告整理仍按上述要求治理;真正受测的 runner 则严格服从冻结的评测臂,不继承本节。on 只加载该臂声明的冻结 skill 与项目材料;off 必须在干净隔离环境运行,不读取或注入 odai、.odai/local.md、odai 路由或 Hooks、要求使用 odai 的仓库指令、其他臂输出、既往 runner 转录或其派生状态。

官方 skills 单一事实源

  • skills/odai/、skills/odai-orchestration/、skills/ribao/ 与 skills/renwei/ 是各自唯一可编辑的 source。odai 提供独立治理;odai-orchestration 是单向依赖治理的可选编排技能;ribao 是独立汇报能力;renwei 是独立的去 AI 味表现工艺(文案、图像与视频)。各自通过技能入口安装,不把编排预设或适配器放回治理核心。
  • cli/skills/ 不在仓库中常驻;它只由 npm prepack 临时生成,并在 postpack 清理。
  • 即使用户或 IDE 指向打包期间临时出现的 cli/skills/,也要把对应修改落到仓库根 skills/<name>/。
  • source 修改完成后,运行 node scripts/validate-odai-skill.mjs 验证 canonical skills。
  • canonical references 按单一所有权维护:references/planning.md 只负责正式计划、可执行合同与跨轮续作,references/craft.md 只负责已决定结果的制作工艺,治理 references/leverage.md 负责工具、资料与技能的选择,references/memory.md 负责长期信息、项目叠加层与项目规则和技能的固化;reference 只写入口之外的增量,不复述 SKILL.md。编排技能的 references/orchestration.md 负责职责选择、调度和交接;角色合同只引用对应 owner,不复制另一层的清单或宿主机制。
  • 有来源的操作规则登记在 docs/rule-ledger.md。改写、压缩或重组治理正文时逐条核对账本规则仍在所列 owner 中成立;删改账本规则须在 CHANGELOG 写明问题与理由。
  • odai-cli 未冻结时,发布相关修改还需运行 npm --prefix cli run pack:dry-run,确认产物与当前声明的打包范围一致,且命令结束后没有遗留 cli/skills/;冻结期间遵循下节边界。

odai-cli 冻结边界

  • cli/、plans/odai-cli-plan.md 与 plans/odai-cli-runtime-canary.md 当前冻结,不属于 active canonical / DSH 维护与验收范围。除非用户明确重新开放,不修改、测试、打包、升版或发布 odai-cli,也不为兼容它改变 canonical 或 DSH 路线。
  • 冻结期间,canonical / DSH 变更不运行 CLI tests 或 npm --prefix cli run pack:dry-run;只记录可能影响未来恢复的已知差异。cli/skills/ 仍不得作为可编辑 source 或遗留在仓库中。

Read the full file on GitHub · 41 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +30 tokens per session 6f5646f81f33
  2. 1mo ago Changed · +1 lines · +83 tokens per session 02ff92c820a6
  3. 1mo ago Changed · +106 tokens per session 23af7ec67ebf
  4. 1mo ago Changed · +47 tokens per session 4adaa7fc316e
  5. 1mo ago Changed · +6 lines · +286 tokens per session 394562efd580
  6. 1mo ago First seen · 34 lines · 1,566 tokens per session scan A 53a3a9bf40a4

Subscribe to this mod's changes

odai AGENTS.md is an instructions file published in the GitHub repository orziz/odai (119 stars, last pushed yesterday), licensed MIT. It adds 2,118 tokens to every session, about $0.0085 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,581 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens