@lifeaitools/rdc-skills 0.35.6 → 0.35.7

package/MANIFEST.md

@@ -1,224 +1,224 @@
-# RDC Skills Library — Manifest
-
-**Created:** 2026-04-13  
-**Last updated:** 2026-05-01  
-**Source:** Regen Root project `.claude/skills/user/`  
-**Files:** 31 skill files, 10 agent guides, command mirrors, and support scripts  
-**Size:** ~480K  
-
-## Generic Conversion Summary
-
-All skills have been converted from project-specific to generic/portable:
-
-### Path Replacements
-- `C:/Dev/regen-root/` → `{PROJECT_ROOT}/`
-- Hardcoded app names (rdc-marketing-engine, brand-studio, prt, etc.) → generic examples
-- Specific Supabase project IDs → generic table references
-- Developer-specific paths → variables
-
-### TDD Enhancements
-- Added mandatory post-wave test gate to rdc:build
-- Updated rdc:review with test coverage delta reporting
-- Added test-first requirement to all agent skills
-- TDD enforcement: red → implement → green cycle
-
-### Preserved Elements
-- All logic and procedures (100%)
-- All safety rules
-- All RPC patterns
-- Branch strategy (development → production)
-- Work item lifecycle
-- Escalation protocols
-- Unattended mode patterns
-- Status block format
-
-## Files Created
-
-```
-/c/Dev/rdc-skills/
-├── README.md
-├── MANIFEST.md (this file)
-└── skills/
-    ├── build/SKILL.md        [+TDD enforcement, +verify gate]
-    ├── plan/SKILL.md
-    ├── preplan/SKILL.md
-    ├── review/SKILL.md       [+test coverage delta, +verify gate]
-    ├── overnight/SKILL.md
-    ├── fixit/SKILL.md
-    ├── status/SKILL.md
-    ├── report/SKILL.md
-    ├── co-develop/SKILL.md   [peer-aware Claude/Codex co-development]
-    ├── collab/SKILL.md       [claude.ai ↔ Claude Code relay]
-    ├── handoff/SKILL.md
-    ├── prototype/SKILL.md
-    ├── workitems/SKILL.md
-    ├── design/SKILL.md       [RDC/Studio design, Palette Library, Rampa CLI]
-    ├── help/SKILL.md
-    ├── regen-media/SKILL.md [primary image generation + Regen Media upload]
-    ├── deploy/SKILL.md       [Coolify deployment ops]
-    ├── release/SKILL.md      [atomic version release]
-    ├── self-test/SKILL.md    [static lint + tier2 smoke tests]
-    └── watch/SKILL.md        [session log + browser viewer]
-└── guides/agents/     (agent-only playbooks — dispatched by rdc:build, not user-invocable)
-    ├── frontend.md
-    ├── backend.md
-    ├── cs2.md
-    ├── data.md
-    ├── design.md
-    ├── infrastructure.md
-    ├── content.md
-    ├── viz.md
-    ├── setup.md
-    └── verify.md
-```
-
-**Note (v0.7.9):** Skills migrated from flat `rdc-<name>.md` files to `<name>/SKILL.md` subdirectories. Plugin namespace is `rdc`, so composed skill names are `rdc:<name>` — matching the frontmatter. This eliminates the duplicate `rdc:rdc-*` registration that occurred when directories were named `rdc-<name>/`.
-
-## Skill Categories
-
-### Orchestration (8)
-- rdc:build — dispatch typed agents in waves
-- rdc:plan — architecture + epic/tasks
-- rdc:preplan — research before planning
-- rdc:review — quality gate
-- rdc:overnight — unattended build supervisor
-- rdc:fixit — quick-fix bypass
-- rdc:status — project dashboard
-- rdc:report — nightly report
-
-### DevOps (3)
-- rdc:deploy — Coolify deployment ops (deploy, new, diagnose, audit)
-- rdc:release — atomic version release with git tag + changelog
-- rdc:watch — session log + browser viewer for Claude activity
-
-### Quality (1)
-- rdc:self-test — static lint (tier1) + smoke tests (tier2)
-
-### Collaboration (1)
-- rdc:co-develop — peer-aware Claude/Codex co-development over clauth
-
-### Agent Guides (10, in `guides/agents/`) — [agent-only — dispatched by rdc:build, not user-invocable]
-- frontend — React, UI, Tailwind
-- backend — API, database, auth
-- data — migrations, schema
-- design — brand, tokens
-- infrastructure — deployment, CI/CD
-- content — copy, messaging
-- cs2 — paradigm-level work
-- viz — visualizations
-- setup — project scan + .rdc/config.json generation
-- verify — evidence-before-claims verification gate
-
-### Utility (1)
-- rdc:collab — bidirectional claude.ai ↔ Claude Code relay via file transport
-- rdc:channel-formatter — channel-native formatting and content repurposing,
-  including article-to-post, social-pack, campaign-pack, exec-pack, and
-  launch-pack outputs
-- rdc:regen-media — primary image generation and Regen Media upload workflow,
-  defaulting to local keyless Codex `gpt-image-2` via built-in `image_gen`
-
-### Bridge (3)
-- rdc:handoff — planning → work items
-- rdc:prototype — JSX prototypes
-- rdc:workitems — work item CRUD
-
-### Design (1)
-- rdc:design — Studio-aware design workflow with token, Palette Library, and Rampa CLI context
-
-### Reference (1)
-- rdc:help — skill index
-
-## Usage Instructions
-
-1. **Clone or reference** the `/c/Dev/rdc-skills/` directory
-2. **Update path variables** in all skills for your project
-3. **Create project guides** (agent-bootstrap.md, frontend.md, etc.)
-4. **Set up database** (work_items RPC, prototype_registry, design_context)
-5. **Invoke skills** via your agent framework
-   - Interactive: `/rdc:build <epic-id>`
-   - Unattended: `/rdc:overnight`
-   - Quality: `/rdc:review --unattended`
-   - Content repurposing: `/rdc:channel-formatter social-pack article.md`
-
-## Channel Formatter Content Packs
-
-`rdc:channel-formatter` can strictly format copy for one channel or repurpose a
-long source into a channel-native output set.
-
-Examples:
-
-```bash
-rdc:channel-formatter linkedin article.md
-rdc:channel-formatter twitter-thread article.md
-rdc:channel-formatter social-pack article.md
-rdc:channel-formatter campaign-pack report.md
-```
-
-Use `rdc:convert` for actual Office/Markdown file conversion, `rdc:brochure`
-for HTML/folder/URL PDF rendering, and `rdc:brochurify` for Brochurify
-orchestration. Channel formatter writes and repurposes text; it does not produce
-binary Word or PDF artifacts.
-
-## Key Differences from Source
-
-### Added: TDD Enforcement
-
-**rdc:build (Step 8):**
-```bash
-# Post-wave test gate (mandatory)
-cd packages/<name> && npx vitest run 2>&1 | tail -20
-```
-All tests must pass before next wave.
-
-**All agent skills:**
-```
-TDD REQUIREMENT: Write tests FIRST for new functions/modules.
-Run: npx vitest run packages/<name>
-```
-
-**rdc:review (Step 3):**
-```bash
-# Check test coverage delta
-git diff origin/main...HEAD -- packages/*/src/ | grep -c "^+"
-git diff origin/main...HEAD -- packages/*/test* | grep -c "^+"
-```
-Flags any package with implementation added but 0 new tests.
-
-**rdc:review report format:**
-```
-| Package | Tests | Pass/Fail | New Tests Added | Issues |
-```
-
-### Preserved: All Logic
-
-- Work item RPC patterns (never raw SQL)
-- Agent type classification
-- Wave-based parallelization
-- Escalation protocols
-- Unattended mode patterns
-- Status block formatting
-- Safety rules (100%)
-- Branch strategy
-
-## Deployment
-
-These skills are ready to use in any project that has:
-
-1. A monorepo with `packages/`, `apps/`, or `sites/` structure
-2. A database (Supabase, PostgreSQL, etc.) with work_items RPC functions
-3. Capability to run agents (Claude Code, subagents, or CLI)
-4. Git-based version control with at least 2 branches (dev + prod)
-5. A credential management system (clauth daemon or equivalent)
-
-## Questions?
-
-- **Specific project integration:** Refer to your project's infrastructure documentation
-- **Skill logic:** All skills are pure logic extracted from Regen Root; no project-specific magic
-- **TDD requirements:** Built into every skill; red → implement → green is mandatory
-- **Database schema:** You define; skills use generic `work_items` table and RPC patterns
-
----
-
-**Manifest created:** 2026-04-13  
-**Source project:** Regen Root (github.com/LIFEAI/regen-root)  
-**Genericization:** Complete — all hardcoded references removed, all logic preserved
+# RDC Skills Library — Manifest
+
+**Created:** 2026-04-13  
+**Last updated:** 2026-05-01  
+**Source:** Regen Root project `.claude/skills/user/`  
+**Files:** 31 skill files, 10 agent guides, command mirrors, and support scripts  
+**Size:** ~480K  
+
+## Generic Conversion Summary
+
+All skills have been converted from project-specific to generic/portable:
+
+### Path Replacements
+- `C:/Dev/regen-root/` → `{PROJECT_ROOT}/`
+- Hardcoded app names (rdc-marketing-engine, brand-studio, prt, etc.) → generic examples
+- Specific Supabase project IDs → generic table references
+- Developer-specific paths → variables
+
+### TDD Enhancements
+- Added mandatory post-wave test gate to rdc:build
+- Updated rdc:review with test coverage delta reporting
+- Added test-first requirement to all agent skills
+- TDD enforcement: red → implement → green cycle
+
+### Preserved Elements
+- All logic and procedures (100%)
+- All safety rules
+- All RPC patterns
+- Branch strategy (development → production)
+- Work item lifecycle
+- Escalation protocols
+- Unattended mode patterns
+- Status block format
+
+## Files Created
+
+```
+/c/Dev/rdc-skills/
+├── README.md
+├── MANIFEST.md (this file)
+└── skills/
+    ├── build/SKILL.md        [+TDD enforcement, +verify gate]
+    ├── plan/SKILL.md
+    ├── preplan/SKILL.md
+    ├── review/SKILL.md       [+test coverage delta, +verify gate]
+    ├── overnight/SKILL.md
+    ├── fixit/SKILL.md
+    ├── status/SKILL.md
+    ├── report/SKILL.md
+    ├── co-develop/SKILL.md   [peer-aware Claude/Codex co-development]
+    ├── collab/SKILL.md       [claude.ai ↔ Claude Code relay]
+    ├── handoff/SKILL.md
+    ├── prototype/SKILL.md
+    ├── workitems/SKILL.md
+    ├── design/SKILL.md       [RDC/Studio design, Palette Library, Rampa CLI]
+    ├── help/SKILL.md
+    ├── regen-media/SKILL.md [primary image generation + Regen Media upload]
+    ├── deploy/SKILL.md       [Coolify deployment ops]
+    ├── release/SKILL.md      [atomic version release]
+    ├── self-test/SKILL.md    [static lint + tier2 smoke tests]
+    └── watch/SKILL.md        [session log + browser viewer]
+└── guides/agents/     (agent-only playbooks — dispatched by rdc:build, not user-invocable)
+    ├── frontend.md
+    ├── backend.md
+    ├── cs2.md
+    ├── data.md
+    ├── design.md
+    ├── infrastructure.md
+    ├── content.md
+    ├── viz.md
+    ├── setup.md
+    └── verify.md
+```
+
+**Note (v0.7.9):** Skills migrated from flat `rdc-<name>.md` files to `<name>/SKILL.md` subdirectories. Plugin namespace is `rdc`, so composed skill names are `rdc:<name>` — matching the frontmatter. This eliminates the duplicate `rdc:rdc-*` registration that occurred when directories were named `rdc-<name>/`.
+
+## Skill Categories
+
+### Orchestration (8)
+- rdc:build — dispatch typed agents in waves
+- rdc:plan — architecture + epic/tasks
+- rdc:preplan — research before planning
+- rdc:review — quality gate
+- rdc:overnight — unattended build supervisor
+- rdc:fixit — quick-fix bypass
+- rdc:status — project dashboard
+- rdc:report — nightly report
+
+### DevOps (3)
+- rdc:deploy — Coolify deployment ops (deploy, new, diagnose, audit)
+- rdc:release — atomic version release with git tag + changelog
+- rdc:watch — session log + browser viewer for Claude activity
+
+### Quality (1)
+- rdc:self-test — static lint (tier1) + smoke tests (tier2)
+
+### Collaboration (1)
+- rdc:co-develop — peer-aware Claude/Codex co-development over clauth
+
+### Agent Guides (10, in `guides/agents/`) — [agent-only — dispatched by rdc:build, not user-invocable]
+- frontend — React, UI, Tailwind
+- backend — API, database, auth
+- data — migrations, schema
+- design — brand, tokens
+- infrastructure — deployment, CI/CD
+- content — copy, messaging
+- cs2 — paradigm-level work
+- viz — visualizations
+- setup — project scan + .rdc/config.json generation
+- verify — evidence-before-claims verification gate
+
+### Utility (1)
+- rdc:collab — bidirectional claude.ai ↔ Claude Code relay via file transport
+- rdc:channel-formatter — channel-native formatting and content repurposing,
+  including article-to-post, social-pack, campaign-pack, exec-pack, and
+  launch-pack outputs
+- rdc:regen-media — primary image generation and Regen Media upload workflow,
+  defaulting to local keyless Codex `gpt-image-2` via built-in `image_gen`
+
+### Bridge (3)
+- rdc:handoff — planning → work items
+- rdc:prototype — JSX prototypes
+- rdc:workitems — work item CRUD
+
+### Design (1)
+- rdc:design — Studio-aware design workflow with token, Palette Library, and Rampa CLI context
+
+### Reference (1)
+- rdc:help — skill index
+
+## Usage Instructions
+
+1. **Clone or reference** the `/c/Dev/rdc-skills/` directory
+2. **Update path variables** in all skills for your project
+3. **Create project guides** (agent-bootstrap.md, frontend.md, etc.)
+4. **Set up database** (work_items RPC, prototype_registry, design_context)
+5. **Invoke skills** via your agent framework
+   - Interactive: `/rdc:build <epic-id>`
+   - Unattended: `/rdc:overnight`
+   - Quality: `/rdc:review --unattended`
+   - Content repurposing: `/rdc:channel-formatter social-pack article.md`
+
+## Channel Formatter Content Packs
+
+`rdc:channel-formatter` can strictly format copy for one channel or repurpose a
+long source into a channel-native output set.
+
+Examples:
+
+```bash
+rdc:channel-formatter linkedin article.md
+rdc:channel-formatter twitter-thread article.md
+rdc:channel-formatter social-pack article.md
+rdc:channel-formatter campaign-pack report.md
+```
+
+Use `rdc:convert` for actual Office/Markdown file conversion, `rdc:brochure`
+for HTML/folder/URL PDF rendering, and `rdc:brochurify` for Brochurify
+orchestration. Channel formatter writes and repurposes text; it does not produce
+binary Word or PDF artifacts.
+
+## Key Differences from Source
+
+### Added: TDD Enforcement
+
+**rdc:build (Step 8):**
+```bash
+# Post-wave test gate (mandatory)
+cd packages/<name> && npx vitest run 2>&1 | tail -20
+```
+All tests must pass before next wave.
+
+**All agent skills:**
+```
+TDD REQUIREMENT: Write tests FIRST for new functions/modules.
+Run: npx vitest run packages/<name>
+```
+
+**rdc:review (Step 3):**
+```bash
+# Check test coverage delta
+git diff origin/main...HEAD -- packages/*/src/ | grep -c "^+"
+git diff origin/main...HEAD -- packages/*/test* | grep -c "^+"
+```
+Flags any package with implementation added but 0 new tests.
+
+**rdc:review report format:**
+```
+| Package | Tests | Pass/Fail | New Tests Added | Issues |
+```
+
+### Preserved: All Logic
+
+- Work item RPC patterns (never raw SQL)
+- Agent type classification
+- Wave-based parallelization
+- Escalation protocols
+- Unattended mode patterns
+- Status block formatting
+- Safety rules (100%)
+- Branch strategy
+
+## Deployment
+
+These skills are ready to use in any project that has:
+
+1. A monorepo with `packages/`, `apps/`, or `sites/` structure
+2. A database (Supabase, PostgreSQL, etc.) with work_items RPC functions
+3. Capability to run agents (Claude Code, subagents, or CLI)
+4. Git-based version control with at least 2 branches (dev + prod)
+5. A credential management system (clauth daemon or equivalent)
+
+## Questions?
+
+- **Specific project integration:** Refer to your project's infrastructure documentation
+- **Skill logic:** All skills are pure logic extracted from Regen Root; no project-specific magic
+- **TDD requirements:** Built into every skill; red → implement → green is mandatory
+- **Database schema:** You define; skills use generic `work_items` table and RPC patterns
+
+---
+
+**Manifest created:** 2026-04-13  
+**Source project:** Regen Root (github.com/LIFEAI/regen-root)  
+**Genericization:** Complete — all hardcoded references removed, all logic preserved

