CLI Reference
betterspec verify
Verify a change against its specs
betterspec verify
Run a structural verification check on a change to ensure all required files exist and are populated.
Usage
betterspec verify [change]If [change] is omitted, the command verifies all active changes.
Checks
The following structural checks are performed for each change:
| Check | What it verifies |
|---|---|
| Proposal exists | proposal.md is present and non-empty |
| Requirements exist | specs/requirements.md is present and non-empty |
| Scenarios exist | specs/scenarios.md is present and non-empty |
| Design exists | design.md is present and non-empty |
| Tasks exist | tasks.md is present and non-empty |
Each check reports pass or fail.
Examples
Verify a single change:
$ betterspec verify add-webhook-support
Verifying: add-webhook-support
PASS proposal exists
PASS requirements exist
FAIL scenarios exist — file is empty
PASS design exists
FAIL tasks exist — file not found
Result: 3/5 checks passedVerify all active changes:
$ betterspec verify
Verifying: add-webhook-support 3/5 passed
Verifying: refactor-auth-middleware 5/5 passed
Verifying: fix-rate-limiter 5/5 passed