<p align="center"> <img src="assets/logo.svg" width="96" height="96" alt="MasterMind logo" /> </p>

<h1 align="center">MasterMind</h1>

<p align="center"> <a href="https://mastermind.mehrad.me"><strong>🌐 mastermind.mehrad.me</strong></a> </p>

<p align="center"> <img src="https://img.shields.io/badge/version-0.22.0-7c6bff" alt="version 0.22.0" /> <img src="https://img.shields.io/badge/status-experimental-e0a800" alt="status: experimental" /> <img src="https://img.shields.io/badge/license-MIT-555" alt="license MIT" /> </p>

<p align="center">_{<b>⚗️ Experimental (v0.22.0).</b> Under active development — not yet stable, but usable. Its effect is measured in the open (see <a href="evals/RESULTS.md">evals/RESULTS.md</a>); APIs and defaults may change.}</p>

> **Make your AI coding assistant trustworthy.** MasterMind is plain Markdown that gives Claude Code, > Codex, Cursor, Copilot, and any AGENTS.md tool sharp defaults, real engineering judgment, and the > discipline to **check its own work** — so you can rely on what it produces instead of watching every edit.

No app, no dependencies — just text that loads into your AI. **You don't learn any commands: you talk normally** ("build me X", "why is this slow?", "review this") and MasterMind applies the right discipline automatically. It **improves itself** over time, and it's **tool-agnostic** — one brain for every editor.

> **🗺️ New here?** Explore the <a href="https://foglamp.dev/scan/mastermind-mkfscq" target="_blank" rel="noopener"><b>live interactive map</b></a>.

## Why it exists

Your AI already knows JavaScript, React, and algorithms. Re-teaching those wastes tokens. MasterMind adds only what's *missing* — the judgment and rigor that turn "looks right" into "verified":

- **Good defaults** — which tool/pattern to reach for, so it picks the best option, not the average one. - **A way to decide** — how to choose when there's no obvious default. - **A habit of checking** — verify the work end-to-