DESIGN.mdA

DESIGN.md from bastani-inc/atomic is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add bastani-inc/atomic/DESIGN.md@git:20260724.1b90640

Pins git:20260724.1b90640 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
bastani-inc/atomic
Path
DESIGN.md
Versions recorded
5
Latest version
git:20260724.1b90640, committed Jul 24, 2026
First version recorded
May 5, 2026
Size
18,110 bytes
Repository stars
874
License
a license file GitHub does not identify

Terminal control plane for orchestrating multi-agent coding workflows.

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

# Design System: Atomic CLI

## 1. Overview

**Creative North Star: "The Quiet Operator"**

Atomic is a terminal-native control plane for AI coding agents. Engineers run hour-long autonomous sessions through it, then come back to review. The interface has to disappear into that work: glanceable at 2am, dense without being cluttered, and willing to surface a saturated color the moment something needs attention. Catppuccin Mocha is the canonical palette; Tokyo Night is the secondary fallback. Light terminals fall back to Catppuccin Latte through the same token roles, so every component below has a parallel light reading.

The visual register is Restrained. Most of the surface is tinted neutral, with one accent (Catppuccin Blue) reserved for primary actions, current selection, and the mode pill. Status colors are not decoration; they correspond to the orchestrator's own state vocabulary (running, complete, awaiting input, error, pending). Bold weight does the heavy lifting where size cannot — terminals control font and size, but they reliably honor weight.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bastani-inc/atomic/DESIGN.md@sha256:703d3ae1e2c7c19f

The line at the top of this page pins the label git:20260724.1b90640, 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_tmzqarxw7gxsrg7t.svg)](https://markdownregistry.com/a/art_tmzqarxw7gxsrg7t)

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

Versions

The registry has recorded 5 versions of this file, between May 5, 2026 and Jul 24, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20260724.1b90640 latest2026-07-24 1b90640 18,110 BA view · diff
git:20260524.22de7b92026-05-24 22de7b9 17,826 BA view · diff
git:20260515.c4cb45d2026-05-15 c4cb45d 17,887 BA view · diff
git:20260507.7a55ab42026-05-07 7a55ab4 17,888 BA view · diff
git:20260505.974e07e2026-05-05 974e07e 16,842 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 (18110 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

bastani-inc/atomic · 874 stars · license a license file GitHub does not identify · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tmzqarxw7gxsrg7t
GET https://markdownregistry.com/api/v1/resolve?ref=bastani-inc/atomic/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/703d3ae1e2c7c19f9b1919ea5f12e3daf05bc2c723978fa3e05a2e1e198080e1

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 bastani-inc/atomic

bun SKILL.md skill
bastani-inc/atomic · .agents/skills/bun/SKILL.md · Use when building, testing, and deploying JavaScript/TypeScript applications. Reach for Bun when you need to run…
v1.0 · audit B · 874 stars
gh-commit SKILL.md skill
bastani-inc/atomic · .agents/skills/gh-commit/SKILL.md · Create well-formatted commits with conventional commit format.
git:20260515.c4cb45d · audit A · 874 stars
gh-create-pr SKILL.md skill
bastani-inc/atomic · .agents/skills/gh-create-pr/SKILL.md · Commit unstaged changes, push changes, submit a pull request.
git:20260515.c4cb45d · audit A · 874 stars
gh-stack SKILL.md skill
bastani-inc/atomic · .agents/skills/gh-stack/SKILL.md · Manage stacked branches and pull requests with the gh-stack GitHub CLI extension. Use when the user wants to create…
v0.0.9 · audit A · 874 stars
prek SKILL.md skill
bastani-inc/atomic · .agents/skills/prek/SKILL.md · Use when setting up or running hooks with prek in any repository. prek is a Rust drop-in alternative to pre-commit for…
git:20260515.c4cb45d · audit A · 874 stars
typescript-advanced-types SKILL.md skill
bastani-inc/atomic · .agents/skills/typescript-advanced-types/SKILL.md · Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and…
git:20260515.c4cb45d · audit A · 874 stars
typescript-expert SKILL.md skill
bastani-inc/atomic · .agents/skills/typescript-expert/SKILL.md · TypeScript and JavaScript expert with deep knowledge of type-level programming, performance optimization, monorepo…
git:20260515.c4cb45d · audit A · 874 stars
AGENTS.md AGENTS.md file
bastani-inc/atomic · AGENTS.md
git:20261027.e3a8014 · audit A · 874 stars
CLAUDE.md CLAUDE.md file
bastani-inc/atomic · CLAUDE.md
git:20260716.9ae109d · audit A · 874 stars
dynamic-resources SKILL.md skill
bastani-inc/atomic · packages/coding-agent/examples/extensions/dynamic-resources/SKILL.md · Example skill loaded from resources_discover
git:20260515.c4cb45d · audit B · 874 stars
calendar SKILL.md skill
bastani-inc/atomic · packages/coding-agent/test/fixtures/skills-collision/first/calendar/SKILL.md · First calendar skill.
git:20260515.c4cb45d · audit B · 874 stars
calendar SKILL.md skill
bastani-inc/atomic · packages/coding-agent/test/fixtures/skills-collision/second/calendar/SKILL.md · Second calendar skill.
git:20260515.c4cb45d · audit B · 874 stars

Every file in bastani-inc/atomic

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.