project-min-evaluation

Project Minimum Evaluation

Activation Contract

Load this skill before reporting implementation work as complete, before committing, or when asked to verify quality.

Hard Rules

1. Detect the package manager from the project; never hardcode a runner.
2. Run only scripts defined in package.json scripts; report expected scripts that are missing instead of inventing commands.
3. Run from the repository root, in the order below, and do not skip a failing step to reach a later one.
4. Never claim completion while a check fails or was not run.

Decision Gates

Project signal	Runner
packageManager field in package.json	use the manager it names
pnpm-lock.yaml	pnpm run <script>
bun.lock or bun.lockb	bun run <script>
package-lock.json, or no other signal	npm run <script>

Script	Run when
lint	always, if defined
typecheck	always, if defined
format:check	always, if defined
test	always, if defined
doctor	always, if defined
check	always, if defined (aggregate gate)
test:e2e	only when end-to-end behavior changed

Execution Steps

1. Read package.json and the lockfiles to choose the runner.
2. Collect the scripts from the table that exist in scripts.
3. Run each existing script in table order with the chosen runner.
4. Stop at the first failure, fix it, and rerun from that script.

Output Contract

Report each script as passed, failed, or not defined. For a failure or a check that cannot run, give the exact command, the exact error, and the unverified scope.

References

• references/script-discovery.md — detection edge cases.