EasyCode AGENTS.md

A set of project instructions for OrionStarAI/EasyCode. It requires test-driven development (TDD) for command-line and core modules: write tests first, implement the code, then improve it.

In plain words
What is it for?
Use it when developing or reviewing the project's CLI and core packages, especially code with branching logic, state, data conversion, or business rules.
Why use it?
It makes expected behavior clear before coding and helps prevent later changes from breaking existing behavior. It also explains when tests may reasonably be skipped.

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/orionstarai/easycode/agents-md
Clone the repo
git clone --depth 1 https://github.com/OrionStarAI/EasyCode

Made for: Codex, OpenCode.

Per session 278 This file is loaded in full into every session.
When invoked 278 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.00278 $0.00278
Opus 5 $0.00139 $0.00139
Sonnet 5 $0.00056 $0.00056
Haiku 4.5 $0.00028 $0.00028

Measured 2d ago against content hash b3f1bebe0c16, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

EasyCode 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 2d 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 · 26 lines

What it actually says

AGENTS.md

本文档定义 AI Agent 在本项目中工作时必须遵守的规则。

规则

1. CLI / Core 模块开发:测试驱动开发(TDD)【最重要】

packages/clipackages/core 中开发需求时,必须采用 TDD 模式

  1. 先写测试 —— 明确预期行为,定义输入输出
  2. 再写实现 —— 让测试通过
  3. 重构 —— 在测试保护下优化代码

例外情况(可 skip 测试):

  • 纯 UI 渲染逻辑(Ink 组件的视觉效果)
  • 与终端交互、TTY 行为强相关的代码
  • 第三方 SDK 的简单透传调用
  • 一次性脚本、临时调试代码
  • 难以 mock 的系统级 IO(如真实文件系统、网络底层)

不必教条。当某段逻辑确实难以测试、或测试成本远高于价值时,可以跳过,但需要在 PR/commit 说明中简要注明原因。

判断标准: 如果一段逻辑包含分支、状态、数据转换或业务规则 —— 必须有测试。

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. 2d ago First seen · 26 lines · 278 tokens per session scan A b3f1bebe0c16

Subscribe to this mod's changes

EasyCode AGENTS.md is an instructions file published in the GitHub repository OrionStarAI/EasyCode (421 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 278 tokens to every session, about $0.0014 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