ANWS: Instructions file for Codex

AGENTS.md

ANWS AGENTS.md is an instructions file for Codex, OpenCode from Haaaiawd/ANWS. It costs 2,039 tokens per session, scanned A, original, MIT.

A project guide that tells AI coding agents how to recover context, navigate the codebase and follow required workflows. It uses versioned architecture files and an upgrade history to record the project’s current state.

In plain words
What is it for?
Use it to find the latest architecture, task and verification files, understand which directories are editable, and identify workflows or skills that must be followed.
Why use it?
It reduces confusion when an agent starts a new session or works in a large project with strict procedures.

Instructions file for CodexOpenCode

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

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

Reuse

Borrowing it

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

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 ANWS AGENTS.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/haaaiawd/anws/agents-md"><img src="https://agentmods.dev/badge/instructions/haaaiawd/anws/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,039 This file is loaded in full into every session.
When invoked 2,039 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.02039 $0.02039
Opus 5.5 $0.00816 $0.00816
Sonnet 5.5 $0.00408 $0.00408
Haiku 4.5 $0.00204 $0.00204

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

Security

Grade A, and why

ANWS 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 2mo 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 · 158 lines

How it starts

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

AGENTS.md - AI 协作协议

"如果你正在阅读此文档,你就是那个智能体 (The Intelligence)。"

这个文件是你的锚点 (Anchor)。它定义了项目的法则、领地的地图,以及记忆协议。 当你唤醒(开始新会话)时,请首先阅读此文件。


🧠 30秒恢复协议 (Quick Recovery)

当你开始新会话或感到"迷失"时,立即执行:

  1. 读取根目录的 AGENTS.md → 获取项目地图
  2. 查看下方"当前状态" → 找到最新架构版本
  3. 读取 .anws/v{N}/05A_TASKS.md + .anws/v{N}/05B_VERIFICATION_PLAN.md → 了解执行待办与验证承诺
  4. 开始工作

🗺️ 地图 (领地感知)

以下是这个项目的组织方式:

路径 描述 访问协议
src/ 实现层。实际的代码库。 通过 Task 读/写。
.anws/ 统一架构根目录。包含版本化架构状态与升级记录。 只读(旧版) / 写一次(新版) / changelog 由 CLI 维护。
.anws/v{N}/ 当前真理。最新的架构定义。 永远寻找最大的 v{N}。
.anws/changelog/ 升级记录。anws update 生成的变更记录。 由 CLI 自动维护,请勿删除。
target-specific workflow projection 工作流。/genesis, /blueprint 等。 读取当前 target 对应的原生投影文件。
target-specific skill projection 技能库。原子能力。 调用当前 target 对应的原生投影文件。
.nexus-map/ 知识库。代码库结构映射。 由 nexus-mapper 生成。

🛠️ 工作流注册表

[!IMPORTANT] 工作流优先原则:当任务匹配某个工作流,或你判断当前任务明显符合、基本符合、甚至只是疑似符合某个工作流的适用场景时,都必须先读取相应文件,并严格遵循其中的步骤执行。工作流是经过精心设计的协议,而非可选参考。

触发流程:

  1. 用户提及工作流名称,或你判断当前任务明显符合、基本符合、甚至只是疑似符合某个工作流的适用场景时,都必须先读取相应文件
  2. 立即读取 相应工作流文件
  3. 严格遵循工作流中的步骤执行
  4. 在检查点暂停等待用户确认
工作流 触发时机 产出
/quickstart 新用户入口 / 不知道从哪开始 编排其他工作流
/genesis 新项目 / 重大重构 PRD, Architecture, ADRs
/probe 变更前 / 接手项目 .anws/v{N}/00_PROBE_REPORT.md
/design-system genesis 后 04_SYSTEM_DESIGN/*.md
/blueprint genesis 后 05A_TASKS.md + 05B_VERIFICATION_PLAN.md + AGENTS.md 初始 Wave
/change 微调已有任务 更新 05A/05B + SYSTEM_DESIGN (仅修改) + CHANGELOG
/explore 调研时 探索报告
/challenge 决策前质疑 07_CHALLENGE_REPORT.md (含问题总览目录)
/forge 编码执行 代码 + 更新 AGENTS.md Wave 块
/craft 创建工作流/技能/提示词 Workflow / Skill / Prompt 文档
/upgrade anws update 后做升级编排 判断 Minor / Major,并路由到 /change 或 /genesis

Read the full file on GitHub · 158 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. 2mo ago First seen · 158 lines · 2,039 tokens per session scan A 8cad7d6d4c11

Subscribe to this mod's changes

ANWS AGENTS.md is an instructions file published in the GitHub repository Haaaiawd/ANWS (140 stars, last pushed 5mo ago), licensed MIT. It adds 2,039 tokens to every session, about $0.0082 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

ANWS AGENTS.md compared with instructions from other repositories

ANWS AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
ANWS AGENTS.mdHaaaiawd/ANWSInstructions file1405mo agoMITA2,039Codex, 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