ai-mind: Instructions file for Codex

AGENTS.md

ai-mind AGENTS.md is an instructions file for Codex, OpenCode from HWYD/ai-mind. It costs 3,698 tokens per session, scanned A, original, MIT.

A set of project instructions for AI Mind, an AI-focused software project that is developed in versions over time. They define how to preserve one shared specification workspace and which sources of project information to trust first.

In plain words
What is it for?
Use them when changing AI Mind’s runtime, protocols, tools, skills, integrations, agents, persistence, or other versioned project capabilities.
Why use it?
They prevent conflicting specification folders and help coding agents continue work from the project’s current version, decisions, code, tests, and documentation.

Instructions file for CodexOpenCode

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

This is HWYD/ai-mind's own configuration. It tells Codex and OpenCode how to work on ai-mind 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 ai-mind configures →

View source ↗ HWYD/ai-mind
Reuse

Borrowing it

Nothing to install: this file belongs to HWYD/ai-mind. 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/HWYD/ai-mind/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/HWYD/ai-mind

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 ai-mind AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hwyd/ai-mind/agents-md/github.svg)](https://agentmods.dev/instructions/hwyd/ai-mind/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/hwyd/ai-mind/agents-md"><img src="https://agentmods.dev/badge/instructions/hwyd/ai-mind/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 ai-mind AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hwyd/ai-mind/agents-md"><img src="https://agentmods.dev/badge/instructions/hwyd/ai-mind/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 3,698 This file is loaded in full into every session.
When invoked 3,698 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.03698 $0.03698
Opus 5.5 $0.01479 $0.01479
Sonnet 5.5 $0.00740 $0.00740
Haiku 4.5 $0.00370 $0.00370

Measured 1mo ago against content hash ee779d47413a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

ai-mind 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 1mo ago.

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 · 209 lines

How it starts

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

AGENTS

Version Spec Workspace Continuity (Mandatory)

  • 同一未收口版本只允许一个 canonical specs/ 工作区。当前版本尚未完成 release closing / merge,尤其代码或规格仍有未提交变更时,所有需求、方案、冲突决策和实现任务 MUST 继续写入 .specify/feature.json 指向的当前目录。
  • 禁止因为返工、主题变化或方案冲突创建 vX.Y.Z-1-*、vX.Y.Z-2-* 等 sibling spec directory。只有用户明确声明独立 follow-up,或基准版本已经 release closing 并进入新的开发窗口,才允许创建挂靠目录。
  • 新决定覆盖旧决定时,必须在同一 canonical 工作区更新 spec.md、plan.md、tasks.md、data-model.md、contracts/ 和 decisions.md(如存在),删除、改写或标记 superseded 的旧决策;不要通过新目录并存两套事实。
  • 运行 speckit-specify、speckit-plan、speckit-tasks、speckit-implement、speckit-analyze 或 speckit-converge 前,先读取 .specify/feature.json 和当前 managed plan 指针;同一 semver 已有 canonical directory 时 MUST 复用它。需要新目录时,必须先取得用户对“独立 follow-up”的明确授权并说明边界。

项目定位

AI Mind 是一个按版本持续演进的 AI Native 工程项目。

它不是一次性做完的产品,而是一套逐步生长的 Runtime Skeleton。

建议始终按这条主线理解项目演进:

  1. 本地聊天闭环
  2. 结构化流式协议
  3. Tool Calling
  4. Multi-Tool Runtime
  5. Skill Runtime
  6. MCP 能力接入
  7. Agent Runtime
  8. 持久化与数据层
  9. 更完整的生产化能力

事实来源优先级

涉及版本实现、架构边界或阶段验收时,按下面顺序判断事实:

  1. 用户明确指定的版本、Step、文件或验收要求
  2. 当前代码、测试与运行脚本
  3. .specify/memory/constitution.md
  4. 当前 feature / version 对应的 specs/
  5. docs/adr/ 与 docs/architecture/
  6. README.md、docs/versions/、docs/releases/、docs/tasklists/
  7. private-folder/ 仅在用户明确要求、或需要回看草稿 / 历史过程 / 个人内部材料时读取

说明:

  • specs/ 是 Level C / Level D 变更的正式 AI coding 工作区,承接 spec / plan / tasks / acceptance / decisions;版本工作区目录优先采用 v0.4.10-feature-slug 这类真实 semver 前缀命名。挂靠规格只有在基准版本 release closing 后或用户明确授权独立 follow-up 时才可用,规则见 docs/architecture/spec-directory-naming.md。
  • docs/adr/ 和 docs/architecture/ 是长期架构约束区,不只是展示文档。
  • docs/versions/、docs/releases/、docs/tasklists/ 是公开展示区,不是默认开发任务源。
  • private-folder/ 是草稿、历史、个人内部材料和博客 / 面试素材区,不是默认开发事实源。
  • tasklist 的 [x] 是开发记录,不单独构成完成证据;仍要看 spec、实现、测试和实际 diff。

事实与方案正确性

“事实来源优先级”用于确认当前项目状态、既有约束和兼容性,不表示当前代码、spec、决策或历史实现天然正确。

  • 用户明确指定的不可变需求、外部契约、安全边界与合规要求必须遵守,只评估可行性和风险,不将其改写为替代候选。
  • 当任务要求调研最佳实践、替代方案,或触及架构、依赖、安全、性能、可靠性等重要选择时,现有代码、测试、spec、plan、decisions、ADR 与 architecture docs 必须作为候选基线之一,而不是默认答案。
  • 比较结论至少说明需求匹配、架构边界、安全、兼容性、可运维性、验证成本和迁移风险;保留既有方案也必须记录比较依据。
  • 结论写入当前 canonical workspace 的 research.md、decisions.md 或等价交付记录。若改变既有决策,在同一工作区同步更新受影响资产,并将旧决策删除、改写或标记为 superseded。
  • Level A / B 局部改动不强制重研;仅在明确请求调研或上述重要选择触发时执行。

Read the full file on GitHub · 209 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. 1mo ago Changed ee779d47413a
  2. 1mo ago Changed bbbf7a2c3761
  3. 1mo ago Changed · +20 lines · +529 tokens per session 3446dd4ad8c2
  4. 2mo ago Changed · +1 tokens per session 271b775d5e48
  5. 2mo ago Changed · -2 tokens per session 1a8184c4281a
  6. 2mo ago First seen · 189 lines · 3,170 tokens per session scan A 619bc18b53fa

Subscribe to this mod's changes

ai-mind AGENTS.md is an instructions file published in the GitHub repository HWYD/ai-mind (21 stars, last pushed 1mo ago), licensed MIT. It adds 3,698 tokens to every session, about $0.0148 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

ai-mind AGENTS.md compared with instructions from other repositories

ai-mind AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
ai-mind AGENTS.mdHWYD/ai-mindInstructions file211mo agoMITA3,698Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode