# Agentstack Milestones

Validation-driven execution. **Start with the active milestone**, not the consumer readiness roadmap.

## Latest milestone

**M5 preview beta publishability passed.** The approved public package is `@agentstackhq/agentstack` with the
`agentstack` CLI binary. Hosted control-plane work, production gates, live provider mutation, EAS/mobile live proof, and
broad provider matrices remain out of scope until an explicit approach discussion.

## All milestones

| ID | Status | Doc |
| --- | --- | --- |
| M0 | Reference | [Hypothesis](../validation-hypothesis.md) |
| M1 | Complete | [M1-preview-e2e.md](./M1-preview-e2e.md) |
| M2 | Complete | [M2-agent-completes-m1.md](./M2-agent-completes-m1.md) |
| M3 | Live billing path passed; cleanup hardening pending | [M3-billing-webhook.md](./M3-billing-webhook.md) |
| M4 | Complete | [M4-clean-machine-smoke.md](./M4-clean-machine-smoke.md) |
| M5 | Complete | [M5-preview-beta-publishability.md](./M5-preview-beta-publishability.md) |

## New coding agent?

1. Read [validation hypothesis](../validation-hypothesis.md)
2. Read the [M2 lean contract and pass evidence](./M2-agent-completes-m1.md), then read the [M3 milestone](./M3-billing-webhook.md)
3. Read the [M4 local-pack clean-machine smoke](./M4-clean-machine-smoke.md)
4. Read the [M5 preview beta publishability milestone](./M5-preview-beta-publishability.md)
5. Read [operating model](../validation-operating-model.md) if unclear on scope

## Evidence

Redacted artifacts live under `docs/milestones/evidence/<milestone-id>/`. See each folder's README.