Design System: Anonymous Study (BRAIN.md)

Design Philosophy & Aesthetic

Extracted from anonymous reference. The Anonymous Study design system applies Anonymous Study Geist's monochrome precision to developer workflows. It pairs ultra-sharp typefaces, mathematical gray scales, zero-dependency structural simplicity, and high-contrast terminal code windows.

Color Tokens & Semantic Scale

Click any swatch to copy its hex value to the clipboard.

Paper (Light)

#ffffff

Ink (Gray 1000)

#171717

Chip (Gray 100)

#f2f2f2

Blue Prompt

#006bff

Purple Sigil

#a000f8

Green Truth

#28a948

Red Error

#fc0035

Amber Warning

#ffae00

Typography & Type Scale

Hero Title (Geist Sans 600 · -2.4px tracking)40px / 48px

BRAIN.md — Persistent memory

Section Heading (Geist Sans 600 · -0.96px tracking)24px / 32px

How the compiled_truth engine works

Terminal Code (Geist Mono 400)13px / 1.6

$ brain update-truth --id auth-strategy --reversal

Terminal Preview & Traffic Lights

High-contrast, macOS 3-dot traffic light terminal windows demonstrate side-by-side agent interactions.

Without BRAIN.md

❯ Let's keep working on auth

✦ What kind of app is this? Tech stack? Constraints?

You just typed 318 words again.

With BRAIN.md

❯ Let's keep working on auth

✦ From brain/pages/auth.md: Electron + SQLite, local-first. Picking up session strategy.

One prompt in. Agent is fully caught up.

Workflow Chain & Spatial Arrows

1. Chat

You work through architectural trade-offs with an agent in natural language.

compile →

2. Brain

update-truth atomically rewrites truth and appends decision timeline.

resume →

3. Task

Fresh chats or teammates load brain/ first with zero re-explanation.

Feature Cards Grid

# zero runtime deps
$ npm i -g @mindmux/brain-md

Zero Dependencies

No service, no daemon, no background MCP server. Pure Markdown files in git.

$ brain update-truth
↳ rewrites compiled_truth

Correct by Construction

Frontmatter formatting and atomic timeline mutations are structurally guaranteed by CLI.

[[db-choice]]
$ brain lint-links ✓

Wiki-Link Graph

Cross-reference granular decision pages with double bracket [[page-id]] syntax.

Protocol Entry Points Table

File	Audience	Purpose
README.md	Humans	Quick start, installation, high-level intro
AGENTS.md	AI coding agents	Execution rules, build commands, test instructions
BRAIN.md	Any reasoning agent	Protocol entry point — guides how to read & write the brain
brain/	Agents & humans	Decisions, tradeoffs, architecture, flow, stack, roadmap

FAQ Accordion Disclosures

What is BRAIN.md?

BRAIN.md is a plain-file convention for storing project knowledge in a repository. It gives agents and humans a predictable place to find decisions, rationale, constraints, and current project context.

Why does it separate compiled_truth and timeline?

compiled_truth records the current best understanding of a topic. timeline records the evidence, decisions, reversals, and notes that led there. The split lets agents read the current answer quickly while preserving the reasoning history.

How does it differ from MCP?

MCP is a runtime protocol integration layer. BRAIN.md is a repository-local Markdown convention plus a small CLI, so the project knowledge remains readable, reviewable, and versioned in git.

Do's and Don'ts

✓ Do

Keep terminal surfaces high-contrast and dark (#171717) regardless of light/dark theme.
Use Geist Mono strictly for commands, prompts, file trees, and code snippets.
Use negative letter-spacing on bold headings (-2.4px on hero, -0.96px on sections).
Use pill border-radius (9999px) for primary and secondary action buttons.

✗ Don't

Don't introduce colorful gradient fills across body backgrounds.
Don't use saturated primary colors for body text; keep ink at #171717 / #ededed.
Don't use heavy drop shadows on cards; prefer subtle borders and 2px raised elevations.
Don't mix non-monospace fonts inside terminal preview windows.

Agent Prompt & Raw Spec

Build a developer-first interface following the Anonymous Study (BRAIN.md) design system. - Foundation: Geist design language, clean monochromatic palette (Paper #ffffff / #000000, Ink #171717 / #ededed, Gray 100-1000 scale). - Typography: Geist Sans for headings and body, Geist Mono for code and terminal UI. Use -2.4px tracking on hero titles, -0.96px on section headings. - Components: macOS 3-dot terminal windows (#ff5f57, #febc2e, #28c840), pill buttons (48px height, 9999px radius), 3-step workflow arrows, responsive 3-column feature cards, and 45-degree rotating chevron accordions. - Accents: Semantic blue (#006bff) for prompts, purple (#a000f8) for sigils, green (#28a948) for strings and success states, red (#fc0035) for before/errors.