MA: Instructions file for Codex

AGENTS.md

MA AGENTS.md is an instructions file for Codex, OpenCode from liuzhengdongfortest/MA. It costs 2,228 tokens per session, scanned A, original, MIT.

Project instructions for a coding agent working on the March project. They define where architecture decisions belong, how features should fit the design, and how the interface should stay restrained.

In plain words
What is it for?
Use them when changing the project, especially before adding features, reorganizing modules, or changing the user interface.
Why use it?
They reduce inconsistent implementation choices by giving the agent one reference for architecture, code comments, and interface conventions.

Instructions file for CodexOpenCode

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

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

Reuse

Borrowing it

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

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

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/liuzhengdongfortest/ma/agents-md"><img src="https://agentmods.dev/badge/instructions/liuzhengdongfortest/ma/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,228 This file is loaded in full into every session.
When invoked 2,228 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.02228 $0.02228
Opus 5 $0.01114 $0.01114
Sonnet 5 $0.00446 $0.00446
Haiku 4.5 $0.00223 $0.00223

Measured 9d ago against content hash 4e608fa52339, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

MA 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 9d 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 · 80 lines

How it starts

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

March — 项目规则

架构中心

codestable/architecture/DESIGN.md 是整个项目的架构权威文档。

  • 所有架构决策、模块划分、数据结构设计,必须能从 codestable/architecture/DESIGN.md 的核心理念中追溯出来
  • 子系统设计(file watcher、context builder、TUI 等)是 codestable/architecture/DESIGN.md 思路的延伸,不是独立存在的
  • 新增功能或改动方向前,先对照 codestable/architecture/DESIGN.md,确认与核心设计一致;若有冲突,先更新 codestable/architecture/DESIGN.md,再动代码
  • 子系统若有独立架构文档,放在 codestable/architecture/ 目录下,并在 codestable/architecture/DESIGN.md 中引用
  • 不要在代码注释或其他文档里另起炉灶地描述架构——架构讨论的落点是 codestable/architecture/
  • 注意区分:codestable/architecture/*.md项目级架构权威(长期存在,跨 feature 共享);codestable/features/{name}/design.md单个 feature 的方案 doc(由 cs-feature 工作流产出,和同目录下的 prd.md / acceptance.md 聚合在一个 feature 目录,生命周期跟随这个 feature)。两者不是同一类文档,不要混
  • 代码实现应保持较丰富的注释,优先解释设计意图、关键流程和不直观的实现细节。

UI 约定

  • 按钮类功能在不影响可理解性的前提下,优先使用 Icon 实现,避免用文字按钮破坏界面密度与整体观感

UI 克制原则

界面默认要克制,不要往用户脸上堆说明文字。 具体落到几件事:

  • 页面 / 区块的标题下面不要默认配一段解释性小字("这里放的是……"、"xx 用来管理……")。标题自己够说明白就不写;一定要说明的,优先用空状态文案、tooltip、或文档承接,不要塞在永久可见位置
  • 已有配置项只渲染"能让用户认出这一项是谁"的最少信息,不要把协议 / URL / Key / 附加元数据全部铺在列表上。详情留给编辑态
  • 列表项的右侧操作区优先用"整行 hover + 点击进入编辑"代替显式"编辑"按钮;只保留破坏性或次级动作(删除、复制等)
  • 新增一个永久可见的文字块、badge、hint 前先问:没有它用户会不会真的用不明白?如果不会,就不加
  • 同一页面里不要出现两段语义高度重叠的描述(比如面包屑级标题旁 + 侧栏顶部各写一句介绍)

视觉 Token 三层体系

样式走 primitive → semantic → component 三层 token,详见 codestable/architecture/design-system.md。写样式前先对照此文档,硬性规则:

  1. 组件 / utility class 里不准写 hex、rgb、rgba、#xxx 颜色字面量,也不准裸写除 0 以外的 px 间距
  2. 消费端(Vue 组件、Tailwind class、@utility)只能引用 semanticcomponent 层 token,不能直接用 primitive(--color-gray-*--color-error 这类原子色)
  3. 主题切换只重写 semantic 层;看到硬编码深色/浅色值(如 rgba(20,20,19,0.94)border-white/8)就是 bug,要改成 semantic token
  4. component 层 token 只在"semantic 组合不出来"时才新增,不要随手造

代码质量

  • 前后端代码都要持续关注可维护性,避免把过多视图、状态、交互逻辑、业务流程、数据转换或基础设施细节堆进单个文件
  • 当单个前端 Vue SFC / 模块,或后端 Rust 模块开始同时承担壳层、业务状态、弹窗流程、应用服务编排、provider 适配、存储读写、数据转换等多种职责时,应主动按职责边界拆分为组件、composable 或独立模块
  • 拆分时优先按职责边界组织代码,避免只为”切文件”而切文件;拆出来的模块命名要清晰,接口要收敛

Read the full file on GitHub · 80 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. 9d ago First seen · 80 lines · 2,228 tokens per session scan A 4e608fa52339

Subscribe to this mod's changes

MA AGENTS.md is an instructions file published in the GitHub repository liuzhengdongfortest/MA (88 stars, last pushed 4mo ago), licensed MIT. It adds 2,228 tokens to every session, about $0.0111 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.

Related

Other instructions, from other repositories

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,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

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 · 6,785 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, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 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,469 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 3,737 tokens