mehrad-dm

mehrad-dm/mastermind

Plugin Claude Code

Plugin marketplace listing 1 plugin: mastermind.

mehrad-dm/mastermind

Plugin Claude Code

A markdown brain that gives your AI coding tools judgment and rigor: sharp defaults, real decisions, and the discipline to verify before saying done. For Claude Code, Cursor and Codex.

mehrad-dm/mastermind

Instructions file CodexOpenCode

Instructions for mehrad-dm/mastermind, a project described as: ⚗️ Experimental — A markdown brain that gives your AI coding tools judgment and rigor: sharp defaults, real decisions, and the discipline to verify before saying done. For Claude Code, Cursor and Codex. It improves itself over time.

mehrad-dm/mastermind

Instructions file

Instructions for mehrad-dm/mastermind, covering mastermind: global operating system, prime directives, operating loop, architecture: a lean kernel + on-demand modules and active field pack: what to know & which tools (swappable).

mehrad-dm/mastermind

Agent

Designs the solution BEFORE code is written, module/API boundaries, data model, state, contracts, and tech decisions, for whatever field is active (frontend, backend, mobile…). Use for any non-trivial feature, new module, or architectural choice. Returns a concrete design + one-line rationale per decision, not code.

mehrad-dm/mastermind

Agent

Reviews a diff, a file, or a whole area against MasterMind's principles and rigor gate: correctness, security, edge cases, types, architecture, stack defaults, the field's audit rules. Use after a non-trivial change, before committing, or to audit code you didn't just write. Returns ranked findings and proposed fixes…

mehrad-dm/mastermind

Agent

Restructures working code toward better design WITHOUT changing behavior: deeper modules, a cleaner data model, illegal states made unrepresentable, tangled dependencies unpicked. Use to pay down design/architectural debt on code that already works. Distinct from code-reviewer (finds problems, doesn't edit) and…

mehrad-dm/mastermind

Agent

Makes a technical ADOPTION decision, "should we use library/tool/pattern X (vs Y, vs build it)?": evaluated against MasterMind's reuse-with-judgment rubric and returned as a clear verdict with trade-offs. Use when choosing a dependency, framework, or approach. Distinct from /deep-research (broad reports) and Explore…

mehrad-dm/mastermind

Hook

Runs when a session starts on startup, clear and compact, executing session-start.sh. From mehrad-dm/mastermind.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use the moment the user signals your last answer did not land: "I did not follow that", "I don't understand", "say it simply", "simpler please", "more simply", "you lost me", "what does that mean", "too long", "explain again", "show me", a confused question repeating something you already answered. Re-pitch what you…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when a bug isn't obvious, resists a quick fix, keeps coming back, or you're about to start guessing: "why is this broken", "this keeps happening", intermittent or flaky failures, a crash you can't explain, behaviour that makes no sense. Not for a typo or an obvious mistake.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when the user wants to know where the design is hurting, before choosing what to fix: "this is getting messy", "where should we clean up?", "what is the worst part of this codebase?", "why is this so hard to change?", "it takes five files to add one field". Surveys an area, ranks the candidates, and the user picks…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when something has to be removed or retired, a feature, endpoint, table column, config key, feature flag, package or whole service; migrating consumers off an old API or version; code that looks dead but might not be. Symptoms: "can we delete this?", "is anything still using this?", "we need everyone off v1"…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when you are about to tell the user something works, hand over a decision you feel confident about, or make a change that can't be undone: and when a review came back suspiciously clean. Symptoms: "are you sure?", "you said that was fixed last time", nothing to report, the answer feels too tidy. Not for a routine…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when an internal package, module, or shared component has little or no usage documentation and people (or future AI sessions) keep using it wrong: "document this", "write docs for our library", onboarding someone onto an internal API, or handing a package to another team.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when work needs to survive losing context, before a /clear on a long task, when pausing something unfinished, when handing over to a teammate or the next session, when the context window is filling up on multi-day work, or when a long multi-step task starts re-covering ground it already finished. Not the project's…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when the user asks what MasterMind can do or how to drive it: "help", "what can you do", "how do I use this", "what commands are there", "list your skills", "what are my options": or when they seem unsure how to get started.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use on the first substantive work in a project MasterMind isn't set up for yet, when the user says "init", "initialize", "set up MasterMind", "onboard", "get me ready", or when no field pack matches the project's detected stack.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when the ask is ambiguous, the scope is unclear, terms are being used inconsistently, the work spans multiple files, or it will be handed to another session: and whenever the user wants to be interviewed about it: "interview me", "ask me what you need", "question me on this", "tear this PRD/spec/plan apart", "what…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when a task depends on tech you don't actually know, an unfamiliar library, a fast-moving framework, a tricky API, an unfamiliar codebase: or whenever "I think it works like…" is load-bearing. Just-in-time and task-scoped; distinct from levelup, which updates the durable knowledge base.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use after a correction or review finding worth remembering, when standards may have drifted from the live ecosystem, when switching MasterMind to a new domain or stack, or when the user says "remember this", "learn from that", "so you don't repeat it", "don't make that mistake again", "level up", "update your…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use to check MasterMind's own instruction files, the kernel, core, skills and agents: for bloat, repeated rules, and contradictions between layers. Fires before a release, after several skills changed, or when the brain feels bloated or self-contradictory. Reports findings with file:line; you approve every change.…

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when something is slow, "why is this slow", "optimize this", "make it faster", jank, lag, a slow query, slow page load, slow render, slow build, high memory, a timeout. Not for correctness bugs; that's debug.

mehrad-dm/mastermind

Skill Claude CodeCodex

Use when the user wants code written in the documented public style of a named engineer they admire: "write this like Dan Abramov", "make it read like Kent C. Dodds", "in the style of that OSS author". For a public figure with a real body of work; a private colleague's style is signature (quarantine-gated). A lens on…