DESIGN.mdB

DESIGN.md from coddy-project/coddy-agent is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add coddy-project/coddy-agent/DESIGN.md@git:20261020.c44a715

Pins git:20261020.c44a715 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
DESIGN.md file
Repository
coddy-project/coddy-agent
Path
DESIGN.md
Versions recorded
43
Latest version
git:20261020.c44a715, committed Oct 20, 2026
First version recorded
Sep 26, 2026
Size
467,532 bytes
Repository stars
178
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

# Coddy Agent UI Specification

Purpose: authoritative reference for the embedded SPA built from `external/ui/`. Tokens and layouts live here before CSS tweaks land in production stylesheets.

## Design references

Store the design reference images under `docs/assets/` and link to the specific file when describing a pixel sensitive UI detail. Navbar parity with Cursor - style mockups lives in [`docs/assets/INDEX.md`](docs/assets/INDEX.md) (see Navbar section).

## Foundations

### Contract ownership and verification

- **One fact, one visual location.** A status, result, duration or action is shown in the surface that owns it and is not repeated in adjacent transcript rows, panels or labels unless accessibility needs an equivalent hidden name.
- **Measure browser geometry at the browser boundary.** A geometry-sensitive contract uses a live-browser check when jsdom cannot perform layout. Component and source-contract tests still own DOM semantics, but they do not substitute for measured geometry.
- **External products are references, not contracts.** A product may explain historical inspiration; only the behavior specified here is normative for Coddy.

### Color
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add coddy-project/coddy-agent/DESIGN.md@sha256:f553fc38af56dc91

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

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

Versions

