# MasterMind

> A markdown brain that gives Claude Code, Cursor and Codex judgment and rigor: sharp
> defaults, real decisions, and proof before it says done.

It is 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.

Free and MIT licensed. Runs on macOS, Linux and WSL. Current release: v0.31.10, experimental.

## Install

```
npx mastermind-brain
```

Run it from inside the project you want MasterMind in. It wires that project for Claude Code,
Cursor and Codex, and writes an AGENTS.md so any other tool that reads one picks the brain up
too. The same command updates it later.

## Pages

- [Home](https://mastermind.mehrad.me/): what it is, the problem it solves, how it works
- [Start](https://mastermind.mehrad.me/start): install in one command, then just talk
- [Library](https://mastermind.mehrad.me/library): 22 skills and 4 agents, what each does and when it fires
- [Architecture](https://mastermind.mehrad.me/architecture): the kernel, the router, field packs, skills, agents

## Skills

- [init](https://mastermind.mehrad.me/library/init): set MasterMind up for your project in a few quick steps
- [help](https://mastermind.mehrad.me/library/help): the full menu: what it does and how to use each part
- [build](https://mastermind.mehrad.me/library/build): design, implement, verify, review, learn, end to end
- [debug](https://mastermind.mehrad.me/library/debug): structured, evidence-first debugging: not guessing
- [performance](https://mastermind.mehrad.me/library/performance): measure, find the real bottleneck, fix, verify
- [qa](https://mastermind.mehrad.me/library/qa): prove it works end-to-end; adds tests only if you want them
- [report](https://mastermind.mehrad.me/library/report): a shareable write-up of a cycle: opt-in, off by default
- [interview](https://mastermind.mehrad.me/library/interview): agree what is being built (and what is not) before code
- [learn](https://mastermind.mehrad.me/library/learn): learn your real stack and check its own assumptions
- [prototype](https://mastermind.mehrad.me/library/prototype): a fast throwaway experiment to settle one unknown
- [route](https://mastermind.mehrad.me/library/route): load only the files a task needs: fewer tokens, faster
- [prompt](https://mastermind.mehrad.me/library/prompt): sharpen a vague ask into a clear, AI-ready prompt
- [signature](https://mastermind.mehrad.me/library/signature): learn your team's real coding style, then follow it
- [persona](https://mastermind.mehrad.me/library/persona): write in a named engineer's documented public style
- [explain](https://mastermind.mehrad.me/library/explain): AI-friendly docs so any model understands your package
- [quarantine](https://mastermind.mehrad.me/library/quarantine): a private space for sensitive project data: never published
- [levelup](https://mastermind.mehrad.me/library/levelup): capture lessons, refresh standards, bootstrap a field
- [lint](https://mastermind.mehrad.me/library/lint): checks MasterMind's own files for bloat and contradictions
- [double-check](https://mastermind.mehrad.me/library/double-check): interrogate a claim before you hand it over
- [deprecate](https://mastermind.mehrad.me/library/deprecate): remove, migrate, retire: safely and provably
- [roadmap](https://mastermind.mehrad.me/library/roadmap): a decision map that survives months of work
- [handoff](https://mastermind.mehrad.me/library/handoff): a handoff that survives a context reset

## Agents

- [architect](https://mastermind.mehrad.me/library/architect): blueprint before code: boundaries, data model, state
- [code-reviewer](https://mastermind.mehrad.me/library/code-reviewer): adversarial diff review against the rigor gate
- [refactorer](https://mastermind.mehrad.me/library/refactorer): behavior-preserving redesign toward deeper modules
- [tech-scout](https://mastermind.mehrad.me/library/tech-scout): build-vs-buy decisions, reuse-with-judgment

## Source

- Repository: https://github.com/mehrad-dm/mastermind
- License: MIT