DESIGN.md@siteA

DESIGN.md@site from antonbabenko/deliberation is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add antonbabenko/deliberation/site/DESIGN.md@git:20261118.13f8e8b

Pins git:20261118.13f8e8b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
antonbabenko/deliberation
Path
site/DESIGN.md
Versions recorded
1
Latest version
git:20261118.13f8e8b, committed Nov 18, 2026
Size
10,850 bytes
Repository stars
187
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

# Design system: Capture

The public website is printed by the same instrument as the dashboard. This file records the
system as built in `site/src/`. The dashboard's own system is `server/dashboard/DESIGN.md`;
where the two differ, the difference is listed under "What the site changes".

## Idea

A consensus run is a capture on a logic analyzer: one lane per voice on a shared time axis, a
pulse while a voice is answering, and the decoded verdict in a box under it. The home page
shows one recorded run this way and lets the visitor open any answer. Every other part of the
site reuses instrument parts: outlined keys, ruled tables, tracked-caps legends, trigger
triangles.

## Tokens

All colours are OKLCH and live in `src/styles/site.css` under `:root`. Light is graticule
paper, dark is graphite. The theme follows the system setting; there is no toggle.

| Token | Light | Dark | Used for |
|-------|-------|------|----------|
| `--bg` | `oklch(0.974 0.007 95)` | `oklch(0.205 0.006 250)` | page, capture face, code blocks |
| `--bg2` | `oklch(0.948 0.009 95)` | `oklch(0.235 0.007 250)` | top bar, readout strip, inspector, experts band, footer |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add antonbabenko/deliberation/site/DESIGN.md@sha256:039ee786592ca912

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

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

Ask from your agent
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry

Then ask it: what changed in antonbabenko/deliberation/site/DESIGN.md since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.

Got a copy of DESIGN.md from somewhere else? Ask it: where did my DESIGN.md come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.

Versions

The registry has recorded 1 version of this file, committed on Nov 18, 2026.

Watch this file (sign in, one email per new version)

versioncommittedcommitsizeaudit
git:20261118.13f8e8b latest2026-11-18 13f8e8b 10,850 BA view
Check a whole project

From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies

In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies

No sha256sum on your machine? shasum -a 256 prints the same lines.

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 (10850 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

antonbabenko/deliberation · 187 stars · license MIT · pushed 2026-11-18 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_j7unds2daxyd4lqx
GET https://markdownregistry.com/api/v1/resolve?ref=antonbabenko/deliberation/site/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/039ee786592ca91280da9b4b0d2471703e83549a32fe2fc3c2bd36c0e83eadca

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 antonbabenko/deliberation

architect SKILL.md skill
antonbabenko/deliberation · .agents/skills/architect/SKILL.md · System design, tradeoffs, and complex technical decisions.
git:20261008.893bd58 · audit A · 187 stars
code-reviewer SKILL.md skill
antonbabenko/deliberation · .agents/skills/code-reviewer/SKILL.md · Find bugs, security holes, and maintainability issues in a diff or file.
git:20261008.893bd58 · audit A · 187 stars
debugger SKILL.md skill
antonbabenko/deliberation · .agents/skills/debugger/SKILL.md · Rank root-cause hypotheses and propose the smallest safe fix.
git:20261008.893bd58 · audit A · 187 stars
deliberation SKILL.md skill
antonbabenko/deliberation · .agents/skills/deliberation/SKILL.md · When and how to delegate to GPT, Gemini, Grok, and OpenRouter expert subagents via the Deliberation MCP tools.
git:20261118.c8cf5f9 · audit B · 187 stars
plan-reviewer SKILL.md skill
antonbabenko/deliberation · .agents/skills/plan-reviewer/SKILL.md · Validate that a work plan is executable before work starts.
git:20261008.893bd58 · audit A · 187 stars
reload-mcp SKILL.md skill
antonbabenko/deliberation · .agents/skills/reload-mcp/SKILL.md · After a Deliberation update: clear the npx cache, stop the dashboard, and restart the MCP server.
git:20261118.a0368a5 · audit A · 187 stars
researcher SKILL.md skill
antonbabenko/deliberation · .agents/skills/researcher/SKILL.md · Research external libraries, APIs, and best practices, with evidence.
git:20261008.893bd58 · audit A · 187 stars
scope-analyst SKILL.md skill
antonbabenko/deliberation · .agents/skills/scope-analyst/SKILL.md · Catch ambiguities and hidden requirements before planning.
git:20261008.893bd58 · audit A · 187 stars
security-analyst SKILL.md skill
antonbabenko/deliberation · .agents/skills/security-analyst/SKILL.md · Threat-model and find vulnerabilities, with practical remediation.
git:20261008.893bd58 · audit A · 187 stars
writing-editor SKILL.md skill
antonbabenko/deliberation · .agents/skills/writing-editor/SKILL.md · Edit prose so it reads like its author wrote it, keeping every fact and the author's voice.
git:20261104.7e83a6b · audit A · 187 stars
deliberation Cursor rule
antonbabenko/deliberation · .cursor/rules/deliberation.mdc · Use Deliberation MCP experts for review and second opinions
git:20261118.a0368a5 · audit A · 187 stars
architect SKILL.md skill
antonbabenko/deliberation · .gemini/skills/architect/SKILL.md · System design, tradeoffs, and complex technical decisions.
git:20261008.893bd58 · audit A · 187 stars

Every file in antonbabenko/deliberation

Other files named DESIGN.md@site

DESIGN.md@site DESIGN.md file
omdsh-dev/dsh-genui · site/DESIGN.md
git:20261109.8ed3999 · audit A · 1,024 stars
DESIGN.md@site DESIGN.md file
lxe/phoneuse · site/DESIGN.md · The phoneuse.tech site, a warm paper page in the app icon's palette (berry plum, amber, coral, cream) with soft clay…
git:20261110.60f0c8c · audit A · 674 stars
DESIGN.md@site DESIGN.md file
vaibhavarora14/job-application-agent · site/DESIGN.md
git:20261031.c1ea486 · audit A · 175 stars
DESIGN.md@site DESIGN.md file
xi-zhao/openquantum · site/DESIGN.md
git:20261022.0f1111e · audit A · 72 stars
DESIGN.md@site DESIGN.md file
dfrostar/neuralmind · site/DESIGN.md
git:20261101.317e537 · audit A · 41 stars
DESIGN.md@site DESIGN.md file
nonlooped/roblox-suite · site/DESIGN.md
git:20260919.e20f73c · audit A · 34 stars
DESIGN.md@site DESIGN.md file
vawe-hq/vawe · site/DESIGN.md · The site for an open source motion-graphics engine. Pure black, white type, neutral greys, hairlines, Geist; films in…
beta · audit A · 20 stars
DESIGN.md@site DESIGN.md file
event4u-app/agent-config · site/DESIGN.md
git:20261026.67fb982 · audit A · 19 stars

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