DESIGN.md@docsB

DESIGN.md@docs from enricai/leerie is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add enricai/leerie/docs/DESIGN.md@git:20261015.4411193

Pins git:20261015.4411193 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
DESIGN.md file
Repository
enricai/leerie
Path
docs/DESIGN.md
Versions recorded
11
Latest version
git:20261015.4411193, committed Oct 15, 2026
First version recorded
Oct 1, 2026
Size
515,420 bytes
Repository stars
10
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

# Leerie — Design Document

> Graph-engineered task driver for Claude Code. Classifies an engineering
> task, decomposes it into a dependency graph of granular subtasks, topo-sorts
> it into waves, and executes each node in an isolated git worktree under an
> evidence-gated implement/validate loop — with the fewest possible
> interruptions to the user.

**Scope of this document.** This is the *theory*: the architecture, the
constraints that forced it, and the reasoning behind each decision. It
describes the intended system, not the current code, and stays correct
across any reimplementation honoring the same architecture. Mechanism —
function names, cap values, file paths, schemas, enforcement tables, install
steps — lives in the companion `IMPLEMENTATION.md`, true only against
current code. Where the two disagree, this document wins and the code is
the defect.

---

## 1. Purpose

Given one task description, Leerie drives it to a validated, integrated
result without further human input except where input is genuinely
impossible to derive. Every loop is bounded, every decision is made from the
codebase or research, and state is kept on disk so a run is observable and
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add enricai/leerie/docs/DESIGN.md@sha256:1e6dcc2212565a8e

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

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

Versions

The registry has recorded 11 versions of this file, between Oct 1, 2026 and Oct 15, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261015.4411193 latest2026-10-15 4411193 515,420 BB view · diff
git:20261007.94b64832026-10-07 94b6483 509,253 BB view · diff
git:20261007.da53c482026-10-07 da53c48 508,809 BB view · diff
git:20261007.d34dacf2026-10-07 d34dacf 508,550 BB view · diff
git:20261006.97aa2b22026-10-06 97aa2b2 507,540 BB view · diff
git:20261006.33d57582026-10-06 33d5758 504,656 BB view · diff
git:20261006.961e6e72026-10-06 961e6e7 501,783 BB view · diff
git:20261005.6a2abbd2026-10-05 6a2abbd 498,723 BB view · diff
git:20261005.67ce5df2026-10-05 67ce5df 498,596 BB view · diff
git:20261002.d6ff61d2026-10-02 d6ff61d 481,322 BB view · diff
git:20261001.f83c8d32026-10-01 f83c8d3 472,188 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: Size between 200 bytes and 200 KB (515420 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

GitHub

enricai/leerie · 10 stars · license MIT · pushed 2026-10-15 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nmfghnbpegiqh2ia
GET https://markdownregistry.com/api/v1/resolve?ref=enricai/leerie/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/1e6dcc2212565a8e5317a49f53837861d4caaf57760af6f93fcf74a52f2e51e5

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 enricai/leerie

CLAUDE.md CLAUDE.md file
enricai/leerie · CLAUDE.md
git:20261005.67ce5df · audit A · 10 stars
judge-llm-batch SKILL.md skill
enricai/leerie · skills/judge-llm-batch/SKILL.md · Apply a 3-dimensional accuracy rubric (schema adherence, factual grounding, hallucination-freeness) to a batch of…
git:20260702.5a086eb · audit A · 10 stars
llm-self-heal SKILL.md skill
enricai/leerie · skills/llm-self-heal/SKILL.md · Autonomous self-healing loop for leerie worker prompts that produced captured failures. For each call_type with…
git:20260702.2f2185f · audit A · 10 stars

Every file in enricai/leerie

Other files named DESIGN.md@docs

DESIGN.md@docs DESIGN.md file
mvschwarz/openrig · docs/DESIGN.md
git:20261005.f6358a2 · audit A · 7,989 stars
DESIGN.md@docs DESIGN.md file
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,754 stars
DESIGN.md@docs DESIGN.md file
keli-wen/agy-staff · docs/DESIGN.md
git:20261007.65a1ab4 · audit A · 765 stars
DESIGN.md@docs DESIGN.md file
1ay1/agentty · docs/DESIGN.md
git:20261010.227e92e · audit A · 625 stars
DESIGN.md@docs DESIGN.md file
vintlin/skill-flow · docs/DESIGN.md · A compact macOS operations workspace built from layered neutral surfaces, user-selectable accents, reusable group…
beta · audit A · 264 stars
DESIGN.md@docs DESIGN.md file
mobileaidev/ai-app-bridge · docs/DESIGN.md
git:20261012.3200529 · audit A · 227 stars
DESIGN.md@docs DESIGN.md file
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 187 stars
DESIGN.md@docs DESIGN.md file
ghalebdweikat/winnow · docs/DESIGN.md
git:20261006.4547a81 · audit A · 115 stars

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