docs: complete v2.3.0 milestone — archive planning artifacts

.planning/MILESTONES.md

@@ -1,5 +1,57 @@
 # Project Milestones: RuleZ (AI Policy Engine)
 
+## v2.3.0 Multi-Runtime Skill Portability (Shipped: 2026-03-18)
+
+**Delivered:** New `rulez skills` subcommand family — discover, transform, and install Claude Code skills to any AI runtime. Author once in `.claude/`, convert at install time, run everywhere.
+
+**Phases completed:** 34-38 (5 phases, ~2,099 new Rust LOC)
+**Timeline:** 2026-03-16 → 2026-03-17 (2 days)
+**PR:** #116 — 9/9 CI checks passed (Release + Full Validation)
+
+**Key accomplishments:**
+
+- `Runtime` enum covering Claude, OpenCode, Gemini, Codex, Custom — each profile resolves its own skills dir, command separator, tool name style, and path prefix
+- Skill discovery scans `.claude/skills/` and `.claude/commands/` plus extra sources (mastering-hooks at repo root)
+- 6-transform pipeline: tool name rewrite, path references, command filename flattening, YAML frontmatter conversion, MCP tool exclusion (Gemini), colors
+- `rulez skills install --runtime <rt>` / `--dry-run` / `rulez skills clean` — clean-install writer
+- Config file generation: marker-based GEMINI.md updates, AGENTS.md generation for Codex
+- `rulez skills status`, `rulez skills diff --runtime <rt>`, `rulez skills sync` — full DX subcommand family
+
+**Known Gaps (accepted as tech debt):**
+- CONFIG-04: mastering-hooks uses generic transform pipeline — no context-aware Gemini rewriting (todo)
+- DX-04: colorized terminal output not implemented — plain println!, no color crate (todo)
+
+**Stats:**
+- 5 phases (34-38), ~2,099 Rust LOC — 13 source files added across `rulez/src/skills/` and `rulez/src/cli/`
+
+---
+
+## v2.2.2 Documentation Audit & Multi-CLI Guides (Shipped: 2026-03-17)
+
+**Delivered:** Complete documentation overhaul — all reference docs audited against source code, per-CLI usage guides created, and new feature documentation for external logging, lint, and test.
+
+**Phases completed:** 30-33 (8 plans total)
+
+**Key accomplishments:**
+
+- Accurate CLI reference for all 14 rulez commands with flags verified against --help output
+- Complete hooks-yaml-schema.md with parallel eval, config caching, globset, and external logging fields
+- Quick-reference.md updated with all 22 CLI commands, action types, and exit codes
+- End-to-end usage guides for Claude Code, Gemini CLI, and OpenCode
+- Tutorial-first feature documentation for external logging (OTLP, Datadog, Splunk), lint (9 rules), and test
+- 13 docs audited with `last_validated` frontmatter for audit trail
+
+**Stats:**
+
+- 4 phases, 8 plans
+- 42 files changed, 5,856 insertions, 521 deletions
+- 36 commits over 3 days (2026-03-14 → 2026-03-16)
+- Requirements: 11/11 satisfied
+
+**Git range:** `1c86551` → `2339853`
+
+---
+
 ## v2.2.1 Cleanup, Sync Skills, CLI Help & UI Integration (Shipped: 2026-03-13)
 
 **Phases completed:** 29 phases, 79 plans, 8 tasks

.planning/PROJECT.md

@@ -8,9 +8,9 @@
 
 | Component | Location | Priority | Status |
 |-----------|----------|----------|--------|
-| **RuleZ Core** | `rulez/` | P1 - Primary | v1.4 Shipped |
+| **RuleZ Core** | `rulez/` | P1 - Primary | v2.3.0 Shipped |
 | **Mastering Hooks** | `mastering-hooks/` | P2 - Secondary | Complete (skill) |
-| **RuleZ UI** | `rulez-ui/` | P1 - Primary (v1.5) | M1 Scaffold Complete, v1.5 Active |
+| **RuleZ UI** | `rulez-ui/` | P1 - Primary | Complete (Tauri 2.0) |
 
 ## Core Value
 
@@ -32,9 +32,10 @@ RuleZ positions itself as comparable to:
 
 ## Current State
 
