@lifeaitools/rdc-skills 0.9.33 → 0.9.35

package/skills/handoff/SKILL.md

@@ -1,200 +1,200 @@
----
-name: rdc:handoff
-description: "Usage `rdc:handoff [--from-prototype <id>]` — Convert a finalized plan or prototype into CLI-ready artifacts: writes .rdc/plans/, creates Supabase work items with DoD checklists, registers prototype if present. Bridge between planning session and rdc:build."
----
-
-> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
-> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
-> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
-
-> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
-
-> **Sandbox contract:** This skill honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag. Supabase work item writes, prototype registry inserts, design context inserts, and git push are skipped under `RDC_TEST=1`.
-
-
-# rdc:handoff — Planning → CLI Bridge
-
-## When to Use
-
-- A prototype has been built and needs production implementation
-- A design decision has been made and needs to be executed
-- Project lead says "hand this off", "give this to the CLI", "write it up"
-- A plan exists in the conversation but hasn't been saved to disk or database yet
-
-## What This Skill Produces
-
-1. **Plan doc** → `.rdc/plans/<topic-slug>.md` (fallback: `.rdc/plans/<topic-slug>.md`)
-2. **Database epic + child tasks** (with agent types and guide file refs)
-3. **Prototype registry entry** (if a prototype was built)
-4. **Design context entries** (for decisions made in the session)
-
-## Procedure
-
-### Step 1 — Extract the Plan
-
-Identify from the conversation:
-- What is the goal?
-- What prototypes or designs were built? Where are they?
-- What decisions were made? What was rejected and why?
-- What is the sequencing (what depends on what)?
-- Which agent types are needed?
-
-### Step 2 — Write the Plan Doc
-
-```
-.rdc/plans/<topic-slug>.md
-```
-(fallback: `.rdc/plans/<topic-slug>.md` if `.rdc/` does not exist)
-
-Template:
-```markdown
-# Plan: <Topic>
-> Route: <app route or package>
-> Status: Ready for CLI build
-> Created: <date>
-> Source: planning session
-
----
-
-## What Already Exists (Do NOT Re-implement)
-
-[List any existing components, database tables, or files
- that agents must use rather than recreate]
-
-## What Was Built in Planning (Prototype)
-
-[Describe the prototype — file location, key design decisions,
- what to preserve vs what to adapt]
-
-## Work Packages
-
-### Package 1 — <Name>
-- Agent type: frontend | backend | data | design | infra | content | cs2 | viz
-- Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
-- Files to create/modify: [list]
-- Deliverables: [specific outputs]
-- Depends on: [other packages if sequential]
-
-### Package 2 — <Name>
-[...]
-
-## Sequencing
-
-Wave 1 (parallel): Package 1, Package 2
-Wave 2 (after Wave 1): Package 3
-
-## Checklist Decomposition Matrix
-
-| Work item | Atomic deliverable | Surface type | Route or file path | Preconditions / fixture data | Action | Expected result | Verification artifact | Owner package | Status |
-|-----------|-------------------|--------------|--------------------|------------------------------|--------|-----------------|-----------------------|---------------|--------|
-| WP-1 | decomp-<surface>-<slug> | screen | /route | seeded fixture | open / click / submit | observable result | Playwright screenshot / route probe / test name | Package 1 | todo |
-
-Rules:
-- One observable behavior per row.
-- Each row must be independently pass/fail.
-- Each implementation work item must have matching `decomp-*` checklist rows and `test-*` verification rows.
-- UI routes list state rows separately: empty, loading, loaded, error, create/edit/detail/mobile where applicable.
-- API and DB rows include success, failure/guard, and side-effect proof where applicable.
-
-## Checklist Quality Gate
-
-verdict: PASS | FAIL
-failures:
-- <missing/coarse row if any>
-deferred:
-- <explicitly out-of-scope row if any>
-
-## Definition of Done
-
-- [ ] [specific acceptance criterion]
-- [ ] [build verification: zero new TS errors]
-- [ ] [functional test]
-```
-
-### Step 3 — Create Database Epic + Tasks
-
-```sql
--- Check for existing epics first
-SELECT get_open_epics();
-
--- Create epic
-SELECT insert_work_item(
-  p_title       := 'EPIC: <Topic>',
-  p_description := 'See .rdc/plans/<topic-slug>.md for full spec.',
-  p_item_type   := 'epic',
-  p_priority    := 'high',
-  p_labels      := ARRAY['<system-label>'],
-  p_source      := 'planning'
-);
-
--- Create tasks (one per work package)
-SELECT insert_work_item(
-  p_title       := '<Package Name>',
-  p_description := 'What: <deliverable>
-Where: <files>
-Agent type: <type>
-Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
-Design doc: .rdc/plans/<topic-slug>.md (fallback: .rdc/plans/<topic-slug>.md)
-Checklist: include required rows from the plan matrix:
-- decomp-<surface>-<slug>: route/file=<path> | action=<action> | expect=<result> | evidence=<artifact>
-- test-<type>-<slug>: <verification command or artifact>
-Depends on: <other task if applicable>
-Est: <hours>',
-  p_parent_id   := '<epic-uuid>'::uuid,
-  p_item_type   := 'task',
-  p_priority    := 'high',
-  p_labels      := ARRAY['<label>'],
-  p_estimated_hours := 2,
-  p_source      := 'planning'
-);
-```
-
-Do not create build-ready tasks unless the plan has `## Checklist Decomposition Matrix` and `## Checklist Quality Gate` with `verdict: PASS`. If the matrix fails, save the plan as `Status: Needs checklist repair` and return the failure list instead of creating dispatchable implementation tasks.
-
-### Step 4 — Register Prototype (if one was built)
-
-```sql
-INSERT INTO prototype_registry (name, component, source_path, notes, created_by)
-VALUES (
-  '<Component Name> v1',
-  '<ComponentName>',
-  'docs/source/<filename>.jsx',
-  '<Key design decisions, data shapes, what to preserve>',
-  'planning'
-)
-ON CONFLICT DO NOTHING;
-```
-
-### Step 5 — Record Design Decisions
-
-```sql
-INSERT INTO design_context (topic, context_type, summary, source, created_by)
-VALUES
-  ('<Topic>', 'decision', '<What was decided and why>', 'planning session', 'planning'),
-  ('<Topic>', 'rejected', '<What was considered but not chosen, and why>', 'planning session', 'planning');
-```
-
-## System Labels Reference
-
-| Label | When |
-|-------|------|
-| `project-a` | Your-app-specific label |
-| `marketing` | Marketing / outreach work |
-| `ui` | Component library work |
-| `data` | Schema, migrations |
-| `infrastructure` | CI/CD, deployment |
-| `cs2` | Core paradigm packages |
-| `website` | Public-facing sites |
-| `media` | Media/asset work |
-
-## Output
-
-When complete, tell the project lead:
-```
-Handoff complete:
-- Plan: .rdc/plans/<topic-slug>.md
-- Epic: <epic-id> ("<title>")
-- Tasks: <N> tasks created, wave structure: [Wave 1: X, Y | Wave 2: Z]
-- Prototype: registered at docs/source/<file> (if applicable)
-- CLI agents will pick this up on next run.
-```
+---
+name: rdc:handoff
+description: "Usage `rdc:handoff [--from-prototype <id>]` — Convert a finalized plan or prototype into CLI-ready artifacts: writes .rdc/plans/, creates Supabase work items with DoD checklists, registers prototype if present. Bridge between planning session and rdc:build."
+---
+
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
+
+> **Sandbox contract:** This skill honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag. Supabase work item writes, prototype registry inserts, design context inserts, and git push are skipped under `RDC_TEST=1`.
+
+
+# rdc:handoff — Planning → CLI Bridge
+
+## When to Use
+
+- A prototype has been built and needs production implementation
+- A design decision has been made and needs to be executed
+- Project lead says "hand this off", "give this to the CLI", "write it up"
+- A plan exists in the conversation but hasn't been saved to disk or database yet
+
+## What This Skill Produces
+
+1. **Plan doc** → `.rdc/plans/<topic-slug>.md` (fallback: `.rdc/plans/<topic-slug>.md`)
+2. **Database epic + child tasks** (with agent types and guide file refs)
+3. **Prototype registry entry** (if a prototype was built)
+4. **Design context entries** (for decisions made in the session)
+
+## Procedure
+
+### Step 1 — Extract the Plan
+
+Identify from the conversation:
+- What is the goal?
+- What prototypes or designs were built? Where are they?
+- What decisions were made? What was rejected and why?
+- What is the sequencing (what depends on what)?
+- Which agent types are needed?
+
+### Step 2 — Write the Plan Doc
+
+```
+.rdc/plans/<topic-slug>.md
+```
+(fallback: `.rdc/plans/<topic-slug>.md` if `.rdc/` does not exist)
+
+Template:
+```markdown
+# Plan: <Topic>
+> Route: <app route or package>
+> Status: Ready for CLI build
+> Created: <date>
+> Source: planning session
+
+---
+
+## What Already Exists (Do NOT Re-implement)
+
+[List any existing components, database tables, or files
+ that agents must use rather than recreate]
+
+## What Was Built in Planning (Prototype)
+
+[Describe the prototype — file location, key design decisions,
+ what to preserve vs what to adapt]
+
+## Work Packages
+
+### Package 1 — <Name>
+- Agent type: frontend | backend | data | design | infra | content | cs2 | viz
+- Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
+- Files to create/modify: [list]
+- Deliverables: [specific outputs]
+- Depends on: [other packages if sequential]
+
+### Package 2 — <Name>
+[...]
+
+## Sequencing
+
+Wave 1 (parallel): Package 1, Package 2
+Wave 2 (after Wave 1): Package 3
+
+## Checklist Decomposition Matrix
+
+| Work item | Atomic deliverable | Surface type | Route or file path | Preconditions / fixture data | Action | Expected result | Verification artifact | Owner package | Status |
+|-----------|-------------------|--------------|--------------------|------------------------------|--------|-----------------|-----------------------|---------------|--------|
+| WP-1 | decomp-<surface>-<slug> | screen | /route | seeded fixture | open / click / submit | observable result | Playwright screenshot / route probe / test name | Package 1 | todo |
+
+Rules:
+- One observable behavior per row.
+- Each row must be independently pass/fail.
+- Each implementation work item must have matching `decomp-*` checklist rows and `test-*` verification rows.
+- UI routes list state rows separately: empty, loading, loaded, error, create/edit/detail/mobile where applicable.
+- API and DB rows include success, failure/guard, and side-effect proof where applicable.
+
+## Checklist Quality Gate
+
+verdict: PASS | FAIL
+failures:
+- <missing/coarse row if any>
+deferred:
+- <explicitly out-of-scope row if any>
+
+## Definition of Done
+
+- [ ] [specific acceptance criterion]
+- [ ] [build verification: zero new TS errors]
+- [ ] [functional test]
+```
+
+### Step 3 — Create Database Epic + Tasks
+
+```sql
+-- Check for existing epics first
+SELECT get_open_epics();
+
+-- Create epic
+SELECT insert_work_item(
+  p_title       := 'EPIC: <Topic>',
+  p_description := 'See .rdc/plans/<topic-slug>.md for full spec.',
+  p_item_type   := 'epic',
+  p_priority    := 'high',
+  p_labels      := ARRAY['<system-label>'],
+  p_source      := 'planning'
+);
+
+-- Create tasks (one per work package)
+SELECT insert_work_item(
+  p_title       := '<Package Name>',
+  p_description := 'What: <deliverable>
+Where: <files>
+Agent type: <type>
+Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
+Design doc: .rdc/plans/<topic-slug>.md (fallback: .rdc/plans/<topic-slug>.md)
+Checklist: include required rows from the plan matrix:
+- decomp-<surface>-<slug>: route/file=<path> | action=<action> | expect=<result> | evidence=<artifact>
+- test-<type>-<slug>: <verification command or artifact>
+Depends on: <other task if applicable>
+Est: <hours>',
+  p_parent_id   := '<epic-uuid>'::uuid,
+  p_item_type   := 'task',
+  p_priority    := 'high',
+  p_labels      := ARRAY['<label>'],
+  p_estimated_hours := 2,
+  p_source      := 'planning'
+);
+```
+
+Do not create build-ready tasks unless the plan has `## Checklist Decomposition Matrix` and `## Checklist Quality Gate` with `verdict: PASS`. If the matrix fails, save the plan as `Status: Needs checklist repair` and return the failure list instead of creating dispatchable implementation tasks.
+
+### Step 4 — Register Prototype (if one was built)
+
+```sql
+INSERT INTO prototype_registry (name, component, source_path, notes, created_by)
+VALUES (
+  '<Component Name> v1',
+  '<ComponentName>',
+  'docs/source/<filename>.jsx',
+  '<Key design decisions, data shapes, what to preserve>',
+  'planning'
+)
+ON CONFLICT DO NOTHING;
+```
+
+### Step 5 — Record Design Decisions
+
+```sql
+INSERT INTO design_context (topic, context_type, summary, source, created_by)
+VALUES
+  ('<Topic>', 'decision', '<What was decided and why>', 'planning session', 'planning'),
+  ('<Topic>', 'rejected', '<What was considered but not chosen, and why>', 'planning session', 'planning');
+```
+
+## System Labels Reference
+
+| Label | When |
+|-------|------|
+| `project-a` | Your-app-specific label |
+| `marketing` | Marketing / outreach work |
+| `ui` | Component library work |
+| `data` | Schema, migrations |
+| `infrastructure` | CI/CD, deployment |
+| `cs2` | Core paradigm packages |
+| `website` | Public-facing sites |
+| `media` | Media/asset work |
+
+## Output
+
+When complete, tell the project lead:
+```
+Handoff complete:
+- Plan: .rdc/plans/<topic-slug>.md
+- Epic: <epic-id> ("<title>")
+- Tasks: <N> tasks created, wave structure: [Wave 1: X, Y | Wave 2: Z]
+- Prototype: registered at docs/source/<file> (if applicable)
+- CLI agents will pick this up on next run.
+```

