Split the monolithic docs/specification.md (48,071 lines, ~3.2MB) into a
docs/specification/ directory with 10 logical sub-documents plus an index.
- docs/specification/index.md — Root entry point with navigation table
- docs/specification/overview.md — Overview, standards alignment, and glossary
- docs/specification/cli.md — Complete CLI command reference (~18,000 lines)
- docs/specification/core-concepts.md — Plan lifecycle, actors, tools, skills, resources, context
- docs/specification/behavior.md — Automation profiles, guardrails, plan correction
- docs/specification/tui.md — Text User Interface architecture and components
- docs/specification/configuration.md — Configuration keys and file schemas
- docs/specification/examples.md — End-to-end workflow examples
- docs/specification/architecture.md — System architecture, ACMS, storage, security
- docs/specification/milestones.md — Milestone delivery plan
- docs/specification/acms.md — ACMS v1 detailed specification
docs/specification.md replaced with a stub redirect pointing to docs/specification/index.md.
mkdocs.yml updated with hierarchical navigation for the new sub-documents.
CONTRIBUTING.md, docs/CONTRIBUTING.md, and all .opencode/ agent/skill references updated
to point to docs/specification/ instead of docs/specification.md.
ISSUES CLOSED: #4749
