Skip to content

// a genius-builder brain for your AI

v0.31.10 · experimental

Your AI writes code.
MasterMind makes it write good code.

It's a lightweight layer of markdown that gives your AI coding superpowers: sharp defaults, real judgment, and the discipline to check its own work. You don't learn commands: just talk, and it applies the right discipline automatically.

works with

Claude CodeCursorCodex
first run · no commands to learn

you ▸ init

detected Next.js · TypeScript · Tailwind

frontend field built for your stack · ready

you ▸ build a dropdown menu

🧠 MasterMind ▸ building this. Will verify before handoff

└ build · frontend pack · plan → implement → verify

keyboard nav, ARIA roles, focus trap · via the router

🧠 verified ▸ keyboard + screen-reader pass · 1 focus bug fixed before handoff

▸ good code, first try

// 01 · the problem

By default, AI writes average code.

The models are powerful, but the results are average. They reach for the most common answer, and they forget your rules every time a new chat starts.

01

Looks right, but isn't

Confident code that quietly breaks on the cases no one mentioned.

02

You keep repeating yourself

You paste the same rules and preferences into every new chat.

03

Average by default

It picks the safe, common pattern instead of the best one for your problem.

// 02 · what it is

It adds judgment, not more facts.

Your AI already knows the syntax. MasterMind adds what it's missing: good defaults, a clear way to make decisions, the habit of checking its work, and taste. Then it picks the right approach for your task.

core/mindset.md

# The best code is the code you never wrote.

Good taste makes the special case disappear.

Get the data model right and the code shrinks.

# Never on the chopping block:

correctness · security · a11y

# Judgment over inventory

choose & compose, don't hoard.

Makes better choices

Picks the right tool and pattern for the job, not just the most common one. It reuses proven solutions, but never copies them blindly.

Checks its own work

It tests before it says "done," and never trades correctness, security, or accessibility for speed.

Fits your stack

It finds your tools and versions, reads the current docs when it needs to, and follows today's best practices, not old memory.

Gets better over time

It learns from real work and trusted sources, and saves the useful lessons for next time.

// 03 · the router

It loads only the knowledge your task needs.

MasterMind's knowledge is many small files. Normally your AI would have to pull in the whole pack just to figure out which parts matter, and pay for all of it. The router is a tiny prebuilt index that points each task straight to the few files it actually needs. Across the measured tasks that was two to four of them.

without the router

loads all 6

you ▸ build an animation

web-animations.mdstack-defaults.mdlessons.mdaudit-rules.mdmentors.mdcurriculum.md

~20,870 tokens · reads everything to decide

with the router

index ▸ this task loads 1 of 6

you ▸ build an animation

web-animations.md stack-defaults.mdlessons.mdaudit-rules.mdmentors.mdcurriculum.md

~5,002 tokens · loads only what the task needs

~65%

fewer tokens per task

average of 4 measured tasks · range 41–89%

The index is prebuilt by a script: no guessing, no network. The saving is every file it didn't load. And the whole brain is yours, copied into your repo, ready to commit and versioned like code, not a symlink to some global install. If the index is ever missing, MasterMind just loads the field the normal way. It only ever speeds things up.

// 04 · signature

Code with a signature you choose.

Every codebase has a signature: the primitives someone reaches for, how they name and factor things. MasterMind lets you choose the signature your code carries: your own team's, or an engineer's you admire.

your team's signature

Learns the style you actually enforce

The corrections you give your AI over and over (“do it this way, not that”) become permanent rules instead of repeated fixes. MasterMind reads your real code and review notes, and captures the conventions no one ever wrote down.

you ▸ “use our cn() helper, not clsx”

🧠 MasterMind ▸ learning your house style

└ signature · saved as a rule, applied from now on

stays private on your machine · patterns, never people

a signature you admire

Write in the style of someone great

Name anyone with a public body of work (Dan Abramov, Kent C. Dodds, whoever you learn from) and MasterMind writes in their documented style: the patterns, structure, and principles they’re known for. Not limited to your own projects.

you ▸ build this like Kent C. Dodds

🧠 MasterMind ▸ writing in his documented style

└ persona · colocation · testing-library idioms · cited

A signature shapes taste, never correctness. It’s written in someone’s documented style, grounded in their real public work, never a claim they wrote it, and never at the cost of a bug.

// 05 · how it works

A small core. The rest loads when needed.

Almost nothing loads up front. The always-on part stays tiny; everything else loads only when your task needs it, so your AI adapts to your stack and checks its own work without carrying dead weight.

KERNELalways loaded, tiny
identity · prime directives · the router
COREuniversal: how to think & work
mindset · principles · rigor · agent-loop · product-sense
FIELD PACKswappable per domain
stack-defaults · audit-rules · curriculum · mentors · lessons
SKILLS + AGENTSa growable library + expert roles
build · debug · qa · … + architect · reviewer · …
SELF-LEVELINGgets better over time
capture lessons · refresh standards · bootstrap fields

// 06 · the library

22 skills. 4 agents. Not one command to learn.

From a quick debug to a full design pass, MasterMind reaches for the right workflow on its own. You just describe what you want. Here are a few it leans on most; the rest are one click away.

// 07 · get started

Drop it into a project. Sharp from the first task.

One command inside your project, restart your tool, and just talk. It wires Claude Code, Cursor and Codex, and it's yours, sitting in your repo ready to commit. Want Claude Code wired in every project? Add --global, it wires Codex's ~/.codex/AGENTS.md too; Cursor stays per-project by design.

works with

Claude CodeCursorCodex