bradtraversy

Bring the blueprint into an existing (brownfield) codebase. Surveys the real repo, interviews you for the intent code can't reveal, then generates the two plans you own (project-plan.md with shipped features, build-plan.md as a checklist with existing…

Read-only code quality audit for a Blueprint project. Reviews the code up to the current point for maintainability issues such as duplication, dead code, DRY violations, inconsistent patterns, overgrown files or functions, unused exports, missing tests for…

Optional explicit Blueprint mode for one bounded spec/build/check pass. It can pick or resume the current feature, write the spec when needed, create or reuse the branch, implement small steps, run build/tests/checks, create checkpoint commits after passing…

Prove the current work actually does what its spec says by running the real app and observing behavior against the "done when" criteria in current-feature.md. Drives the app (browser, CLI, or server), captures evidence (screenshots, output, console/network…

Wrap up a finished feature or fix. Archives its spec to blueprint/history/features/ (feature) or blueprint/history/fixes/ (fix), checks features off the build plan, resets blueprint/context/current-feature.md to its stub, makes one feature-level commit, then…

Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint…

Turn a feature from build-plan.md into a buildable spec. With no argument, specs the next unchecked item in the build plan; given a number or name, specs that one. Sizes the feature and splits anything too big into smaller sub-features (4a, 4b, ...), writes…

Document an ad-hoc bug fix or small change (one not in the build plan) into blueprint/context/current-feature.md so it runs through the same build loop. Writes a short fix spec and stops; then /implement builds it and /complete logs it to…

Code quality audit for a Blueprint project, read-only except the findings ledger it maintains at blueprint/context/findings.md. Reviews the active feature, changed files, a selected path, or the full project for maintainability issues such as duplication,…

Optional explicit Blueprint mode for one bounded spec/build/check/audit pass. It can pick or resume the current feature, write the spec when needed, create or reuse the branch, implement small steps, run build/tests/checks, create checkpoint commits after…

Wrap up a finished feature, fix, or rollback. Runs a final safety pass, archives its spec to blueprint/history/features/, blueprint/history/fixes/, or blueprint/history/rollbacks/, updates the build plan for features and rollbacks, resets…

Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint…

Turn a feature from build-plan.md into a buildable spec. With no argument, specs the next unchecked item in the build plan; given a number or name, specs that one. If a clearly new feature does not match the plan, proposes a reviewed plan addition, refreshes…

Document an ad-hoc bug fix or small change (one not in the build plan) into blueprint/context/current-feature.md so it runs through the same build loop. Writes a short fix spec and stops; then /implement builds it and /complete logs it to…

Build the feature, fix, or rollback spec'd in blueprint/context/current-feature.md, one small reviewable step at a time. Creates the matching branch, implements each step, shows the diff and explains it in plain English, tests, and iterates until it works.…

Set up the Blueprint after overlaying it onto a freshly scaffolded or early project. Detects the stack, relocates the copied Blueprint README when needed, updates AGENTS.md commands, sets the CLAUDE.md project title when present, tunes coding-standards.md,…

Review an article for thesis support, reasoning, definitions, counterarguments, evidence boundaries, recommendations, limits, and conclusions. Use when an agent needs an independent logic review for opinion, comparison, analysis, case study, or…

Review an article, essay, guide, comparison, case study, or analysis for factual accuracy, source support, quotation integrity, freshness, and overclaiming. Use when an agent needs an independent fact check before revision or publication packaging.

Review an article for reader usefulness, clarity, structure, progression, examples, unanswered questions, skimmability, and reading flow. Use when an agent needs an independent audience-focused review before revision.

Review search-led writing for intent satisfaction, accurate titles and headings, query coverage, metadata, links, structured-data fit, originality, and refresh needs. Use when organic search discovery matters to an article, guide, comparison, case study, or…

Review technical writing for correct code, commands, terminology, completeness, security, privacy, compatibility, and documented or observed product behavior. Use when an article, tutorial, guide, comparison, or case study includes implementation steps or…

Review an article for author voice, humanity, personal grounding, and resistance to generic AI copy. Use when an agent needs an independent voice check against a supplied voice packet, author-written sources, exact notes, or approved firsthand material.

Develop articles, essays, guides, comparisons, case studies, and timely analysis from intake through research, angle selection, outline, draft, independent review, revision, and publication-ready packaging. Use when an agent needs a rigorous writing workflow…

Enable Mentor Mode on this repository. Use when the user runs /mentor-init, asks to set up mentor mode, enable learning mode, or initialize the guided learning workflow on a project.

End a Mentor Mode session with the explain-back gate, ledger and curriculum updates, a session log, and a next-session preview. Use when the user runs /mentor-wrap, says wrap up, end session, or done for today in a Mentor Mode repo.

Start a Mentor Mode learning session. Use when the user runs /mentor, says start a session, begin today's lesson, or let's learn in a Mentor Mode repo.

Deep-dive one concept at the learner's level in a Mentor Mode repo, using their own code for examples. Use when the user runs /explain or asks how something works conceptually during a session.

On-demand recall drill from the Mentor Mode ledger. Use when the user runs /mentor-quiz, asks to be quizzed, wants a drill, or wants to test recall between sessions.

Teaching review of code the learner just wrote in a Mentor Mode repo. Use when the user runs /mentor-review, asks to review what I wrote, or finishes an attempt on the active objective.

Reveal the solution for the active Mentor Mode objective after the learner explicitly asks. Use only when the user runs /reveal or explicitly asks to be shown the solution code.

Clean up project housekeeping tasks (add "run" to execute fixes)

Manage current feature workflow - start, review, explain or complete

List project components

Run a research task to generate documentation

Clean up project housekeeping tasks (add "run" to execute fixes)

Manage current feature workflow - start, review, explain or complete

List project components

Wrap up a finished feature or fix. Archives its spec to blueprint/history/features/ (feature) or blueprint/history/fixes/ (fix), checks features off the build plan, resets blueprint/context/current-feature.md to its stub, makes one feature-level commit, then…

Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint is installed correctly,…

Set up the Blueprint after overlaying it onto a freshly scaffolded or early project. Detects the stack, relocates the copied Blueprint README when needed, updates AGENTS.md commands, sets the CLAUDE.md project title when present, tunes coding-standards.md,…