AGENTS.mdA

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

Install it, pinned
mdr add ikalus1988/misakanet/AGENTS.md@git:20261101.ee235a6

Pins git:20261101.ee235a6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
ikalus1988/misakanet
Path
AGENTS.md
Versions recorded
27
Latest version
git:20261101.ee235a6, committed Nov 1, 2026
First version recorded
Sep 11, 2026
Size
17,208 bytes
Repository stars
549
License
Apache-2.0

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

# MisakaNet Agent 规则

> 本文件有**两条主线**,按你的角色选读:
> **(A) 使用方 agent**(来检索/贡献失败知识)→ §1–§5。
> **(B) 在本仓工作的 agent**(改代码/写 lesson/维护 CI)→ §6 红线 + `docs/agents/repo-operations.md`(完整工程手册)。
> 无论哪条,先读 §5 的内容信任边界。

## 1. 🛡️ 崩溃保护(强烈推荐)

```bash
# 用 fatal-guard 包装你的进程,崩溃时自动捕获墓碑
npx @misaka-net/fatal-guard -- <your-command>

# 墓碑自动转为 draft lesson
python3 scripts/tombstone_to_draft.py --from-file tombstone.json

# 或通过管道直连
fatal-guard -- node app.js 2>&1 | python3 scripts/tombstone_to_draft.py --stdin
```

> 崩溃 → 墓碑 JSON → draft lesson → bench-core 动态题库。你的每一次崩溃都在喂养整个网络。

## 2. 核心工作流:遇到问题先检索

> **新用户无需 clone**:加 `--remote` 直接查 D1 服务,免注册、**不限次数**(只有反爬突发保护)。

```bash
python3 search_knowledge.py "你的关键词" --remote   # 远程直查(推荐,无需 clone)
python3 search_knowledge.py "关键词"                # 本地 BM25(需 clone)
python3 search_knowledge.py "关键词" --lessons      # 只看 lessons
python3 search_knowledge.py "关键词" --ref          # 只看 reference
python3 search_knowledge.py "关键词" --titles       # 只看标题
```

Agent 侧更常用 MCP:`misakanet_search` → `misakanet_get_lesson` → (无命中时)
`misakanet_submit_intake`。

## 3. 🔌 MCP 接口:端点 / 工具 / 注册 / streaming

**端点**:`https://misakanet.org/mcp`(MCP **Streamable HTTP** 传输,JSON-RPC 2.0)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ikalus1988/misakanet/AGENTS.md@sha256:77035159abf9d1d5

The line at the top of this page pins the label git:20261101.ee235a6, 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_v5ykjt67uscmoo74.svg)](https://markdownregistry.com/a/art_v5ykjt67uscmoo74)

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

Versions

The registry has recorded 27 versions of this file, between Sep 11, 2026 and Nov 1, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261101.ee235a6 latest2026-11-01 ee235a6 17,208 BA view · diff
git:20261027.e41d3322026-10-27 e41d332 16,931 BA view · diff
git:20261017.913e4ad2026-10-17 913e4ad 16,824 BA view · diff
git:20261016.91744242026-10-16 9174424 16,617 BA view · diff
git:20261016.e54b73e2026-10-16 e54b73e 15,760 BA view · diff
git:20261016.babf2ed2026-10-16 babf2ed 15,532 BA view · diff
git:20261015.24c22592026-10-15 24c2259 15,221 BA view · diff
git:20261007.5517ec22026-10-07 5517ec2 15,039 BA view · diff
git:20261002.2ef46692026-10-02 2ef4669 15,011 BA view · diff
git:20260930.19c02472026-09-30 19c0247 14,951 BA view · diff
git:20260925.96c6bf52026-09-25 96c6bf5 14,547 BA view · diff
git:20260924.bc10eb02026-09-24 bc10eb0 14,097 BA view · diff
git:20260924.1d4a3a12026-09-24 1d4a3a1 13,727 BA view · diff
git:20260919.c3fbf552026-09-19 c3fbf55 13,540 BA view · diff
git:20260919.dc3db362026-09-19 dc3db36 13,388 BA view · diff
git:20260918.445acaf2026-09-18 445acaf 13,135 BA view · diff
git:20260917.c6a900a2026-09-17 c6a900a 13,008 BA view · diff
git:20260915.14a0f592026-09-15 14a0f59 13,009 BA view · diff
git:20260915.9eb171b2026-09-15 9eb171b 12,521 BA view · diff
git:20260915.31850dc2026-09-15 31850dc 12,045 BA view · diff
git:20260913.ab85c612026-09-13 ab85c61 12,046 BA view · diff
git:20260913.e41e4692026-09-13 e41e469 11,678 BA view · diff
git:20260912.227f78f2026-09-12 227f78f 10,631 BA view · diff
git:20260911.462bb962026-09-11 462bb96 10,528 BA view · diff
git:20260911.acd6b3d2026-09-11 acd6b3d 10,109 BA view · diff
git:20260911.d934ec62026-09-11 d934ec6 9,930 BA view · diff
git:20260911.e08dc0a2026-09-11 e08dc0a 13,155 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 (17208 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

ikalus1988/misakanet · 549 stars · license Apache-2.0 · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_v5ykjt67uscmoo74
GET https://markdownregistry.com/api/v1/resolve?ref=ikalus1988/misakanet/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/77035159abf9d1d5c34eab057d46c21ffcff3bf2ef778bcbac2914250e5e3319

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 ikalus1988/misakanet

misakanet-failure-memory Cursor rule
ikalus1988/misakanet · .cursor/rules/misakanet-failure-memory.mdc · Search MisakaNet failure-memory before debugging common errors
git:20260818.224eba9 · audit A · 549 stars
CLAUDE.md CLAUDE.md file
ikalus1988/misakanet · CLAUDE.md
git:20260818.07ea7ee · audit A · 549 stars
misakanet-failure-memory SKILL.md skill
ikalus1988/misakanet · SKILL.md · Search and record failure-recovery lessons from real engineering sessions; submit and verify debugging lessons across…
git:20261016.babf2ed · audit A · 549 stars
llms.txt@docs/.well-known llms.txt file
ikalus1988/misakanet · docs/.well-known/llms.txt
git:20261031.8f0c72d · audit A · 549 stars
llms-full.txt@docs llms.txt file
ikalus1988/misakanet · docs/llms-full.txt
git:20260827.9421f79 · audit A · 549 stars
llms.txt@docs llms.txt file
ikalus1988/misakanet · docs/llms.txt
git:20261031.8f0c72d · audit A · 549 stars
llms.txt llms.txt file
ikalus1988/misakanet · llms.txt
git:20260920.96a3a46 · audit A · 549 stars
misakanet-failure-memory SKILL.md skill
ikalus1988/misakanet · skills/misakanet/SKILL.md · Search and record failure-recovery lessons from real engineering sessions; submit and verify debugging lessons across…
git:20261016.babf2ed · audit A · 549 stars

Every file in ikalus1988/misakanet

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261101.d684125 · audit A · 417,919 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 309,852 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 293,827 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 198,353 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 182,080 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 139,879 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261027.a50cf58 · audit A · 138,879 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 116,476 stars

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