DESIGN.md is agent-read markdown (design) from garrytan/gbrain.
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
# DESIGN.md
The design system source of truth for gbrain. Born from the de facto tokens
that landed in `admin/src/index.css` during the v0.26.0 admin SPA work and
formalized during the v0.36.1.0 Hindsight calibration wave's design review.
This doc is the calibration target for `/plan-design-review` and `/design-review`.
When a question is "does this UI fit the system?", the answer is here.
## Voice
GBrain talks like a smart friend who knows your past, not a clinical scoring
system. Every user-facing string passes through this filter:
- Second person, contractions allowed.
- Grounded in concrete data the user can verify ("2 of 3 missed" beats
"Brier 0.31").
- Never preachy. Never "we recommend." Never "according to your data."
- Short. Under 25 words for narrative; under one line for status.
- Numbers grounded in real outcomes, never abstract metrics without
translation.
Five surfaces use this voice (v0.36.1.0+):
`pattern_statement`, `nudge`, `forecast_blurb`, `dashboard_caption`,
`morning_pulse`. All five pass through `gateVoice()` in
`src/core/calibration/voice-gate.ts` with mode-specific rubrics. A Haiku
…
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.
GET https://markdownregistry.com/api/v1/artifacts/art_p7yxalwxpjveao2t
GET https://markdownregistry.com/api/v1/resolve?ref=garrytan/gbrain/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/6067d41a06bad25e9d805ccb543561d60dccee8e88b51dab414dc34f3340c423
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.
garrytan/gbrain · docs/integrations/qm-harness-snippets/SKILL.md · Search and write the company knowledge brain. Use for any question about the org, people, projects, decisions, or…
garrytan/gbrain · examples/skillpack-reference/skills/reference-pack/SKILL.md · Reference skill demonstrating the 10/10 skillpack contract. Adds a "what does this skillpack do" answer to the user's…
garrytan/gbrain · plugin-variants/gbrain-coding/skills/brain-ingest-gate/SKILL.md · Pre-write quality gate for content entering the brain. No raw copies: a bare cp/mv into the brain repo is a bug. Before…
garrytan/gbrain · plugin-variants/gbrain-coding/skills/brain-link-discipline/SKILL.md · When you report a brain page to the user — created, edited, committed, or
relayed from a subagent — a working link is…
garrytan/gbrain · plugin-variants/gbrain-coding/skills/concept-synthesis/SKILL.md · Deduplicate and synthesize raw concept stubs into a tiered intellectual map (T1 Canon to T4 Riff), tracing idea…
pbakaus/impeccable · DESIGN.md · Neo kinpaku system. Two brand anchors, kinpaku gold and verdigris patina, sit on dark warm-black lacquer. Restraint in…
amruthpillai/reactive-resume · DESIGN.md · A monochrome, content-first design system for a free and open-source resume builder. Dark-by-default with light mode…
reactive-resume/app · DESIGN.md · A monochrome, content-first design system for a free and open-source resume builder. Dark-by-default with light mode…
