comet guard

comet guard is the stable phase-check command.

comet guard <change-name> <phase>
comet guard <change-name> <phase> --apply

Without --apply, it reports readiness without changing state. With --apply, it advances through a legal transition only after every check passes.

Phase	Typical checks
open	Proposal, design, tasks, and delta specs are complete.
design	The Design Doc and handoff evidence exist and point to the current change.
build	Required workflow choices, completed tasks, and build evidence are present.
verify	Verification evidence and result are available.
archive	Verification passed and final confirmation is complete.

build_command and verify_command are not valid .comet.yaml fields. Guard detects npm, Maven, or Cargo commands from project files. When it cannot infer an entrypoint, execute the real project command and record it with comet state record-check; guard validates the record instead of bypassing the check. The packaged comet-guard.mjs launcher remains for compatibility, but normal use should prefer comet guard.

Last modified on July 12, 2026

Install and health checks

Skills, evals, and publishing

Core scripts