package/skills/help/SKILL.md

@@ -1,104 +1,104 @@
----
-name: rdc:help
-description: "Usage `rdc:help` — Show all rdc:* skills with full argument syntax. Call when unsure which skill to use or what args it takes."
----
-
-> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
-> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
-> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
-
-# rdc:help — Command Reference
-
-> **⚠️ HARD OUTPUT RULE:** Your ENTIRE response MUST be the block below, copied verbatim.
-> No preamble. No follow-up question. No summary. No "what would you like to do?".
-> Do NOT add any text before or after the block. Emit it exactly as written. This is non-negotiable.
-
-## When to Use
-
-- The project lead asks what RDC commands exist
-- The active task is unclear and needs command selection
-- A user needs syntax for planning, build, review, deployment, design, or release workflows
-
-## Arguments
-
-- `rdc:help` — print the full command reference menu
-- `rdc` — alias; same as `rdc:help`
-
-## Workflow — the RDC loop
-
-| Command | Usage |
-|---|---|
-| `rdc:preplan` | `rdc:preplan <topic> [--unattended]` — research, no code |
-| `rdc:plan` | `rdc:plan <topic> [--unattended]` — architecture + epic/tasks |
-| `rdc:build` | `rdc:build <epic-id\|topic> [--unattended]` — dispatch agents, commit, close items |
-| `rdc:review` | `rdc:review [--unattended]` — typecheck, tests, fix, commit |
-| `rdc:report` | `rdc:report [--unattended]` — write `.rdc/reports/YYYY-MM-DD.md` |
-| `rdc:overnight` | `rdc:overnight [epic-id\|label=X]` — chain preplan→plan→build→review→report |
-| `rdc:status` | `rdc:status` — read-only dashboard |
-| `rdc:fixit` | `rdc:fixit <description>` — bypass the loop, <5 files / <30 min |
-
-## Ops
-
-| Command | Usage |
-|---|---|
-| `rdc:deploy` | `rdc:deploy <slug> [build-id]` · `rdc:deploy new <slug>` · `rdc:deploy diagnose <slug>` · `rdc:deploy audit [--fix]` |
-| `rdc:release` | `rdc:release <repo> [version]` · `rdc:release <repo> --patch\|--minor\|--major` · `rdc:release <repo> --dry-run` |
-
-## Planning ↔ CLI bridge
-
-| Command | Usage |
-|---|---|
-| `rdc:handoff` | `rdc:handoff <topic>` — finalize plan → work items for CLI |
-| `rdc:prototype` | `rdc:prototype <description>` — JSX mock for review |
-| `rdc:workitems` | `rdc:workitems <add\|update\|done\|list\|epics> [args]` |
-| `rdc:collab` | `rdc:collab --session <id>` — claude.ai bidirectional relay |
-| `rdc:co-develop` | `rdc:co-develop <start\|resume\|send\|poll\|status\|stop>` — Claude/Codex peer-aware co-development |
-| `rdc:design` | `rdc:design <command\|brief>` — RDC/Studio design, tokens, palettes, themes, Rampa CLI |
-
-## Agent guides (dispatched by rdc:build, not user-invocable)
-
-These live under `guides/agents/` — they are role playbooks the build skill spawns as sub-agents. You do NOT invoke them directly.
-
-- `guides/agents/frontend.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/backend.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/data.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/design.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/infrastructure.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/content.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/cs2.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/viz.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/setup.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-- `guides/agents/verify.md` — [agent-only — dispatched by rdc:build, not user-invocable]
-
-Each agent reads `.rdc/guides/agent-bootstrap.md` first, then its role guide.
-
-## Decision tree
-
-```
-Project lead says → invoke
-─────────────────────────────────────────────────
-"research this" / "how do others do"    → rdc:preplan <topic>
-"plan this out" / "architect"           → rdc:plan <topic>
-"build it" / "go" / "execute"           → rdc:build <topic>
-"run overnight" / "while I sleep"       → rdc:overnight
-"quick fix" / "hotfix" / "typo"         → rdc:fixit <desc>
-"review" / "is it clean"                → rdc:review
-"report" / "summarize"                  → rdc:report
-"status" / "where are we"               → rdc:status
-"deploy" / "ship"                       → rdc:deploy <slug>
-"release" / "publish"                   → rdc:release <repo>
-"hand this off" / "give to agents"      → rdc:handoff
-"show me what it looks like"            → rdc:prototype
-"add to backlog" / "create a ticket"    → rdc:workitems
-"work together" / "partner review"       → rdc:co-develop start <name>
-"design/tokens/palette/theme"           → rdc:design <command>
-"what commands" / "what skills"         → rdc:help
-```
-
-## Hard rules (apply everywhere)
-
-- NEVER `pnpm build` — crashes the machine. Typecheck with `npx tsc --noEmit`.
-- NEVER commit to `main` without explicit approval. Default branch is `develop`.
-- NEVER overlap agents on the same files.
-- ALWAYS update work items in real time via RPCs (see `.claude/rules/work-items-rpc.md`).
-- ALWAYS credentials via clauth daemon: `curl -s http://127.0.0.1:52437/v/<service>` (returns plain text).
+---
+name: rdc:help
+description: "Usage `rdc:help` — Show all rdc:* skills with full argument syntax. Call when unsure which skill to use or what args it takes."
+---
+
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+# rdc:help — Command Reference
+
+> **⚠️ HARD OUTPUT RULE:** Your ENTIRE response MUST be the block below, copied verbatim.
+> No preamble. No follow-up question. No summary. No "what would you like to do?".
+> Do NOT add any text before or after the block. Emit it exactly as written. This is non-negotiable.
+
+## When to Use
+
+- The project lead asks what RDC commands exist
+- The active task is unclear and needs command selection
+- A user needs syntax for planning, build, review, deployment, design, or release workflows
+
+## Arguments
+
+- `rdc:help` — print the full command reference menu
+- `rdc` — alias; same as `rdc:help`
+
+## Workflow — the RDC loop
+
+| Command | Usage |
+|---|---|
+| `rdc:preplan` | `rdc:preplan <topic> [--unattended]` — research, no code |
+| `rdc:plan` | `rdc:plan <topic> [--unattended]` — architecture + epic/tasks |
+| `rdc:build` | `rdc:build <epic-id\|topic> [--unattended]` — dispatch agents, commit, close items |
+| `rdc:review` | `rdc:review [--unattended]` — typecheck, tests, fix, commit |
+| `rdc:report` | `rdc:report [--unattended]` — write `.rdc/reports/YYYY-MM-DD.md` |
+| `rdc:overnight` | `rdc:overnight [epic-id\|label=X]` — chain preplan→plan→build→review→report |
+| `rdc:status` | `rdc:status` — read-only dashboard |
+| `rdc:fixit` | `rdc:fixit <description>` — bypass the loop, <5 files / <30 min |
+
+## Ops
+
+| Command | Usage |
+|---|---|
+| `rdc:deploy` | `rdc:deploy <slug> [build-id]` · `rdc:deploy new <slug>` · `rdc:deploy diagnose <slug>` · `rdc:deploy audit [--fix]` |
+| `rdc:release` | `rdc:release <repo> [version]` · `rdc:release <repo> --patch\|--minor\|--major` · `rdc:release <repo> --dry-run` |
+
+## Planning ↔ CLI bridge
+
+| Command | Usage |
+|---|---|
+| `rdc:handoff` | `rdc:handoff <topic>` — finalize plan → work items for CLI |
+| `rdc:prototype` | `rdc:prototype <description>` — JSX mock for review |
+| `rdc:workitems` | `rdc:workitems <add\|update\|done\|list\|epics> [args]` |
+| `rdc:collab` | `rdc:collab --session <id>` — claude.ai bidirectional relay |
+| `rdc:co-develop` | `rdc:co-develop <start\|resume\|send\|poll\|status\|stop>` — Claude/Codex peer-aware co-development |
+| `rdc:design` | `rdc:design <command\|brief>` — RDC/Studio design, tokens, palettes, themes, Rampa CLI |
+
+## Agent guides (dispatched by rdc:build, not user-invocable)
+
+These live under `guides/agents/` — they are role playbooks the build skill spawns as sub-agents. You do NOT invoke them directly.
+
+- `guides/agents/frontend.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/backend.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/data.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/design.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/infrastructure.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/content.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/cs2.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/viz.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/setup.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+- `guides/agents/verify.md` — [agent-only — dispatched by rdc:build, not user-invocable]
+
+Each agent reads `.rdc/guides/agent-bootstrap.md` first, then its role guide.
+
+## Decision tree
+
+```
+Project lead says → invoke
+─────────────────────────────────────────────────
+"research this" / "how do others do"    → rdc:preplan <topic>
+"plan this out" / "architect"           → rdc:plan <topic>
+"build it" / "go" / "execute"           → rdc:build <topic>
+"run overnight" / "while I sleep"       → rdc:overnight
+"quick fix" / "hotfix" / "typo"         → rdc:fixit <desc>
+"review" / "is it clean"                → rdc:review
+"report" / "summarize"                  → rdc:report
+"status" / "where are we"               → rdc:status
+"deploy" / "ship"                       → rdc:deploy <slug>
+"release" / "publish"                   → rdc:release <repo>
+"hand this off" / "give to agents"      → rdc:handoff
+"show me what it looks like"            → rdc:prototype
+"add to backlog" / "create a ticket"    → rdc:workitems
+"work together" / "partner review"       → rdc:co-develop start <name>
+"design/tokens/palette/theme"           → rdc:design <command>
+"what commands" / "what skills"         → rdc:help
+```
+
+## Hard rules (apply everywhere)
+
+- NEVER `pnpm build` — crashes the machine. Typecheck with `npx tsc --noEmit`.
+- NEVER commit to `main` without explicit approval. Default branch is `develop`.
+- NEVER overlap agents on the same files.
+- ALWAYS update work items in real time via RPCs (see `.claude/rules/work-items-rpc.md`).
+- ALWAYS credentials via clauth daemon: `curl -s http://127.0.0.1:52437/v/<service>` (returns plain text).