@lifeaitools/rdc-skills 0.35.10 → 0.35.12

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.35.10",
+  "version": "0.35.12",
   "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
   "author": {
     "name": "LIFEAI",
@@ -2054,6 +2054,48 @@
       "enabled_default": true,
       "codeflow_required": false,
       "purpose": "turns a pattern-advisor recommendation (or a solid-validator/architecture-reviewer finding) into a concrete..."
+    },
+    "open": {
+      "name": "open",
+      "slash": "rdc:open",
+      "category": "dev-loop",
+      "usage": "rdc:open [<slug>]",
+      "args": {
+        "positional": [
+          {
+            "name": "slug",
+            "required": false,
+            "description": "registry slug to resolve; omit for position only",
+            "accepts": "string"
+          }
+        ],
+        "flags": []
+      },
+      "requires": [
+        "supabase",
+        "git"
+      ],
+      "produces": [],
+      "default_model": "haiku",
+      "triggers": [
+        "where am i",
+        "orient",
+        "what is this slug",
+        "open the target",
+        "before i start"
+      ],
+      "follows": [],
+      "leads_to": [
+        "flow",
+        "plan",
+        "build",
+        "deploy"
+      ],
+      "sandbox_aware": false,
+      "output_contract": "guides/output-contract.md",
+      "enabled_default": true,
+      "codeflow_required": false,
+      "purpose": "orient before working: position, target from the registry, and the harness shape"
     }
   },
   "commands_meta": {

package/.github/workflows/self-test.yml

@@ -1,29 +1,29 @@
-name: self-test
-
-on:
-  push:
-    branches: ['**']
-    tags: ['v*']
-  pull_request:
-
-jobs:
-  tier1:
-    name: Tier 1 static lint
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node 20
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
-      - name: Run rdc:self-test --strict (Tier 1)
-        # Tier 2 requires headless claude + clauth daemon — not available in standard CI.
-        # Tier 1 catches the backtick-drift + frontmatter class of bugs.
-        run: node scripts/self-test.mjs --strict
-
+name: self-test
+
+on:
+  push:
+    branches: ['**']
+    tags: ['v*']
+  pull_request:
+
+jobs:
+  tier1:
+    name: Tier 1 static lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Run rdc:self-test --strict (Tier 1)
+        # Tier 2 requires headless claude + clauth daemon — not available in standard CI.
+        # Tier 1 catches the backtick-drift + frontmatter class of bugs.
+        run: node scripts/self-test.mjs --strict
+
   tier2-gate:
     name: Tier 2 behavioral (tag releases only)
     runs-on: ubuntu-latest
@@ -32,14 +32,14 @@ jobs:
     env:
       ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node 20
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
       - name: Install claude CLI
         if: env.ANTHROPIC_API_KEY != ''
         run: npm install -g @anthropic-ai/claude-code

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## v0.35.11 — Design Review is explicit opt-in
+
+### Changed
+- `rdc:plan`, `rdc:build`, and `rdc:overnight` no longer impose a Design
+  Review admission requirement on ordinary work. A named Design Review is
+  created only when Dave explicitly requests it; normal implementation reaches
+  the post-build `rdc:review` gate.
+
+---
+
 ## v0.35.4 — marketplace sync false-positive: untracked file blocked it forever
 
 ### Fixed

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

@@ -334,6 +334,7 @@ skills/
   lifeai-brochure-author/SKILL.md (brochure JSX authoring)
   new-model/SKILL.md   (reference model registration gate)
   onramp/SKILL.md      (Place Fund phase-1 enrollment)
+  open/SKILL.md        (orient first: position, target, harness shape)
   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)

package/commands/open.md

@@ -0,0 +1,17 @@
+---
+name: open
+description: >-
+  Usage `rdc:open [<slug>]` — orient before working. Answers where you are (repo, worktree, branch, dirty state) and what the target is (runtime, port, host, deploy path) from the registry, then names the harness shape to use. Run this first in any session that will change something.
+---
+
+# open
+
+Use Skill tool with skill: "open", passing the slug through if given.
+
+> This file previously carried the full procedure. It now lives in
+> `skills/open/SKILL.md`, which is the canonical home every other verb uses —
+> 43 skills, one document each. Keeping a second copy here is how
+> `commands/review.md` and its skill drifted apart, with the command missing the
+> mandatory code-review gate the skill had.
+>
+> One home per fact. This file is the pointer.