DESIGN.mdF
DESIGN.md from i2y/ritsu is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add i2y/ritsu/DESIGN.md@git:20261107.d281d9cPins git:20261107.d281d9c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- F, 10 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- i2y/ritsu
- Path
DESIGN.md- Versions recorded
- 15
- Latest version
- git:20261107.d281d9c, committed Nov 7, 2026
- First version recorded
- Oct 29, 2026
- Size
- 1,196,467 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
# ritsu 設計文書 九つの小さな言語（rulec、dandori、koyomi、chobo、geas、yuen、sakai、sekisho、kaname）を、一つのリポジトリの一つの処理系にまとめる。言語は分けたまま残し、土台（診断、二つの言語の文、出典、参照、doc のページの枠、テストの共通部分）、単位の型、プロジェクトの読み込み、CLI、バージョン、Lean の層を一つにする。目的は、ある言語が確かめたことを、隣の言語が型の付いたまま受け取れるようにすることである。2026-10-06 に八つ目の言語 sekisho（認可。`.gate`）を、2026-10-18 に九つ目の言語 kaname（Functional Core を書く小さな汎用の言語。`.kn`）を足した。どちらも ritsu の中で新しく書いた言語で、設計は `crates/sekisho/DESIGN.md` と `crates/kaname/DESIGN.md` にある。 名前は律（りつ）から取った。 この文書は段階 A（設計）で書き、段階 C の最初の部分で、決めたこと（★だった項目）、yuen への改名（2.2）、作った土台の形（4.12）とテストの道具の形（10.9）を書き足した。段階 D の最初の部分で、口の実物（3.2）、rulec の言語をスレッドごとに持つこと（4.1）、rulec と dandori の `.proto` の読み手（4.13）、単位の型の実物（5.1、5.2）を書き足した。1 章の行数と数、1.4 と 12.5 の出力は、2026-10-03 にこの機械（macOS arm64、rustc 1.94.1）で、各リポジトリを読み、作業場所にコピーしたものを走らせて取った。元のリポジトリでは何もビルドしていない。各リポジトリのテストの件数と時間のうち、ここで走らせていないものは、それぞれの最後の記録から引き、そう書いた。段階 E と F の記録（2026-10-04）から、口の問い（3.2）、ファイルの読み書きの入口（4.15）、言語をまたぐ検査の作った形と台帳（7 章）、`ritsu run`（7.9）、ブラウザで試すページ（8.7）、`ritsu gen` と生成物の頭（9 章）、英語の版と日本語の版（10.10、10.11）、Lean の層（11 章）、リリースの準備（13 章）、F.1〜F.3 の yuen と sakai の doc（4.8）、入れ方（8.2、13.2）、根の README とスキルの確かめ（10.12）、同じ日にあとから入れたこと（X4 の額 0 は 7.6 と 11.2、サイトの移動と `repository` は 13.2、rulec の英語のページと台帳と出力は… …
Read the whole file at its exact version.
How to install
mdr add i2y/ritsu/DESIGN.md@sha256:c8cc6e0f2809eae5The line at the top of this page pins the label git:20261107.d281d9c, 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_ckrxr3ssxfu64q2e)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 15 versions of this file, between Oct 29, 2026 and Nov 7, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261107.d281d9c latest | 2026-11-07 | d281d9c | 1,196,467 B | F | view · diff |
| git:20261106.34164c4 | 2026-11-06 | 34164c4 | 1,195,784 B | F | view · diff |
| git:20261106.83b54a5 | 2026-11-06 | 83b54a5 | 1,196,279 B | F | view · diff |
| git:20261106.845bba7 | 2026-11-06 | 845bba7 | 1,196,467 B | F | view · diff |
| git:20261105.04ff237 | 2026-11-05 | 04ff237 | 1,195,719 B | F | view · diff |
| git:20261101.92f8a7b | 2026-11-01 | 92f8a7b | 1,129,825 B | F | view · diff |
| git:20261101.f948620 | 2026-11-01 | f948620 | 1,129,095 B | F | view · diff |
| git:20261031.8815ba1 | 2026-10-31 | 8815ba1 | 1,128,294 B | F | view · diff |
| git:20261031.fbfaec0 | 2026-10-31 | fbfaec0 | 1,126,673 B | F | view · diff |
| git:20261031.e0bec7c | 2026-10-31 | e0bec7c | 1,126,673 B | F | view · diff |
| git:20261030.77e84d4 | 2026-10-30 | 77e84d4 | 1,091,275 B | F | view · diff |
| git:20261030.49a0408 | 2026-10-30 | 49a0408 | 1,084,142 B | F | view · diff |
| git:20261030.55ae910 | 2026-10-30 | 55ae910 | 1,083,252 B | F | view · diff |
| git:20261029.7e91dc8 | 2026-10-29 | 7e91dc8 | 1,081,715 B | F | view · diff |
| git:20261029.00d49e1 | 2026-10-29 | 00d49e1 | 1,078,720 B | F | view |
Audit of the latest version
- fail: Size between 200 bytes and 200 KB (1196467 bytes)
- FAIL, critical: No credential-shaped string (matched: AKIAIOSFODNN7EXAMPLE)
- fail: No link to a raw IP address (matched: http://127.0.0.1)
- fail: No script tag (matched: <script)
- 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 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
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_ckrxr3ssxfu64q2e GET https://markdownregistry.com/api/v1/resolve?ref=i2y/ritsu/DESIGN.md GET https://markdownregistry.com/api/v1/blob/c8cc6e0f2809eae5dc5f2983e2e5fa5f259b5295254d7ef2fa50c803b654a418
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.