DESIGN.md@crates/geasB

DESIGN.md@crates/geas from i2y/ritsu is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add i2y/ritsu/crates/geas/DESIGN.md@git:20261031.76f9a81

Pins git:20261031.76f9a81 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
DESIGN.md file
Repository
i2y/ritsu
Path
crates/geas/DESIGN.md
Versions recorded
6
Latest version
git:20261031.76f9a81, committed Oct 31, 2026
First version recorded
Oct 10, 2026
Size
118,028 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

# geas — design sheet (working name; naming open)

Status: spike, 2026-08-29. Everything in `README.md` marked as run output
was actually run on this machine (macOS/arm64, rustc 1.97.1, Python 3.14).
This file is the design; the README is the evidence.

2026-10-02: the design of v1 is added as §6–§16 — the diff half of the
gate, GUI targets, the matchers, parallel runs, quoting, pinning, the
diagnostics and the skill. §0–§5 stay as the spike wrote them; where v1
changes a v0 decision, the v1 section says so. `PLAN.md` is the order of
work. v1 builds with the stable toolchain (rustc 1.94.1, edition 2024)
and stays dependency-free. §16 lists what was measured to settle the
design, and how.

2026-10-03: stage B is built (the diagnostics, `geas map`, `geas
affected`, the four runtimes); §6, §7, §13 and §16 say what building it
decided.

2026-10-03: the first half of stage C is built: command strings (§11),
the matchers and the `header` subject (§9), pins (§12), and parallel runs
with process groups (§10, §10.1). Each section ends with what building it
decided; §7.2 says why the Node hook changed, and §16 what was measured.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add i2y/ritsu/crates/geas/DESIGN.md@sha256:b7b98f6dac61dc9b

The line at the top of this page pins the label git:20261031.76f9a81, 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_xmol2evajf2cjbrn.svg)](https://markdownregistry.com/a/art_xmol2evajf2cjbrn)

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

Versions

The registry has recorded 6 versions of this file, between Oct 10, 2026 and Oct 31, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261031.76f9a81 latest2026-10-31 76f9a81 118,028 BB view · diff
git:20261029.4321eaf2026-10-29 4321eaf 116,773 BB view · diff
git:20261028.c70f3b02026-10-28 c70f3b0 116,736 BB view · diff
git:20261027.fdc09672026-10-27 fdc0967 106,433 BB view · diff
git:20261018.32d00a12026-10-18 32d00a1 105,751 BB view · diff
git:20261010.8872deb2026-10-10 8872deb 104,438 BB view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1)
  • pass: Size between 200 bytes and 200 KB (118028 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 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

GitHub

i2y/ritsu · 3 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xmol2evajf2cjbrn
GET https://markdownregistry.com/api/v1/resolve?ref=i2y/ritsu/crates/geas/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/b7b98f6dac61dc9bda8fafdd019b400ec2eabb1cfc5814ee1f9bb77cf8c61eae

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.

More from i2y/ritsu

DESIGN.md DESIGN.md file
i2y/ritsu · DESIGN.md
git:20261107.d281d9c · audit F · 3 stars
DESIGN.md@crates/chobo DESIGN.md file
i2y/ritsu · crates/chobo/DESIGN.md
git:20261106.2acffb3 · audit B · 3 stars
DESIGN.md@crates/dandori DESIGN.md file
i2y/ritsu · crates/dandori/DESIGN.md
git:20261104.62ba97a · audit C · 3 stars
DESIGN.md@crates/kaname DESIGN.md file
i2y/ritsu · crates/kaname/DESIGN.md
git:20261107.d281d9c · audit B · 3 stars
DESIGN.md@crates/koyomi DESIGN.md file
i2y/ritsu · crates/koyomi/DESIGN.md
git:20261107.d281d9c · audit B · 3 stars
AGENTS.md@crates/rulec AGENTS.md file
i2y/ritsu · crates/rulec/AGENTS.md
git:20261103.7af3d08 · audit A · 3 stars
DESIGN.md@crates/rulec DESIGN.md file
i2y/ritsu · crates/rulec/DESIGN.md
git:20261106.947564f · audit C · 3 stars
DESIGN.md@crates/sakai DESIGN.md file
i2y/ritsu · crates/sakai/DESIGN.md
git:20261107.d281d9c · audit B · 3 stars
DESIGN.md@crates/sekisho DESIGN.md file
i2y/ritsu · crates/sekisho/DESIGN.md
git:20261103.558b890 · audit C · 3 stars
DESIGN.md@crates/yuen DESIGN.md file
i2y/ritsu · crates/yuen/DESIGN.md
git:20261105.54d3620 · audit B · 3 stars
chobo SKILL.md skill
i2y/ritsu · skills/chobo/SKILL.md · Write, check and build chobo books (`.book` files), a small language for the things counted and moved between accounts…
git:20261104.5b400fc · audit A · 3 stars
dandori SKILL.md skill
i2y/ritsu · skills/dandori/SKILL.md · Write, check and build dandori workflows (`.flow` files), typed workflows that call APIs, rules, agents, decision…
git:20261104.5b400fc · audit A · 3 stars

Every file in i2y/ritsu

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