package/README.md

@@ -311,10 +311,13 @@ Boundaries:
 
 ```
 skills/
+  architecture-reviewer/SKILL.md (layering and dependency-direction review)
   behavior-audit/SKILL.md (governed behavior and policy audit)
   brochure/SKILL.md    (print-quality PDF rendering)
+  brochurify/SKILL.md  (Brochurify orchestration)
   build/SKILL.md       (dispatch agents in waves — mandatory validator gate)
   channel-formatter/SKILL.md (channel-native formatting and content packs)
+  clean-code-analyzer/SKILL.md (naming, dead code and complexity smells)
   co-develop/SKILL.md  (peer-aware Claude/Codex co-development)
   collab/SKILL.md      (bidirectional claude.ai ↔ Claude Code relay)
   convert/SKILL.md     (Office/Markdown conversion)
@@ -322,9 +325,9 @@ skills/
   design/SKILL.md      (RDC/Studio design, Palette Library, Rampa CLI)
   edit/SKILL.md        (local website editor launcher)
   env/SKILL.md         (environment status, install, repair, update)
+  extract-verifier-rules/SKILL.md (verifier rule extraction)
   fixit/SKILL.md       (quick-fix bypass)
   fs-mcp/SKILL.md      (File System MCP bridge guidance)
-  regen-media/SKILL.md (primary image generation + Regen Media upload)
   handoff/SKILL.md     (planning → work items)
   help/SKILL.md        (manifest-driven skill index)
   housekeeping/SKILL.md (weekly maintenance audit)
@@ -332,19 +335,23 @@ skills/
   new-model/SKILL.md   (reference model registration gate)
   onramp/SKILL.md      (Place Fund phase-1 enrollment)
   overnight/SKILL.md   (unattended multi-epic supervisor)
+  package-design/SKILL.md (module boundary and export-surface review)
+  pattern-advisor/SKILL.md (design pattern suggestions, advisory only)
+  pattern-refactoring-guide/SKILL.md (a finding turned into a step-ordered plan)
   plan/SKILL.md        (create architecture + tasks)
   preplan/SKILL.md     (research before planning)
   prototype/SKILL.md   (build JSX prototype)
-  brochurify/SKILL.md  (Brochurify orchestration)
-  extract-verifier-rules/SKILL.md (verifier rule extraction)
   refactor/SKILL.md   (governed corrective takeover and consolidation)
+  regen-media/SKILL.md (primary image generation + Regen Media upload)
   release/SKILL.md     (atomic package/app release)
   report/SKILL.md      (nightly report)
   review/SKILL.md      (quality gate: tests, types, docs)
   rpms-filemap/SKILL.md (canonical RPMS file map)
   self-test/SKILL.md   (skill suite health check)
+  solid-validator/SKILL.md (deterministic SOLID and Clean Architecture scoring)
   status/SKILL.md      (project dashboard)
   terminal-config/SKILL.md (Windows Terminal and hidden-launch policy)
+  testing-strategy/SKILL.md (test level and shape recommendations)
   watch/SKILL.md       (session log watcher)
   workitems/SKILL.md   (work item management)
 

package/clauth-plugin.json

@@ -1,7 +1,7 @@
 {
   "schema": "lifeai.plugin.v1",
   "id": "rdc-skills",
-  "version": "1.0.0",
+  "version": "0.35.7",
   "publisher": "LIFEAI",
   "core": false,
   "documentation": {

package/commands/analyze-tests.md

@@ -1,9 +1,6 @@
 ---
 name: analyze-tests
-description: >-
-  Usage `rdc:analyze-tests <path>` — recommends test level (unit/
-  integration/live) and shape (assertion/golden-capture) for a surface
-  (FUNCTION corner). See skills/testing-strategy.
+description: rdc:analyze-tests <path> — recommend the test level and shape for a surface
 ---
 
 # analyze-tests

package/commands/build.md

@@ -1,7 +1,6 @@
 ---
 name: build
-description: >-
-  Usage `rdc:build <epic-id|topic> [--unattended]` — dispatch typed agents from an epic, commit, push, update work items. The build engine. Use after rdc:plan or when the project lead says "build it".
+description: rdc:build (epic-id) - [--no-review] — execute a planned epic, then gate and ship to dev
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/check-clean-code.md

@@ -1,8 +1,6 @@
 ---
 name: check-clean-code
-description: >-
-  Usage `rdc:check-clean-code <path> [--diff <ref>]` — naming, dead code,
-  complexity smells. See skills/clean-code-analyzer.
+description: rdc:check-clean-code <path> [--diff <ref>] — flag naming, dead code and complexity smells
 ---
 
 # check-clean-code

package/commands/check-packages.md

@@ -1,8 +1,6 @@
 ---
 name: check-packages
-description: >-
-  Usage `rdc:check-packages <path>` — module boundary and export-surface
-  review. See skills/package-design.
+description: rdc:check-packages <path> — review module boundaries and the export surface
 ---
 
 # check-packages

package/commands/collab.md

@@ -1,7 +1,6 @@
 ---
 name: collab
-description: >-
-  Usage `rdc:collab --session <id>` — bidirectional relay with claude.ai. Read inbox, do work, write outbox, loop. Dave watches terminal and can interject.
+description: rdc:collab () - [--session] — run a structured agent-to-agent conversation
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/compare-compliance.md

@@ -1,9 +1,6 @@
 ---
 name: compare-compliance
-description: >-
-  Usage `rdc:compare-compliance <path> --diff <ref>` — the SOLID/Clean
-  Architecture regression gate: did this change make compliance worse than
-  `<ref>`? Wraps solid-validator's git-diff mode.
+description: rdc:compare-compliance <path> --diff <ref> — gate a change against a ref, did compliance get worse
 ---
 
 # compare-compliance

package/commands/deploy.md

@@ -1,7 +1,6 @@
 ---
 name: deploy
-description: >-
-  Coolify ops. Usage `rdc:deploy <slug> [build-id]`, `rdc:deploy new <slug>`, `rdc:deploy maintenance <service>`, `rdc:deploy diagnose <slug>`, or `rdc:deploy audit [--fix]` — typed checklists, private-service controls, DNS decision tree, and mandatory post-deploy gates. Checklist-only output.
+description: rdc:deploy (slug, [action]) - [--fix, --hotfix] — ship to PM2 dev; promote to Coolify production
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/design.md

@@ -1,7 +1,6 @@
 ---
 name: design
-description: >-
-  Usage `rdc:design <command|brief>` — RDC-owned design skill for Studio, Palette Library, token-aware UI work, and Rampa CLI-assisted color systems.
+description: rdc:design (topic) — design Studio, palette and token-aware UI work
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/edit.md

@@ -1,7 +1,6 @@
 ---
 name: edit
-description: >-
-  Usage `rdc:edit <site|brand|route|file>` — open a target in the local website editor host on port 3015. Resolves the site, launches or reuses the editor, and opens the target URL when available.
+description: rdc:edit (target) — open the local website editor for a target
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/fixit.md

@@ -1,7 +1,6 @@
 ---
 name: fixit
-description: >-
-  Usage `rdc:fixit <description>` — sanctioned bypass for quick fixes under 5 files / 30 min. Creates minimal work item, makes fix, commits, DELIVERS it to where it is consumed (publish/deploy/land) and verifies, then closes. The ONLY alternative to rdc:build. For typos, config patches, hotfixes, dep bumps.
+description: rdc:fixit (description) — make a scoped fix under 5 files and ship it to dev
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/flow.md

@@ -1,7 +1,6 @@
 ---
 name: flow
-description: >-
-  Usage `rdc:flow [status|<state> ["<reason>"]|normal]` — show or set the current flow state. Flow is the single FSM surface for both work-shape (plan/design/collab/build/refactor/overnight/harness-testing) and ceremony relaxation (hotfix/maintenance). Supersedes `rdc:mode` — hotfix/maintenance are flow values now, not a separate system.
+description: rdc:flow [status|<state> ["<reason>"]|normal] — show or set the flow state
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/full-analysis.md

@@ -1,12 +1,6 @@
 ---
 name: full-analysis
-description: >-
-  Usage `rdc:full-analysis <path> [--diff <ref>]` — runs all seven surfaces
-  (solid-validator, architecture-reviewer, clean-code-analyzer,
-  package-design, pattern-advisor, testing-strategy, and
-  pattern-refactoring-guide on anything the others flag) and merges into
-  one report. The full form/fit/function pass — use before merging a new
-  package or a significant refactor, not for routine edits.
+description: rdc:full-analysis <path> [--diff <ref>] — run all seven review surfaces over a path
 ---
 
 > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`

package/commands/get-refactoring-plan.md

@@ -1,10 +1,6 @@
 ---
 name: get-refactoring-plan
-description: >-
-  Usage `rdc:get-refactoring-plan <finding>` — turns a solid-validator/
-  architecture-reviewer/pattern-advisor finding into a step-ordered
-  before/after refactor plan. Produces a plan, does not apply it. See
-  skills/pattern-refactoring-guide.
+description: rdc:get-refactoring-plan <finding> — turn a finding into a step-ordered before/after plan
 ---
 
 # get-refactoring-plan