DESIGN.mdA

DESIGN.md from jkaloger/lazyspec is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add jkaloger/lazyspec/DESIGN.md@git:20260701.f139c3a

Pins git:20260701.f139c3a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
jkaloger/lazyspec
Path
DESIGN.md
Versions recorded
1
Latest version
git:20260701.f139c3a, committed Jul 1, 2026
Size
11,550 bytes
Repository stars
10
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

# Lazyspec web view design spec

## Design

### Aesthetic position

Three references, one resolution:

- Neo Swiss gives the structure: an asymmetric grid with a narrow metadata column and a wide content column, flush-left ragged-right setting, a small number of type sizes, objective neutral tone.
- Industrial Information Design gives the surface treatment: flat, no cards, no drop shadows, hairline rules to group and separate, tabular alignment for data, color used as signal and wayfinding rather than ornament.
- Micro Typography gives the detail: tabular lining numerals everywhere numbers carry meaning, tracking tightened on display sizes and loosened on small caps labels, a 4px baseline grid, a constrained reading measure, hung punctuation where the engine allows.

### Color tokens

Monochrome-dominant. One brand accent, locked across every surface. The lifecycle-status axis is a separate categorical legend, justified below.

Surface and ink ramp (no pure black, no pure white):

| Token              | Light     | Dark      | Role                                      |
| ------------------ | --------- | --------- | ----------------------------------------- |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jkaloger/lazyspec/DESIGN.md@sha256:4d1c895d4a45843c

The line at the top of this page pins the label git:20260701.f139c3a, 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_kiv6l2xpftl4qa4l.svg)](https://markdownregistry.com/a/art_kiv6l2xpftl4qa4l)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260701.f139c3a latest2026-07-01 f139c3a 11,550 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 (11550 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

jkaloger/lazyspec · 10 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kiv6l2xpftl4qa4l
GET https://markdownregistry.com/api/v1/resolve?ref=jkaloger/lazyspec/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/4d1c895d4a45843cc68f7a5564ab5e4f5cd828529c26c8248754a80d8a7e435b

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 jkaloger/lazyspec

AGENTS.md AGENTS.md file
jkaloger/lazyspec · AGENTS.md
git:20260929.ad44f28 · audit A · 10 stars
create-audit SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/create-audit/SKILL.md · Use when running a criteria-based review (health check, security audit, accessibility review, pen test, bug bash, spec…
git:20260309.b2e83d0 · audit A · 10 stars
create-plan SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/create-plan/SKILL.md · Use when planning implementation against a Spec or as a standalone plan for bug fixes, tweaks, and refactors. Creates…
git:20260309.b2e83d0 · audit A · 10 stars
create-spec SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/create-spec/SKILL.md · Use when locking down technical contracts for a vertical slice. Creates Spec documents with data models, API surface…
git:20260309.b2e83d0 · audit A · 10 stars
lazy SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/lazy/SKILL.md · Use when starting new work, planning a feature, or deciding what to implement next. Detects existing RFCs, Specs, and…
git:20260309.b2e83d0 · audit A · 10 stars
resolve-context SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/resolve-context/SKILL.md · Use when an agent needs full context before beginning work on a Spec or Plan. Gathers the document chain from plan…
git:20260309.b2e83d0 · audit A · 10 stars
review-plan SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/review-plan/SKILL.md · Use when a Plan is complete and ready for review. Two-stage review -- spec contract compliance first, code quality…
git:20260309.b2e83d0 · audit A · 10 stars
write-rfc SKILL.md skill
jkaloger/lazyspec · examples/spec/skills/write-rfc/SKILL.md · Use for heavy, cross-cutting, or architecturally significant designs. Creates an RFC document with intent, interface…
git:20260309.b2e83d0 · audit A · 10 stars
advance SKILL.md skill
jkaloger/lazyspec · skills/advance/SKILL.md · Use when moving a document to its next status along the type's lifecycle DAG, maintaining links across the transition.
git:20260903.f1f85b0 · audit A · 10 stars
co-write SKILL.md skill
jkaloger/lazyspec · skills/co-write/SKILL.md · Use when drafting a document of a configured type collaboratively -- AI proposes a draft body, the human edits, iterate…
git:20260903.f1f85b0 · audit A · 10 stars
configure-type SKILL.md skill
jkaloger/lazyspec · skills/configure-type/SKILL.md · Use when adding a new custom document type to a lazyspec project. Interviews the user to co-author the type's…
git:20260903.f1f85b0 · audit A · 10 stars
create-audit SKILL.md skill
jkaloger/lazyspec · skills/create-audit/SKILL.md · Use when running a criteria-based review (health check, security audit, accessibility review, pen test, bug bash, spec…
git:20260623.d2a2f44 · audit A · 10 stars

Every file in jkaloger/lazyspec

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20261104.2ff2d3b · audit A · 138,879 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261030.6dcf416 · audit A · 110,058 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 · 97,942 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 · 93,171 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 78,411 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20260819.300ab2e · audit A · 53,156 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,463 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261013.6d48e23 · audit A · 24,350 stars

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