Skip to content

Make targets

The big picture: Every command in Blueprint is a make target, so a hook, CI and a person all mean the same thing by “passes”. make help prints the targets that carry a ## description comment in the Makefile; this page lists exactly that set.

Why it matters: Most targets are gates you never run by hand, because make pre-push-checks runs them for you. Knowing which group a target is in tells you whether a red result is about your code, your environment, or the harness.

This page is kept in step with the Makefile by scripts/check-harness-reference.py (make check-harness-reference): a target with a description and no row here fails the check, and so does a row for a target that no longer exists.

Run once per clone, or when the environment looks wrong.

Target What it does
make setup First-time project setup: installs the pre-commit and pre-push git hooks.
make doctor Checks prerequisites and environment health. Also warns (without failing) when your global ~/.claude/CLAUDE.md holds a copy of the fast-paths table, which would contradict the project’s own; it reports only the file’s size, never its contents.
make customize Reports what is still unconfigured from the template; reports only, never edits.
make status Prints the lifecycle checklist (Configure, Specify, Plan, Build, Release) derived from the repo and tracker, with one Next: line.
make help Prints this target list.

The stack-specific targets. They ship as stubs that print a warning and exit 0 until you configure them (make customize lists the ones still unconfigured).

Target What it does
make lint Runs the linters.
make format-check Checks formatting without writing; the pre-commit hook runs it.
make format Fixes formatting.
make typecheck Runs the type checker.
make test Runs the test suite.
make test-scoped Runs test, then records the marker the Stop hook checks (see Hooks).
make build Builds artifacts.
make clean Removes build artifacts.
make gitleaks-check Scans staged changes for secrets with gitleaks; also a pre-commit hook step.
Target What it does
make pre-push-checks The local gate suite the pre-push hook runs: most of the gates listed under Gates below, run in one pass.
make gate-self-tests Proves the check scripts can still fail. A local convenience; CI proves it per job.
make memory-check Checks the Claude memory index for size and dangling links.

Each check-* target is a script under scripts/ with a --self-test that proves it can fail. See Harness gates for the shared rules.

Target What it does
make check-collision Blocks a push that would open a duplicate MR for an issue.
make check-migration-numbering Blocks a push whose new migration collides with the numbering on origin/main.
make check-parity Asserts every CI gate script is runnable before push.
make check-selftest-parity Asserts every CI gate proves it can fail, in its own job.
make check-changelog An MR with product changes carries a changelog fragment, and CHANGELOG.md is not edited directly.
make check-gate-ledger The MR ## Gates lint can still reject free-text outcomes (see The Gates ledger).
make check-gate-yield The gate-yield ledger parser still parses its fixtures.
make check-single-fastpath-table One fast-paths table only; no rule heading in both AGENTS.md and CLAUDE.md.
make check-claudemd-size No tracked CLAUDE.md exceeds 200 lines, and the always-loaded files stay within the byte budget in scripts/claudemd-byte-budget.txt.
make check-agent-contract Every agent file has a “Do not use” clause, and review gates use one severity scale.
make check-skill-names No skill name equals a Claude Code bundled skill, command or alias.
make check-skill-breadcrumbs The six phase skills end with one identical lifecycle-checklist block, and /next only relays scripts/blueprint-status --markdown --explain or --issue <digits>.
make check-commands-doc Every skill has a commands.md section with Before this: and Next: lines.
make check-cc-claims Claims about Claude Code behavior carry a code.claude.com link and a checked date.
make check-load-bearing Every call site declared load-bearing is still present.
make check-docs-links Internal doc links, anchors and assets resolve; skips if there is no docs site.
make check-bare-issue-refs No bare issue-number reference in a shipped harness file.
make check-stale-refs STUB and WIP markers never merge, and TODO and SUPPRESSED-UNTIL markers name an open issue. It also checks slash commands, renamed skills and ADR links; see Harness gates for the full rule list.
make check-specs Spec files under docs/specs/ pass the completeness gate.
make check-evals Every eval case can fail and its scaffold builds what it promises.
make check-app-fixture-gates Application-aware gates pass a real app fixture and reject seeded drift.
make check-added-files-covered Every added source file appears in its coverage report; skips if node is absent.
make check-ts-parity Backend schema and TypeScript interfaces agree; skips if there is no schema or types.
make check-ws-reachability The published real-time event taxonomy names only reachable events; skips if there is no doc.
make check-edition-boundary The open-source tree never names a configured enterprise package.
make check-version-lockstep Every version-bearing manifest agrees, and none is behind the changelog.
make check-security-deferred Every issue that ever carried the security-deferred label is resolved.
make check-ci-yaml No duplicate YAML keys in the CI files, and .gitlab-ci.yml dry-runs with every include enabled.
make check-compose Every standalone compose file pins its own project name.
make check-artifact-asserts Tag-triggered jobs assert their declared artifacts:paths are non-empty.
make check-nul-bytes No tracked text file contains a literal NUL byte.
make check-hook-parse The Claude Code hooks parse under macOS /bin/bash 3.2: no heredoc sits inside $( ) or <( ), and each hook passes /bin/bash -n where it is 3.x.
make check-portability No BSD-only or GNU-only shell idiom in any shell script.
make check-sigpipe No early-exit reader (grep -q, head) behind a pipe in any shell script.
make check-complexity Cognitive-complexity tier for script entry points (opt-in).
make check-mutation-selftest The reference mutation gate still fails closed.
make check-scanner-gates-selftest The optional SAST and secret-detection severity gates still fail closed.
make check-harness-reference Every hook, scripts/wt subcommand and make target has an entry on its reference page.
make check-docs-stale No doc quotes a make target, script or flag that no longer exists, or one this branch removed.
Target What it does
make release-pipeline-check Asserts every job in this commit’s branch pipeline passed before a tag publishes (run inside a tag pipeline; job-by-job judgment ships in 0.8).
make check-release-ci-file Ships in 0.8. Every tag-triggered CI job strictly needs: release-pipeline-gate, and every job the gate’s lists name exists.
make helm-drill Runs the Helm install and upgrade drill locally; needs docker, kind, kubectl and helm.
make eval Paid: runs the behavioral eval suite with claude plugin eval; needs EVALS_CONFIRM=1.