The registry has recorded 43 versions of this file, between Sep 26, 2026 and Oct 20, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261020.c44a715 latest2026-10-20 c44a715 467,532 BB view · diff
git:20261020.4b171c42026-10-20 4b171c4 466,808 BB view · diff
git:20261020.dcb923a2026-10-20 dcb923a 466,585 BB view · diff
git:20261020.ea6de702026-10-20 ea6de70 466,125 BB view · diff
git:20261019.0128fd92026-10-19 0128fd9 466,136 BB view · diff
git:20261016.cf535c82026-10-16 cf535c8 436,015 BB view · diff
git:20261016.aad9f552026-10-16 aad9f55 435,281 BB view · diff
git:20261015.87b07d72026-10-15 87b07d7 433,095 BB view · diff
git:20261015.f07b4c62026-10-15 f07b4c6 432,785 BB view · diff
git:20261014.8a976c12026-10-14 8a976c1 432,471 BB view · diff
git:20261013.553a80c2026-10-13 553a80c 396,106 BB view · diff
git:20261013.8f8cd022026-10-13 8f8cd02 395,587 BB view · diff
git:20261012.7e914c72026-10-12 7e914c7 394,159 BB view · diff
git:20261012.9a8c9ca2026-10-12 9a8c9ca 392,823 BB view · diff
git:20261012.74801d02026-10-12 74801d0 391,126 BB view · diff
git:20261010.b38a8722026-10-10 b38a872 390,968 BB view · diff
git:20261010.1985cb72026-10-10 1985cb7 390,900 BB view · diff
git:20261010.1c4a76f2026-10-10 1c4a76f 390,882 BB view · diff
git:20261010.c5bc8192026-10-10 c5bc819 390,791 BB view · diff
git:20261010.79dc4ae2026-10-10 79dc4ae 387,165 BB view · diff
git:20261008.a3991f82026-10-08 a3991f8 371,188 BB view · diff
git:20261008.db218a02026-10-08 db218a0 370,618 BB view · diff
git:20261008.a83033c2026-10-08 a83033c 368,548 BB view · diff
git:20261008.fc48db52026-10-08 fc48db5 370,656 BB view · diff
git:20261008.6e356612026-10-08 6e35661 370,424 BB view · diff
git:20261003.c34a75e2026-10-03 c34a75e 299,183 BB view · diff
git:20261003.46920422026-10-03 4692042 298,834 BB view · diff
git:20261003.d6ed96b2026-10-03 d6ed96b 298,453 BB view · diff
git:20261003.1d509112026-10-03 1d50911 296,301 BB view · diff
git:20261003.8866eb72026-10-03 8866eb7 296,210 BB view · diff
git:20260928.80f234a2026-09-28 80f234a 292,417 BB view · diff
git:20260928.1f59a2e2026-09-28 1f59a2e 292,271 BB view · diff
git:20260928.7a621dd2026-09-28 7a621dd 292,028 BB view · diff
git:20260928.78646e12026-09-28 78646e1 290,473 BB view · diff
git:20260928.742a5732026-09-28 742a573 276,062 BB view · diff
git:20260928.ea1d3f92026-09-28 ea1d3f9 290,306 BB view · diff
git:20260928.b0f2ca92026-09-28 b0f2ca9 290,020 BB view · diff
git:20260928.6b2e85f2026-09-28 6b2e85f 289,811 BB view · diff
git:20260926.0d8a1362026-09-26 0d8a136 273,178 BB view · diff
git:20260926.0e6bcf82026-09-26 0e6bcf8 272,118 BB view · diff
git:20260926.b3320a02026-09-26 b3320a0 267,440 BB view · diff
git:20260926.367eebb2026-09-26 367eebb 264,582 BB view · diff
git:20260926.2e2b3d82026-09-26 2e2b3d8 263,502 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 (467532 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

coddy-project/coddy-agent · 178 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gfeiklcl7bkpq5rl
GET https://markdownregistry.com/api/v1/resolve?ref=coddy-project/coddy-agent/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/f553fc38af56dc91a6c8671cb7ed7a8c575fef69d542b8e9d45afc67bda87152

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 coddy-project/coddy-agent

acp-protocol Cursor rule
coddy-project/coddy-agent · .cursor/rules/acp-protocol.mdc · ACP session readiness, notifications, and wire compatibility
git:20261004.4bb7222 · audit A · 178 stars
agent-model-choice Cursor rule
coddy-project/coddy-agent · .cursor/rules/agent-model-choice.mdc · User-owned model choice and settings notices
git:20261005.d31d9be · audit A · 178 stars
api-layer Cursor rule
coddy-project/coddy-agent · .cursor/rules/api-layer.mdc · Optional HTTP gateway, OpenAPI spec source of truth
git:20261007.7a61267 · audit A · 178 stars
architecture Cursor rule
coddy-project/coddy-agent · .cursor/rules/architecture.mdc · Layers and dependency direction for Coddy Agent
git:20261004.8e8554b · audit A · 178 stars
build-tags Cursor rule
coddy-project/coddy-agent · .cursor/rules/build-tags.mdc · The shipped build tag set is spelled in several places that move together
git:20261015.d5a3cb8 · audit A · 178 stars
code-style Cursor rule
coddy-project/coddy-agent · .cursor/rules/code-style.mdc · Formatting, lint, comments language
git:20261013.10eb20e · audit A · 178 stars
config-roundtrip Cursor rule
coddy-project/coddy-agent · .cursor/rules/config-roundtrip.mdc · Lossless and concurrent configuration round trips
git:20261004.4bb7222 · audit A · 178 stars
console-tui Cursor rule
coddy-project/coddy-agent · .cursor/rules/console-tui.mdc · Console TUI rendering, local shell, and question behavior
git:20261004.4bb7222 · audit A · 178 stars
core-modules Cursor rule
coddy-project/coddy-agent · .cursor/rules/core-modules.mdc · Main internal packages at a glance
git:20261019.856be9a · audit A · 178 stars
docs-translation Cursor rule
coddy-project/coddy-agent · .cursor/rules/docs-translation.mdc · The Russian documentation tree (docs/ru), what moves with an English page, the stamp, and the writing rules for Russian…
git:20261018.bc36d0a · audit A · 178 stars
gateway Cursor rule
coddy-project/coddy-agent · .cursor/rules/gateway.mdc · Messenger gateway architecture, session store, and the Telegram and Pachca adapter conventions
git:20261020.4665378 · audit A · 178 stars
implementation-order Cursor rule
coddy-project/coddy-agent · .cursor/rules/implementation-order.mdc · Layered implementation order (cake model)
git:20261004.8e8554b · audit A · 178 stars

Every file in coddy-project/coddy-agent

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20260909.c8f0c4e · audit A · 136,966 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261009.417db14 · audit A · 105,684 stars
DESIGN.md DESIGN.md file
tt-a1i/archify · DESIGN.md · A precise, vivid technical instrument for trustworthy interactive architecture maps.
git:20260817.a0bc059 · audit A · 85,866 stars
DESIGN.md DESIGN.md file
pbakaus/impeccable · DESIGN.md · Neo kinpaku system. Two brand anchors, kinpaku gold and verdigris patina, sit on dark warm-black lacquer. Restraint in…
git:20260721.d7d1027 · audit A · 83,565 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 67,662 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20260819.300ab2e · audit A · 52,815 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,074 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261013.6d48e23 · audit A · 24,200 stars

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