# Breaking Change: Legacy Plan Commands Removed (v3.5.0)

**Version 3.5.0 of CleverAgents removes all legacy plan commands and requires use of the V3 Plan Lifecycle.**

## What Changed

The following legacy CLI commands have been completely removed:

- `agents tell` - **Use `agents plan use <action> <project>` instead**
- `agents build` - **Use `agents plan execute <plan-id>` instead**
- `agents new` - **Use `agents plan use <action> <project>` instead**
- `agents current` - **Use `agents plan status <plan-id>` instead**
- `agents cd` - **Use explicit `<plan-id>` in commands instead**
- `agents continue` - **Use `agents plan prompt <plan-id> "instructions"` instead**
- `agents apply` (legacy) - **Use `agents plan apply <plan-id>` instead**
- `agents list` (legacy) - **Use `agents plan list` instead**

## Migration Required

If you have code, scripts, or tests that use the legacy commands, you **must update them to use the V3 commands**.

### Quick Migration

**Before (Legacy):**
```bash
agents tell "Create a feature"
agents build
agents apply
```

**After (V3):**
```bash
agents plan use my-action ./src
agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J
agents plan apply 01HXM8C2ZK4Q7C2B3F2R4VYV6J
```

## Why This Change

- **Single Architecture**: Removes maintenance burden of supporting two incompatible plan systems
- **Clarity**: Users no longer need to understand the difference between legacy and V3 modes
- **Simplification**: Reduces CLI complexity and confusion about which commands are current
- **V3 Advantages**: The V3 architecture provides:
  - Explicit ULID-based plan tracking
  - Phase-aware execution (Strategize → Execute → Apply)
  - Better error handling and recovery
  - Decision tree inspection and correction
  - Hierarchical subplan support
  - Parallel execution capabilities

## Migration Guide

See [docs/Legacy_to_V3_Guide.md](Legacy_to_V3_Guide.md) for detailed step-by-step migration instructions with examples.

## Questions?

For more information on the V3 Plan Lifecycle, see:
- [CleverAgents Specification](specification.md) - Complete architectural reference
- [CLI Command Reference](reference/cli.md) - Detailed command documentation
- [ADR-021: CLI and Output Rendering](adr/ADR-021-cli-and-output-rendering.md) - Design decisions
