blueprint-repo-baseline

Green before anything moves

Every later change claims "this behaves the same". That claim is measured against these gates, so they must be the repository's own, and they must be green on the untouched code. A gate that is already red cannot tell a regression from the state it was in.

1. Package manager from the lockfile: yarn.lock → yarn, pnpm-lock.yaml → pnpm, package-lock.json → npm, bun.lockb/bun.lock → bun. The install command must not rewrite the lockfile: yarn install --frozen-lockfile, pnpm install --frozen-lockfile, npm ci, bun install --frozen-lockfile.
2. Gates from package.json scripts, in this order when present: a format CHECK (format:check, never a script that rewrites files), lint, typecheck, build, test. Read what each script runs.
   • Leave out a script that needs a service, a browser download or network the machine may not have (test:e2e and the like), and write why in the record.
   • Read the CI workflows too: CI is the ground truth these approximate. A gate CI runs and package.json lacks is worth noting.
3. Write .blueprint/gates.json:

   {
     "packageManager": "yarn",
     "install": "yarn install --frozen-lockfile",
     "gates": [{ "name": "lint", "command": "yarn lint" }, { "name": "test", "command": "yarn test" }],
     "skipped": [{ "name": "test:e2e", "why": "needs a browser download" }]
   }
   

   name is the script name exactly as package.json has it.
4. Run the install, then every gate, and read each exit code — never the last line of output.
5. If any gate is red on the untouched code, ask: it is the person's decision whether to fix it first (as its own change) or leave that gate out with a reason. Do not change the repository in this step.

Done when the check passes: every recorded gate exits 0 on the untouched default branch.

Always

• Read .blueprint/spec.md if it exists. It is the agreed plan; do not widen it.
• When you need a decision, ask it through the blueprint question tool and stop. Do not guess.
• Change nothing in the repository in this step.
• Say you are done by stopping; the executor runs the check. Do not claim success yourself.