DESIGN.md@docsA

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

Install it, pinned
mdr add jquatier/squinch/docs/DESIGN.md@git:20261031.88539e4

Pins git:20261031.88539e4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
jquatier/squinch
Path
docs/DESIGN.md
Versions recorded
13
Latest version
git:20261031.88539e4, committed Oct 31, 2026
First version recorded
Aug 23, 2026
Size
26,458 bytes
Repository stars
4
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

# Squinch — Diagram Design Language

> How rendered diagrams look, and the rules that keep them looking that way.
> Companion to [SPEC.md](SPEC.md) (the DSL) and [ENGINEERING.md](ENGINEERING.md)
> (budgets, verification). Numbers below were tuned against the
> lookbook — but the *rules* are non-negotiable.

## 1. Principles

1. **The default theme is the brand.** Most people will only ever see a screenshot of
   the default render. `light`/`dark` are the flagship product surface, not a base to
   customize away from.
2. **The app is the frame; the diagram is the art.** App chrome recedes so the canvas
   owns the screen (see §10). Diagram themes have their own language, independent of
   the app skin.
3. **Uniformity beats fit.** Nodes have fixed heights and snapped width tiers; text
   adapts to the box (wrap → ellipsis → hover for full), never the reverse. No
   ransom-note diagrams.
4. **Nothing almost-aligned.** Elements share an axis *exactly* or are clearly
   apart — a 3px offset reads as a mistake, 40px reads as a decision. Exactness is
   enforced where the author asks for it (`align`, `cols`), and positions are
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jquatier/squinch/docs/DESIGN.md@sha256:415475a7e44dc4a9

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

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

Versions

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

versioncommittedcommitsizeaudit
git:20261031.88539e4 latest2026-10-31 88539e4 26,458 BA view · diff
git:20261031.c7c0f8b2026-10-31 c7c0f8b 26,352 BA view · diff
git:20261031.887e53f2026-10-31 887e53f 26,311 BA view · diff
git:20260927.23d30ce2026-09-27 23d30ce 26,178 BA view · diff
git:20260926.3e4ef9c2026-09-26 3e4ef9c 25,674 BA view · diff
git:20260925.0ae97672026-09-25 0ae9767 25,100 BA view · diff
git:20260922.711512d2026-09-22 711512d 25,002 BA view · diff
git:20260922.f9f7f122026-09-22 f9f7f12 24,657 BA view · diff
git:20260920.43a0f8c2026-09-20 43a0f8c 23,749 BA view · diff
git:20260914.49bf09b2026-09-14 49bf09b 23,097 BA view · diff
git:20260913.bab65fe2026-09-13 bab65fe 23,081 BA view · diff
git:20260823.c2092972026-08-23 c209297 22,056 BA view · diff
git:20260823.16246d32026-08-23 16246d3 22,068 BA view

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

jquatier/squinch · 4 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ii2cxj6n7ddaxdje
GET https://markdownregistry.com/api/v1/resolve?ref=jquatier/squinch/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/415475a7e44dc4a95f3fde2023325cb442af438c78d345f9c314c2b315f54d40

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 jquatier/squinch

CLAUDE.md CLAUDE.md file
jquatier/squinch · CLAUDE.md
git:20261010.4041bc2 · audit B · 4 stars
squinch SKILL.md skill
jquatier/squinch · packages/skill/skills/squinch/SKILL.md · Author architecture diagrams as code with the Squinch DSL. Use this whenever the user wants an architecture or system…
git:20261031.887e53f · audit A · 4 stars

Every file in jquatier/squinch

Other files named DESIGN.md@docs

DESIGN.md@docs DESIGN.md file
mvschwarz/openrig · docs/DESIGN.md
git:20261005.f6358a2 · audit A · 8,636 stars
DESIGN.md@docs DESIGN.md file
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,786 stars
DESIGN.md@docs DESIGN.md file
keli-wen/agy-staff · docs/DESIGN.md
git:20261102.9ddec3e · audit A · 816 stars
DESIGN.md@docs DESIGN.md file
1ay1/agentty · docs/DESIGN.md
git:20261010.227e92e · audit A · 614 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
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 139 stars
DESIGN.md@docs DESIGN.md file
ghalebdweikat/winnow · docs/DESIGN.md
git:20261006.4547a81 · audit A · 115 stars
DESIGN.md@docs DESIGN.md file
viy1204/recruiting-copilot · docs/DESIGN.md
git:20261104.ada520e · audit A · 109 stars

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