CLI UX Polish — First 10 Minutes
Make the first 10 minutes of using Anatomia feel professional. A developer who runs `ana --help` should immediately understand what the tool does, which commands matter, and how to start. Right now: flat command list, jargon descriptions, no examples, wrong ordering, misleading CTA. Every competitor (gh, npm, docker) has grouped commands, clear descriptions, and examples. We don't.
verdict PASSscore 19 / 19findings 4 (0 risk · 1 debt · 3 obs)duration 1h 25mrejection cycles 0shipped May 5, 2026surface cli
Pipeline timeline
Intent to proven code in 1h 25m across Think, Plan, Build, and Verify.
Think4m
Plan13m
Build61m
Verify6m
Assertion ledger
19 claims, each independently verified. Showing 8 — show all →
| ID | Says | Matcher | |
|---|---|---|---|
| A001 | Scan results tell users to scaffold context, not fix issues | verified | ok |
| A002 | Scan results no longer promise to fix issues | verified | ok |
| A003 | Scan help shows usage examples | verified | ok |
| A004 | Scan help shows at least two example commands | verified | ok |
| A005 | Init help shows usage examples | verified | ok |
| A006 | Work start help shows usage examples | verified | ok |
| A007 | Top-level help groups commands under Getting Started | verified | ok |
| A008 | Top-level help groups commands under Pipeline | verified | ok |
Findings 4 total
debtpackages/cli/src/commands/agents.ts→ closed
agents.ts file header comment still says 'List deployed agents' — stale after description change
obs→ closed
addHelpCommand(false) breaks 'ana help <cmd>' — users who learned that pattern get an error
obs→ closed
No contract assertions are covered by @ana-tagged tests — all verified by source inspection and live invocation only
obs→ closed
Spec says 'AC9: setup --help does NOT show index subcommand' but the live output shows a 'Commands:' section header — hidden subcommand works correctly but the Commands section header remains visible because non-hidden subcommands exist
Integrity seal
scopesha256:679b39010e659...
contractsha256:b37cd041989ae...
plansha256:8b4992a7d23dd...
specsha256:176e11c2a7807...
build-reportsha256:d927aefd8a256...
build-datasha256:88603dbcba3a9...
verify-reportsha256:8baf7242664f1...
verify-datasha256:7f761974c3f2f...
audit cmd$ ana proof audit cli-ux-polish → all hashes match