AGENTS.mdA

AGENTS.md from icetomoyo/kodax is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add icetomoyo/kodax/AGENTS.md@git:20261020.ba4d703

Pins git:20261020.ba4d703 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
icetomoyo/kodax
Path
AGENTS.md
Versions recorded
10
Latest version
git:20261020.ba4d703, committed Oct 20, 2026
First version recorded
Jun 13, 2026
Size
4,774 bytes
Repository stars
14
License
a license file GitHub does not identify

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# KodaX Development Rules

Spend time on thinking. DO NOT send optional commentary.

---

**⚠️ CORE PHILOSOPHY: Minimalist & Intelligent**

> **Add code cautiously** — Before adding: Is it necessary? Is it minimal? Is it LLM-friendly?
> **Avoid over-engineering** — Requirements are the measure: fully meet functional & performance needs, add nothing beyond them.
> **Leverage LLM intelligence** — Design for LLM comprehension. Use LLM for generation, review, and testing.

**KodaX 极致轻量化** — every package is independently usable.

---

## First Message
If the user did not give a concrete task, read `README.md`, then check `docs/` for context:
- `docs/PRD.md` — product requirements
- `docs/ADR.md` — architecture decisions
- `docs/FEATURE_LIST.md` — feature planning

## Code Addition Discipline

**Before adding code, ask**:
1. Is it **necessary**? Can existing code solve it?
2. Is it the **minimal** solution? Can I do the same with less?
3. Is it **LLM-friendly**? Can an LLM understand and extend it?

**Rules**:
- ❌ NEVER add "flexibility" for hypothetical futures (YAGNI)
- ❌ NEVER add config options unless required
- ❌ NEVER deep inheritance / nested factories / sprawling state machines
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add icetomoyo/kodax/AGENTS.md@sha256:5e96a94604b1f5c5

The line at the top of this page pins the label git:20261020.ba4d703, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6akawxxjlfyuetbb.svg)](https://markdownregistry.com/a/art_6akawxxjlfyuetbb)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Jun 13, 2026 and Oct 20, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261020.ba4d703 latest2026-10-20 ba4d703 4,774 BA view · diff
git:20261018.b0b446e2026-10-18 b0b446e 4,660 BA view · diff
git:20261014.351e8672026-10-14 351e867 4,421 BA view · diff
git:20260928.53debfd2026-09-28 53debfd 4,174 BA view · diff
git:20260928.1031ab22026-09-28 1031ab2 4,174 BA view · diff
git:20260804.fd115e42026-08-04 fd115e4 5,083 BA view · diff
git:20260720.7175fac2026-07-20 7175fac 5,098 BA view · diff
git:20260628.7bd872d2026-06-28 7bd872d 5,098 BA view · diff
git:20260617.5b4499a2026-06-17 5b4499a 5,093 BA view · diff
git:20260613.853a0bd2026-06-13 853a0bd 5,093 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (4774 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

icetomoyo/kodax · 14 stars · license a license file GitHub does not identify · pushed 2026-11-06 · branch KodaX

API

GET https://markdownregistry.com/api/v1/artifacts/art_6akawxxjlfyuetbb
GET https://markdownregistry.com/api/v1/resolve?ref=icetomoyo/kodax/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/5e96a94604b1f5c51200115692a9b64471a3306f99f423ae54862c735192ed83

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from icetomoyo/kodax

CLAUDE.md CLAUDE.md file
icetomoyo/kodax · CLAUDE.md
git:20261029.b9a503e · audit A · 14 stars
CLAUDE.md@docs CLAUDE.md file
icetomoyo/kodax · docs/CLAUDE.md
git:20261029.b9a503e · audit A · 14 stars
code-review SKILL.md skill
icetomoyo/kodax · packages/agent/src/capabilities/skills/builtin/code-review/SKILL.md · 审查代码、diff、提交或当前 git 改动,重点发现 bug、行为回归、边界条件遗漏、安全风险、性能问题和缺失测试。当用户提到 code review、review 这段代码、帮我看看改动有没有问题、审查…
git:20261027.3a32e04 · audit A · 14 stars
git-workflow SKILL.md skill
icetomoyo/kodax · packages/agent/src/capabilities/skills/builtin/git-workflow/SKILL.md · 执行明确的 Git 操作,例如查看状态、提交、建分支、push、stash 或创建 PR。只有在用户明确要求实际执行这些 Git 操作时才使用;不要用于单纯解释 Git 概念或讨论策略。
git:20261027.3a32e04 · audit A · 14 stars
skill-creator SKILL.md skill
icetomoyo/kodax · packages/agent/src/capabilities/skills/builtin/skill-creator/SKILL.md · 创建、修改、迁移、验证或打包 Skill,或优化其描述与评测时使用;也用于把已有工作流沉淀成可反复调用的代理能力。不用于普通一次性写作、代码实现或仅使用某项既有 Skill 完成业务任务。
git:20261027.3a32e04 · audit A · 14 stars
tdd SKILL.md skill
icetomoyo/kodax · packages/agent/src/capabilities/skills/builtin/tdd/SKILL.md · 测试先行实现或修 bug、补回归测试,或为已有正确实现补充行为测试时使用。按用户范围区分实现改动与仅补测试;不用于只解释测试概念、解读报错或未要求测试工作的普通讨论。
git:20261027.3a32e04 · audit A · 14 stars
visual-review SKILL.md skill
icetomoyo/kodax · packages/agent/src/capabilities/skills/builtin/visual-review/SKILL.md · 创建、修改或审查视觉结果时使用;包括检查网页/应用界面的布局与可读性、图像/图表、文档/幻灯片/表格、终端/Canvas/3D,以及视频/GIF/动画的字幕、转场和播放效果。用户要求截图、渲染或逐帧证据时也适用。提供通用视觉取证方法;art…
git:20261027.3a32e04 · audit A · 14 stars
artifact-review SKILL.md skill
icetomoyo/kodax · packages/artifacts/skills/artifact-review/SKILL.md · Use already registered Artifact tools to create/edit PPTX or render and inspect supported PPTX, PDF, DOCX and image…
git:20261027.3a32e04 · audit A · 14 stars

Every file in icetomoyo/kodax

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.