# Milestones

This section documents the major milestones in the CleverAgents v3 release series.
Each milestone page covers the features delivered, CLI commands introduced, and
architectural decisions made during that release cycle.

## Release Overview

| Milestone | Version | Title | Status |
|-----------|---------|-------|--------|
| M1 | [v3.0.0](v3.0.0.md) | Minimal Local Source-Code Workflow | Released |
| M2 | [v3.1.0](v3.1.0.md) | Actor Compiler + Full LLM Integration | Released |

## What Is a Milestone?

CleverAgents uses **Clever Semantic Versioning** (MAJOR.MINOR.PATCH) where each
MINOR version bump corresponds to a planned milestone delivering a coherent set of
features. Milestones are tracked as Forgejo milestones and linked to epics
in the issue tracker.

Each milestone page documents:

- **Goals** — What the milestone set out to achieve
- **Delivered Features** — Concrete capabilities added
- **CLI Reference** — Commands introduced or changed
- **Architecture Notes** — Key design decisions
- **Migration Guide** — Breaking changes and upgrade steps (if any)

## Related Resources

- [Implementation Timeline](../timeline.md) — Full chronological timeline
- [Architecture](../architecture.md) — System architecture overview
- [API Reference](../api/index.md) — Module-level API documentation
- [CHANGELOG](https://git.cleverthis.com/cleveragents/cleveragents-core/src/branch/master/CHANGELOG.md) — Detailed change log
