ah milestone

Milestone file management and verification commands.

ah milestone create

Create a new milestone file with standard structure.


ah milestone create <NAME> [--dir <PATH>] [--milestones <N>]

Option	Description	Default
`--dir <PATH>`	Directory to create the file in	specs/Public
`--milestones <N>`	Number of initial milestone stubs	3

ah milestone check

Verify milestone file integrity and completion gates.


ah milestone check [FILE] [--run-tests]

Runs three automated checks:

Structural lint — validates the .milestones.org file format
Deliverable completeness — completed milestones have all checkboxes checked
Verification criteria — all verification entries for completed milestones show passed

Option	Description
`--run-tests`	Also run tests referenced by verification criteria

Auto-discovers the milestone file if not specified (searches for *.milestones.org).

ah milestone list

List milestones and their status.


ah milestone list [FILE]

Displays a table with milestone ID, title, status, and deliverable progress.

ah milestone status

Show current milestone progress.


ah milestone status [FILE]

Displays the current milestone, overall completion, and deliverable details.

Examples


# Create a new milestone file
ah milestone create MVP
 
# Verify completion gates
ah milestone check
 
# Check a specific file with test execution
ah milestone check specs/Public/MVP.milestones.org --run-tests
 
# List all milestones
ah milestone list
 
# Show current progress
ah milestone status