Home / jquatier / squinch · docs/DESIGN.md · GitHub

DESIGN.md@docs designA

DESIGN.md@docs is agent-read markdown (design) from jquatier/squinch.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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

Latest version
mdr add jquatier/squinch/docs/DESIGN.md@git:20260922.711512d
Exact content
mdr add jquatier/squinch/docs/DESIGN.md@sha256:26a79d14d68c7ce1

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ii2cxj6n7ddaxdje.svg)](https://markdownregistry.com/a/art_ii2cxj6n7ddaxdje)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260922.711512d latest2026-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. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (25002 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 · 3 stars · license Apache-2.0 · pushed 2026-09-23 · 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/26a79d14d68c7ce1d5eb4906337d672a5f428d888d4afd558bb5cd9bb0cff3f2

Your agent 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.

More from jquatier/squinch

CLAUDE.md claude
jquatier/squinch · CLAUDE.md
git:20260923.cdd4881 · audit B · 3 stars
squinch 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:20260922.6491400 · audit A · 3 stars

Every file in jquatier/squinch

Other files named DESIGN.md@docs

DESIGN.md@docs design
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,669 stars
DESIGN.md@docs design
1ay1/agentty · docs/DESIGN.md
git:20260716.46a37fd · audit A · 603 stars
DESIGN.md@docs design
vintlin/skill-flow · docs/DESIGN.md · A compact macOS operations workspace built from layered neutral surfaces, user-selectable accents, reusable group…
beta · audit A · 261 stars
DESIGN.md@docs design
cassette-editor/oh-my-cassette · docs/DESIGN.md · A browser-based video editor with an AI co-editor, tuned like a colorist's grading suite.
git:20260725.e99cff3 · audit A · 153 stars
DESIGN.md@docs design
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 136 stars
DESIGN.md@docs design
viy1204/recruiting-copilot · docs/DESIGN.md
git:20260827.5ea0afa · audit A · 77 stars
DESIGN.md@docs design
ghalebdweikat/winnow · docs/DESIGN.md
git:20260919.57b20c5 · audit A · 74 stars
DESIGN.md@docs design
korovin-aa97/talkthrough-mcp · docs/DESIGN.md
git:20260906.765e96b · audit A · 30 stars

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