# V2 Design

This directory now keeps the current design and process entrypoints for the active V2 line.

Historical planning/review documents were moved to `../docs/archive/design/` to keep this directory smaller and easier to navigate.

## Read First

- `v2-protocol-truths.md`
- `v2-product-completion-overview.md`
- `v2-phase-development-plan.md`
- `v2-semantic-methodology.zh.md`
- `v2-protocol-closure-map.zh.md`
- `v2-algorithm-overview.md`
- `v2-algorithm-overview.zh.md`
- `v2-detailed-algorithm.zh.md`

## Active Process / Workflow

- `protocol-development-process.md`
- `agent_dev_process.md`

## Active Supporting Design

- `v2-acceptance-criteria.md`
- `v2-open-questions.md`
- `v2_scenarios.md`
- `v2-scenario-sources-from-v1.md`
- `v1-v15-v2-comparison.md`
- `wal-replication-v2.md`
- `wal-replication-v2-state-machine.md`
- `wal-replication-v2-orchestrator.md`
- `wal-v2-tiny-prototype.md`
- `wal-v1-to-v2-mapping.md`
- `v2-dist-fsm.md`

## Historical / Archived

See `../docs/archive/design/README.md` for archived:

- old roadmaps
- first-slice planning docs
- passed readiness/slicing reviews
- phase-specific design maps for closed phases

## Execution Note

- active development tracking lives under `../.private/phase/`
- current phase contract and slice packages live there rather than in this directory

The original project-level copies under `learn/projects/sw-block/design/` remain as shared references for now.