-### RuleZ Core (v2.2.1)
+### RuleZ Core (v2.3.0)
 - Policy engine with blocking, injection, validation, inline scripting, schema validation
-- CLI: init, install, uninstall, validate, logs, explain, debug, repl, test, lint, upgrade
+- CLI: init, install, uninstall, validate, logs, explain, debug, repl, test, lint, upgrade, skills
+- `rulez skills` family: install, clean, status, diff, sync — cross-runtime skill portability
 - Multi-CLI support: Claude Code, Gemini, Copilot, OpenCode (install/doctor commands)
 - Parallel rule evaluation, config caching, globset matching
 - E2E test harness across 5 CLIs (Claude Code, Gemini, Copilot, OpenCode, Codex)
@@ -84,11 +85,25 @@ RuleZ positions itself as comparable to:
 - ✓ REQ-PERF-01..02: Performance quality gates (<0.1ms schema validation) — v1.4
 - ✓ REQ-COMPAT-01..02: Cross-platform compatibility (CI matrix) — v1.4
 
-### Active
+- ✓ CLIDOC-01..03: CLI reference docs updated with all commands and flags — v2.2.2
+- ✓ GUIDE-01..03: Per-CLI usage guides (Claude Code, Gemini, OpenCode) — v2.2.2
+- ✓ FEAT-01..03: Feature documentation (external logging, lint, test) — v2.2.2
+- ✓ AUDIT-01..02: Accuracy audit against source code and --help output — v2.2.2
 
-(No active requirements — planning next milestone)
+- ✓ PROFILE-01..04: Runtime profiles (Claude, OpenCode, Gemini, Codex, Custom) with discovery — v2.3.0
+- ✓ XFORM-01..05: Transform pipeline (tool names, paths, filenames, frontmatter, MCP exclusion) — v2.3.0
+- ✓ CLI-01..04: `rulez skills install/clean` with dry-run and clean-install writer — v2.3.0
+- ✓ CONFIG-01..03: GEMINI.md marker-based update, AGENTS.md generation, non-skill preservation — v2.3.0
+- ✓ DX-01..03: `rulez skills status/diff/sync` subcommand family — v2.3.0
 
-See REQUIREMENTS.md for next milestone requirements when defined.
+### Active (next milestone)
+
+*(None defined — run `/gsd:new-milestone` to define next milestone requirements)*
+
+### Known Tech Debt
+
+- [ ] CONFIG-04: mastering-hooks context-aware transform for non-Claude runtimes — todo added
+- [ ] DX-04: Colorized terminal output with progress indicators for skills CLI — todo added
 
 ### Out of Scope
 
@@ -130,6 +145,11 @@ See REQUIREMENTS.md for next milestone requirements when defined.
 | LazyLock pre-compiled validators | <0.1ms validation overhead at runtime | ✓ Good |
 | ubuntu-22.04 for Tauri builds | webkit2gtk-4.1 requirement, ubuntu-latest may break | ✓ Good |
 | E2E gate before Tauri builds | Fast feedback (2-3min) prevents expensive failed builds | ✓ Good |
+| Hardcoded Rust transforms, not YAML-configurable | 4 well-known runtimes + Custom variant covers long tail | ✓ Good |
+| Clean-install writer (rm + recreate) | Prevents orphan files across versions, proven in GSD | ✓ Good |
+| `rulez skills` subcommand family, not extending `rulez install` | Hook registration and skill distribution are orthogonal | ✓ Good |
+| Skip colorized output (DX-04) in v2.3.0 | Ship fast, polish in next milestone | ⚠️ Revisit |
+| Generic transform for mastering-hooks (CONFIG-04) | Context-aware rewriting is complex; generic covers the 80% case | ⚠️ Revisit |
 
 ## Quality Gates
 
@@ -148,6 +168,6 @@ See REQUIREMENTS.md for next milestone requirements when defined.
 
 ---
 
-*Last updated: 2026-03-13 after v2.2.1 milestone*
+*Last updated: 2026-03-18 after v2.3.0 milestone*
 *Reorganized as monorepo on 2026-02-06*
 *Renamed from CCH to RuleZ*