DESIGN.mdA

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

Install it, pinned
mdr add drobins25/craft/DESIGN.md@git:20261022.9f00b66

Pins git:20261022.9f00b66 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
drobins25/craft
Path
DESIGN.md
Versions recorded
22
Latest version
git:20261022.9f00b66, committed Oct 22, 2026
First version recorded
Aug 15, 2026
Size
51,191 bytes
Repository stars
70
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

# Craft - Design Reference

> Architecture reference for `craft`, a Claude Code plugin that turns the CLI into a development harness. README.md covers what craft is and how to use it, this file covers architecture and internals, and CLAUDE.md is the operating contract Claude works under in this repo.

For definitions of cycle, story, chunk, and the workshop concepts, see README.md. This file assumes that vocabulary.

---

## Plugin Structure

```
plugins/craft/
├── .claude-plugin/
│   └── plugin.json            ← Plugin manifest (name, version)
├── agents/                    ← Isolated-context specialist agents (27 agents)
│   ├── alchemist.md           ← CSS interaction physicist (crystallized)
│   ├── become-researcher.md   ← Psychological material collector for /craft:become
│   ├── chunk-validator.md     ← Quality check executor (haiku model)
│   ├── conductor.md           ← AI orchestration architect (crystallized)
│   ├── creative-analyzer.md   ← Delight moments, viral potential
│   ├── crystallizer.md        ← Research-to-agent synthesizer (opus model)
│   ├── doc-writer.md          ← Documentation practitioner (crystallized)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add drobins25/craft/DESIGN.md@sha256:3116ebb84393485a

The line at the top of this page pins the label git:20261022.9f00b66, 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_hpsda6s337iro7zl.svg)](https://markdownregistry.com/a/art_hpsda6s337iro7zl)

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

Versions

The registry has recorded 22 versions of this file, between Aug 15, 2026 and Oct 22, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261022.9f00b66 latest2026-10-22 9f00b66 51,191 BA view · diff
git:20261022.baec1af2026-10-22 baec1af 51,098 BA view · diff
git:20261019.7715edf2026-10-19 7715edf 51,008 BA view · diff
git:20261019.b15b3772026-10-19 b15b377 50,854 BA view · diff
git:20261018.8663c252026-10-18 8663c25 50,862 BA view · diff
git:20261016.00067802026-10-16 0006780 50,645 BA view · diff
git:20261015.2ea17a62026-10-15 2ea17a6 50,334 BA view · diff
git:20261015.512d7272026-10-15 512d727 49,654 BA view · diff
git:20261014.65e47b12026-10-14 65e47b1 49,465 BA view · diff
git:20261009.d8f43cb2026-10-09 d8f43cb 48,605 BA view · diff
git:20261004.d8cd7912026-10-04 d8cd791 43,521 BA view · diff
git:20261004.5966d8a2026-10-04 5966d8a 43,476 BA view · diff
git:20261004.a134f1a2026-10-04 a134f1a 40,845 BA view · diff
git:20261004.5b598582026-10-04 5b59858 40,747 BA view · diff
git:20261003.d6b148e2026-10-03 d6b148e 40,362 BA view · diff
git:20260911.97e42032026-09-11 97e4203 37,718 BA view · diff
git:20260910.4b266d82026-09-10 4b266d8 37,720 BA view · diff
git:20260826.963cafd2026-08-26 963cafd 37,529 BA view · diff
git:20260826.d1f70272026-08-26 d1f7027 37,249 BA view · diff
git:20260825.4681cfc2026-08-25 4681cfc 36,962 BA view · diff
git:20260822.394ea5d2026-08-22 394ea5d 36,710 BA view · diff
git:20260815.2b15ade2026-08-15 2b15ade 36,687 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 (51191 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

drobins25/craft · 70 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hpsda6s337iro7zl
GET https://markdownregistry.com/api/v1/resolve?ref=drobins25/craft/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/3116ebb84393485aac2f1969f88e81db115371d2716b2a555be4825b3046d8b3

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 drobins25/craft

CLAUDE.md CLAUDE.md file
drobins25/craft · CLAUDE.md
git:20261019.7a57c10 · audit A · 70 stars
adhoc SKILL.md skill
drobins25/craft · skills/adhoc/SKILL.md · Adhoc workflow for small targeted changes to existing behavior or appearance, without the full story ceremony. Use when…
git:20261003.000b0eb · audit A · 70 stars
approve SKILL.md skill
drobins25/craft · skills/approve/SKILL.md · Request write permission from the user before making file changes. MUST be invoked before any write attempt when the…
git:20260731.218cf50 · audit A · 70 stars
browser SKILL.md skill
drobins25/craft · skills/browser/SKILL.md · Interactive browser automation via playwright-cli. Use when you need to navigate a site, click elements, fill forms…
git:20260804.f8ad7bc · audit A · 70 stars
content-spark SKILL.md skill
drobins25/craft · skills/content-spark/SKILL.md · This skill should be used when a story has been captured but content direction is unresolved - the spark describes WHAT…
v1.2.0 · audit A · 70 stars
creative-spark SKILL.md skill
drobins25/craft · skills/creative-spark/SKILL.md · This skill should be used when the user asks to "brainstorm", "explore options", "get creative", "what if we...", or…
v1.5.0 · audit A · 70 stars
design-vibe SKILL.md skill
drobins25/craft · skills/design-vibe/SKILL.md · Use this skill when the user wants to discover, define, or refine their product's aesthetic identity. Triggers on "what…
v2.0.0 · audit A · 70 stars
lock-decision SKILL.md skill
drobins25/craft · skills/lock-decision/SKILL.md · This skill should be used when the user says "lock it", "go with that", "approved", "that's the standard", or…
v1.2.0 · audit A · 70 stars
plan-chunks SKILL.md skill
drobins25/craft · skills/plan-chunks/SKILL.md · This skill should be used when the user asks to "plan chunks", "break this down", "plan the implementation", or when a…
v3.0.0 · audit A · 70 stars
refine-chunk SKILL.md skill
drobins25/craft · skills/refine-chunk/SKILL.md · This skill should be used when validate-chunk reports errors or failures, when the user asks to "fix these errors"…
v1.2.0 · audit A · 70 stars
test-fix SKILL.md skill
drobins25/craft · skills/test-fix/SKILL.md · This skill should be used when validate-chunk reports test failures specifically, when the user says "tests are…
v1.2.0 · audit A · 70 stars
validate-chunk SKILL.md skill
drobins25/craft · skills/validate-chunk/SKILL.md · Enforcement layer for chunk and story validation. Invokes the chunk-validator agent (haiku), enforces the verdict…
v4.0.0 · audit A · 70 stars

Every file in drobins25/craft

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.