DESIGN.md@crates/yuenB
DESIGN.md@crates/yuen from i2y/ritsu is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add i2y/ritsu/crates/yuen/DESIGN.md@git:20261105.54d3620Pins git:20261105.54d3620 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 13 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- i2y/ritsu
- Path
crates/yuen/DESIGN.md- Versions recorded
- 8
- Latest version
- git:20261105.54d3620, committed Nov 5, 2026
- First version recorded
- Oct 10, 2026
- Size
- 296,153 bytes
- Repository stars
- 3
- 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
# yuen 設計文書 要件や仕様の来歴を書く小さな言語。ファイルは `.req`、コマンドは `yuen`。要件ごとに、どの出典（法令の条や文書）から来たか、誰がいつなぜそう決めたか、どの成果物が満たし、どの主張が確かめているかを書く。リンクは、人が確かめたときの両端のハッシュを持つ。出典の条、要件の文、成果物の定義のどれかが変われば、そのリンクとその先のリンクに印が付き、人が確かめ直すまで `yuen check` が止める。 名前は「ゆえん」から取った。由縁（物事のいわれ、つながり）とも、所以（わけ、根拠）とも書く。要件がどこから来たかを書き、満たすものにつなぎ、根拠が変われば止める言語なので、どちらの字の意味も合う。はじめは由来（ゆらい）から取って yurai としたが、crates.io の `yurai` が近い分野の別のツール（AI のモデルの来歴を調べるもの）なので、ritsu に取り込んだあとで yuen に改めた（ritsu の DESIGN.md 2.2）。拡張子 `.req` は変えていない。 この文書は段階 A（設計）で書き、段階 B（言語の芯）で、B が作ったコマンド（`check`、`review`、`trace`、`api`、`explain`）の出力を実物に差し替えた（4.3、5.1、6.3、9 章。どれもテストが走らせて照らし合わせる）。段階 C のうち書き出しと出典のコマンドを作ったところで、12〜14 章を実物にした（13 章の PROV-N はテストが走らせて照らし合わせ、12 章の ReqIF はテストの golden から引き、14 章の `outdated` は本物の e-Gov に一度問い合わせた出力を貼った）。段階 C の残り（一式の読み込み）は、yuen が ritsu（七つの言語を一つにまとめる処理系）に取り込まれたので、子プロセスと JSON ではなく ritsu の口（ritsu の DESIGN 3.2）で作った（ritsu の PLAN の D.7）。そこで 3 章を書き直し、8 章の affected と 11 章の api を実物にした（8 章の出力はテストが走らせて照らし合わせる）。A の段階でほかのツール（rulec 0.22.1、koyomi 0.1.0、chobo 0.1.0、geas 0.0.1）の出力、xmllint と Python の `prov`・`reqif` の振る舞いを、2026-10-03 にこの機械で実際に走らせて確かめたことは、19 章にそのまま残した。要件の端のハッシュの値（1.1、4.1）は、この文書の定義どおりに組んだ使い捨ての試作（Python）で計算したもので、段階 B の yuen は同じ値を出した（PLAN… …
Read the whole file at its exact version.
How to install
mdr add i2y/ritsu/crates/yuen/DESIGN.md@sha256:680007faa3e5d4dfThe line at the top of this page pins the label git:20261105.54d3620, 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_3op63kqqti3ktik4)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 8 versions of this file, between Oct 10, 2026 and Nov 5, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261105.54d3620 latest | 2026-11-05 | 54d3620 | 296,153 B | B | view · diff |
| git:20261101.92f8a7b | 2026-11-01 | 92f8a7b | 295,997 B | B | view · diff |
| git:20261031.76f9a81 | 2026-10-31 | 76f9a81 | 295,833 B | B | view · diff |
| git:20261029.4321eaf | 2026-10-29 | 4321eaf | 293,842 B | B | view · diff |
| git:20261022.8b896af | 2026-10-22 | 8b896af | 293,783 B | B | view · diff |
| git:20261021.f01afa7 | 2026-10-21 | f01afa7 | 293,764 B | B | view · diff |
| git:20261018.2c0626d | 2026-10-18 | 2c0626d | 281,744 B | B | view · diff |
| git:20261010.8872deb | 2026-10-10 | 8872deb | 278,757 B | B | view |
Audit of the latest version
- fail: Size between 200 bytes and 200 KB (296153 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
Starting a new one? Use a template for DESIGN.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
i2y/ritsu · 3 stars · license Apache-2.0 · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_3op63kqqti3ktik4 GET https://markdownregistry.com/api/v1/resolve?ref=i2y/ritsu/crates/yuen/DESIGN.md GET https://markdownregistry.com/api/v1/blob/680007faa3e5d4dff064690e36e68653b7016416dd057c933e6f136f70bc735d
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: what DESIGN.md is and how agents use it · which agent file does what.