check · diff

git:20260716.1d599e1 to git:20260809.e82374b

3 added, 1 removed. Audit B to B.

---
description: Run every Iron Law stage and the drift detector suite. Use when the user wants the full project health snapshot, a CI gate, or to verify nothing regressed before committing. Add --strict to promote warn-severity drift findings to errors. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized projects.
---
# Cladding check
Run `clad check` from the project root. Runs the 15 Iron Law stages — Type / Lint / Drift / Commit / Arch / Secret / Unit / Coverage / Spec-conformance / Deliverable-smoke / Smoke / Performance / Visual / Audit / UAT — and aggregates the worst exit code.
- `0` — every stage cleared or skipped clean.
- `1` — at least one stage actually failed (fix-required).
- `2` — every result is skip (no fail-required input on the project yet).
`--strict` promotes warn-severity drift findings to error, matching the CI / pre-publish gate. The Drift stage runs every active detector under `src/stages/detectors/` — `npm run build:plugin` Phase D recounts them and writes the integer into each plugin manifest (e.g. `plugins/claude-code/.claude-plugin/plugin.json`), so the number is never hand-maintained.
`--internal` shows stage codes (`stage_1.1`) instead of business names (`Type`). Default is the business-name surface; the audit log keeps internal ids regardless.
```
clad check
clad check --strict
clad check --internal
```
## Gate economy (tiers)
Pick the cheapest tier that answers your question — the full pre-push suite is expensive and grows with
the project:
- `clad check --tier=pre-commit` — drift / arch / secret only (spec-vs-code, no full unit suite). Use for
fast inner-loop feedback while implementing.
- `clad check --tier=pre-push --strict` — the full gate (type / lint / unit / cov + drift). This is what
`clad done <featureId>` already runs, so do NOT run it separately right before `clad done` — one
- authoritative full gate per feature, not two. See `docs/feature-cycle.md` § Gate economy.
+ authoritative full gate per feature, not two. A GREEN run refreshes `spec/attestation.yaml` with the
+ running Cladding version, strict blocking mode, detector-catalog SHA-256, module hashes, and feature
+ markers. See `docs/feature-cycle.md` § Gate economy.