AGENTS.mdA
AGENTS.md from kittors/lyra is an AGENTS.md file: the standing instructions coding agents read in that repo.
mdr add kittors/lyra/AGENTS.md@git:20261014.6ad6e5fPins git:20261014.6ad6e5f in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- AGENTS.md file
- Repository
- kittors/lyra
- Path
AGENTS.md- Versions recorded
- 32
- Latest version
- git:20261014.6ad6e5f, committed Oct 14, 2026
- First version recorded
- Aug 19, 2026
- Size
- 22,267 bytes
- Repository stars
- 49
- License
- MIT
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
# 给在这个仓库里干活的 agent 这份文件写给自动化——包括本仓库自带的那个 agent，以及任何被叫来改这份代码的模型。 人要看的东西在 [CONTRIBUTING.md](CONTRIBUTING.md)。 ## 一句话 Lyra 是一个 agent 运行时加两个前端。`packages/core` 平台无关，桌面端（Electron） 和移动端（Expo）驱动同一个 `AgentSession`。 ## 第一原则 **一、准确完成用户要的那件事。二、在做到第一条的前提下，更快、更省 token。** 顺序不能反。为了省 token 而少做、做错、半途停下，是把第一条丢了去换第二条——那不是优化， 是失败。反过来，第一条做到了之后，快和省就是这个产品的全部竞争力：同一件事，别人要三十轮、 五百万 token，我们要十轮、五十万。 这条原则在设计上意味着几件具体的事： - **别让循环替人做决定。** 「它是不是卡住了」这个判断没有可靠信号——试过两次，两次都误伤真实 工作（见 `packages/core/src/agent/repetition.ts` 顶上那段教训）。能确定的事才自动处理， 不确定的交给人。 - **拦不如纠正。** 发现模型在原地打转时，第一反应是给它一句具体的、能据以改变行为的话，而不是 直接结束这一轮。停下来既没告诉它该怎么办，也没把等结果的人放出来。 - **纠正无效才停。** 纠正过了还在重复，那就是真的走不下去了，继续跑只是烧钱——这时停是在执行 第二条原则，不是违背第一条。 - **不要在对话里念账单。** 花销属于设置页。用户要的是任务跑完，不是每隔几轮被提醒一次花了多少。 - **先量再改。** 上面两次误伤的共同点是没有先量。`pnpm audit:sessions` 会在本机的真实会话上 跑一遍成本体检，任何动到循环、截断、停止条件的改动，改前改后各跑一次、拿两份输出对照。 不确定某个机制该怎么设计时，先去看 `opencode`、`pi`、`oh-my-pi`、`deepseek-harness` 这些开源 agent 是怎么做的，再动手。这类问题它们大多已经踩过一遍。 具体该改什么、怎么验，见 [agent 的成本结构与停止机制](docs/architecture/agent-cost-and-stopping.md)——那份清单里的每一条 都配着实测数字和验收标准。 ## 干活的方式 上面那条原则管的是产品怎么设计，这一节管的是**你自己**怎么花时间。三条都是从实际跑坏的会话 里总结的，每条都直接对应一段被浪费掉的上下文。 ### 新界面要的文案，直接加词条，不要全库去找 …
Read the whole file at its exact version.
How to install
mdr add kittors/lyra/AGENTS.md@sha256:680ae1e0b67f975cThe line at the top of this page pins the label git:20261014.6ad6e5f, 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.
[](https://markdownregistry.com/a/art_tjbv3gc624da7ny6)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 32 versions of this file, between Aug 19, 2026 and Oct 14, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261014.6ad6e5f latest | 2026-10-14 | 6ad6e5f | 22,267 B | A | view · diff |
| git:20261014.24566a4 | 2026-10-14 | 24566a4 | 22,267 B | A | view · diff |
| git:20261014.2396c47 | 2026-10-14 | 2396c47 | 20,047 B | A | view · diff |
| git:20261013.ae45797 | 2026-10-13 | ae45797 | 20,047 B | A | view · diff |
| git:20261013.c1a5d03 | 2026-10-13 | c1a5d03 | 20,047 B | A | view · diff |
| git:20261012.1c2b9c6 | 2026-10-12 | 1c2b9c6 | 20,047 B | A | view · diff |
| git:20261012.2d2bb60 | 2026-10-12 | 2d2bb60 | 20,047 B | A | view · diff |
| git:20260928.6f997f8 | 2026-09-28 | 6f997f8 | 20,016 B | A | view · diff |
| git:20260927.82f4bc0 | 2026-09-27 | 82f4bc0 | 20,016 B | A | view · diff |
| git:20260921.83099e4 | 2026-09-21 | 83099e4 | 20,016 B | A | view · diff |
| git:20260920.afdbd56 | 2026-09-20 | afdbd56 | 20,016 B | A | view · diff |
| git:20260919.abf881a | 2026-09-19 | abf881a | 17,773 B | A | view · diff |
| git:20260919.c234fff | 2026-09-19 | c234fff | 17,773 B | A | view · diff |
| git:20260919.e64b91c | 2026-09-19 | e64b91c | 15,268 B | A | view · diff |
| git:20260919.2fc7f7d | 2026-09-19 | 2fc7f7d | 15,268 B | A | view · diff |
| git:20260918.edf328f | 2026-09-18 | edf328f | 15,247 B | A | view · diff |
| git:20260916.d6c6ba1 | 2026-09-16 | d6c6ba1 | 15,247 B | A | view · diff |
| git:20260916.b72ee2d | 2026-09-16 | b72ee2d | 14,796 B | A | view · diff |
| git:20260913.79efd6e | 2026-09-13 | 79efd6e | 13,256 B | A | view · diff |
| git:20260913.482c5d4 | 2026-09-13 | 482c5d4 | 13,087 B | A | view · diff |
| git:20260913.baa508e | 2026-09-13 | baa508e | 13,087 B | A | view · diff |
| git:20260912.0fbd3db | 2026-09-12 | 0fbd3db | 13,087 B | A | view · diff |
| git:20260912.5fed9aa | 2026-09-12 | 5fed9aa | 13,059 B | A | view · diff |
| git:20260912.7f01766 | 2026-09-12 | 7f01766 | 12,002 B | A | view · diff |
| git:20260912.3545aa7 | 2026-09-12 | 3545aa7 | 11,917 B | A | view · diff |
| git:20260911.90d2237 | 2026-09-11 | 90d2237 | 11,926 B | A | view · diff |
| git:20260911.dce4b2b | 2026-09-11 | dce4b2b | 10,796 B | A | view · diff |
| git:20260903.532b1ac | 2026-09-03 | 532b1ac | 8,763 B | A | view · diff |
| git:20260903.00f1a9c | 2026-09-03 | 00f1a9c | 8,338 B | A | view · diff |
| git:20260903.6775466 | 2026-09-03 | 6775466 | 7,775 B | A | view · diff |
| git:20260827.0cd5183 | 2026-08-27 | 0cd5183 | 6,892 B | A | view · diff |
| git:20260819.7b9650f | 2026-08-19 | 7b9650f | 6,629 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (22267 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
kittors/lyra · 49 stars · license MIT · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_tjbv3gc624da7ny6 GET https://markdownregistry.com/api/v1/resolve?ref=kittors/lyra/AGENTS.md GET https://markdownregistry.com/api/v1/blob/680ae1e0b67f975ca4991a0520f7c2a7226120a36755e80c5353d1cbc2f1f3bc
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.