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. |
Everyday
Section titled “Everyday”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. |
Before you push
Section titled “Before you push”| 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. |
Release and paid checks
Section titled “Release and paid checks”| 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. |