# Requirements: v1.2 Systematization & Cohesion (ARCHIVED)

> **Status:** SHIPPED 2026-04-24 — All requirements complete
> **Milestone:** v1.2 Systematization & Cohesion
> **For current requirements, see:** `.planning/REQUIREMENTS.md` (created for next milestone)

---

## Context

Milestone v1.1 hardened the sandbox onboarding flow. v1.2 transforms the project from a functional-but-scattered prototype into a cohesive, user-centric system.

---

## Requirements Traceability

| ID | Requirement | Status | Phase | Outcome |
|----|------------|--------|-------|---------|
| SYS-01 | Unified Agent Command Namespace | Complete | 9 | All `/pf-*` docs created, old docs removed |
| SYS-02 | CLI Simplification | Complete | 9 | `sync` and `ocr` unified, backward compat maintained |
| SYS-03 | Agent↔CLI 1:1 Mapping | Complete | 10 | docs/COMMANDS.md master reference created |
| SYS-04 | Architecture Documentation | Complete | 10 | ARCHITECTURE.md with 10 ADRs |
| SYS-05 | Migration Guide | Complete | 10 | MIGRATION-v1.2.md with rollback instructions |
| SYS-06 | Consistency Audit | Complete | 10 | 4/4 automated checks passing |
| SYS-07 | Test Coverage for Unified Commands | Complete | 9 | 178 tests passing, 0 failures |

**Coverage: 7/7 Complete (100%)**

---

## Requirement Details

### SYS-01: Unified Agent Command Namespace

**Status:** ✅ Complete
**Phase:** 9
**Acceptance Criteria:**
- [x] `/pf-deep` replaces `/LD-deep`
- [x] `/pf-paper` replaces `/LD-paper`
- [x] `/pf-ocr` replaces `/lp-ocr`
- [x] `/pf-sync` replaces `/lp-selection-sync` + `/lp-index-refresh`
- [x] `/pf-status` replaces `/lp-status`
- [x] Old commands completely removed (no aliases)
- [x] All command docs updated

### SYS-02: CLI Simplification

**Status:** ✅ Complete
**Phase:** 9
**Acceptance Criteria:**
- [x] `paperforge sync` combines `selection-sync` + `index-refresh`
- [x] `--dry-run` previews changes
- [x] `--selection` and `--index` flags for partial runs
- [x] `paperforge ocr` simplified (merged run + diagnose)
- [x] CLI help text is user-centric

### SYS-03: Agent↔CLI 1:1 Mapping

**Status:** ✅ Complete
**Phase:** 10
**Acceptance Criteria:**
- [x] docs/COMMANDS.md master reference created
- [x] Each agent command has CLI equivalent documented
- [x] Platform notes for OpenCode, Codex, Claude Code

### SYS-04: Architecture Documentation

**Status:** ✅ Complete
**Phase:** 10
**Acceptance Criteria:**
- [x] ARCHITECTURE.md with system overview
- [x] 10 ADR records
- [x] Data flow diagram
- [x] Directory structure rationale
- [x] Extension guide for contributors

### SYS-05: Migration Guide

**Status:** ✅ Complete
**Phase:** 10
**Acceptance Criteria:**
- [x] MIGRATION-v1.2.md created
- [x] Breaking changes documented
- [x] Step-by-step migration instructions
- [x] Rollback instructions
- [x] FAQ for common issues

### SYS-06: Consistency Audit

**Status:** ✅ Complete
**Phase:** 10
**Acceptance Criteria:**
- [x] Automated audit script (4 checks)
- [x] All checks passing
- [x] Manual checklist for soft constraints

### SYS-07: Test Coverage for Unified Commands

**Status:** ✅ Complete
**Phase:** 9
**Acceptance Criteria:**
- [x] Tests validate new commands
- [x] Docs reference new names
- [x] 178 tests passing, 0 failures

---

## Changes During Milestone

**No requirements were changed, dropped, or added during v1.2.**
All 7 requirements were defined in planning and completed as specified.

---

## Notes

- SYS-01 initially included `/pf-doctor` requirement which was dropped in favor of integrating diagnostics into `paperforge ocr --diagnose`
- Backward compatibility: Old commands (`/LD-*`, `/lp-*`) were completely removed with no aliases or deprecation warnings (aggressive migration strategy)
- Test suite improved from 155/2/2 to 178/2/0 during Phase 10 verification (fixed pre-existing issues)
