ANWS 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

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/haaaiawd/anws/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.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.svg" alt="Measured on agentmods" 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. Scan, not verified.
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 $0.02039 $0.02039
Opus 5 $0.01019 $0.01019
Sonnet 5 $0.00408 $0.00408
Haiku 4.5 $0.00204 $0.00204

Measured 4d ago against content hash 8cad7d6d4c11, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 4d 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. 4d 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 (142 stars, last pushed 3mo ago), licensed MIT. It adds 2,039 tokens to every session, about $0.0102 per session on Opus 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.