osx-workflow

# OpenSpec-extended Autonomous Workflow Operational reference for the 7-phase loop driven by `openspec-extended orchestrate`. Covers the 4 tool layers, the phases, state files, the `osx` state I/O tool, and blocker/resume semantics. --- ## TL;DR ``` PHASE0 ARTIFACT_REVIEW → osx-analyzer → osx-review-artifacts, osx-modify-artifacts PHASE1 IMPLEMENTATION → osx-builder → osc-apply-change, osx-review-test-compliance PHASE2 REVIEW → osx-analyzer → osc-verify-change PHASE3 MAINTAIN_DOCS → osx-maintainer→ osx-maintain-ai-docs PHASE4 SYNC → osx-maintainer→ osc-sync-specs PHASE5 SELF_REFLECTION → osx-analyzer → (autonomous reasoning) PHASE6 ARCHIVE → osx-maintainer→ osc-archive-change / osc-bulk-archive-change ``` **Tool**: every state mutation goes through the `osx` subcommand: `openspec-extended osx <domain> <action>` (one surface; the CLI wrapper lives in `source/osx_cli.py`, the library in `source/lib/osx.py`). For the 4 tool layers (`openspec` / `openspec-extended` / `osx` CLI / `osx` lib), see §1 below. --- ## §1 Tool layers and CLIs ### §1.1 The 4 layer table | # | Tool | Invocation | Used for | |---|------|------------|----------| | 1 | `openspec` (npm) | `openspec <sub>` | Query state, get instructions, validate, list, show | | 2 | `openspec-extended` | `openspec-extended <sub>` | Install/update/orchestrate lifecycle | | 3 | `osx` (CLI subcommand) | `openspec-extended osx …` | State I/O from agents (what phase commands use) | | 4 ...