@lifeaitools/rdc-skills 0.8.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/.claude/settings.json +15 -0
  2. package/.claude-plugin/marketplace.json +21 -0
  3. package/.claude-plugin/plugin.json +11 -0
  4. package/.github/workflows/publish.yml +25 -0
  5. package/.github/workflows/self-test.yml +53 -0
  6. package/CHANGELOG.md +246 -0
  7. package/LICENSE +21 -0
  8. package/MANIFEST.md +190 -0
  9. package/README.md +188 -0
  10. package/README.sandbox.md +3 -0
  11. package/assets/watcher/viewer.html +164 -0
  12. package/commands/build.md +183 -0
  13. package/commands/collab.md +180 -0
  14. package/commands/deploy.md +138 -0
  15. package/commands/fixit.md +112 -0
  16. package/commands/handoff.md +173 -0
  17. package/commands/help.md +88 -0
  18. package/commands/overnight.md +220 -0
  19. package/commands/plan.md +158 -0
  20. package/commands/preplan.md +131 -0
  21. package/commands/prototype.md +145 -0
  22. package/commands/release.md +159 -0
  23. package/commands/report.md +99 -0
  24. package/commands/review.md +120 -0
  25. package/commands/self-test.md +107 -0
  26. package/commands/status.md +86 -0
  27. package/commands/watch.md +92 -0
  28. package/commands/workitems.md +132 -0
  29. package/guides/.gitkeep +0 -0
  30. package/guides/agent-bootstrap.md +191 -0
  31. package/guides/agents/backend.md +104 -0
  32. package/guides/agents/content.md +94 -0
  33. package/guides/agents/cs2.md +56 -0
  34. package/guides/agents/data.md +87 -0
  35. package/guides/agents/design.md +77 -0
  36. package/guides/agents/frontend.md +92 -0
  37. package/guides/agents/infrastructure.md +81 -0
  38. package/guides/agents/setup.md +279 -0
  39. package/guides/agents/verify.md +132 -0
  40. package/guides/agents/viz.md +106 -0
  41. package/guides/backend.md +146 -0
  42. package/guides/content.md +147 -0
  43. package/guides/cs2.md +190 -0
  44. package/guides/data.md +123 -0
  45. package/guides/design.md +116 -0
  46. package/guides/frontend.md +151 -0
  47. package/guides/infrastructure.md +179 -0
  48. package/guides/output-contract.md +98 -0
  49. package/hooks/no-stop-open-epics.js +125 -0
  50. package/package.json +31 -0
  51. package/rules/work-items-rpc.md +399 -0
  52. package/scripts/install-rdc-skills.js +559 -0
  53. package/scripts/install.ps1 +165 -0
  54. package/scripts/install.sh +132 -0
  55. package/scripts/lib/assertions.mjs +264 -0
  56. package/scripts/lib/manifest-schema.mjs +607 -0
  57. package/scripts/lib/runner.mjs +429 -0
  58. package/scripts/lib/sandbox.mjs +435 -0
  59. package/scripts/self-test.mjs +1108 -0
  60. package/scripts/uninstall.ps1 +77 -0
  61. package/scripts/uninstall.sh +69 -0
  62. package/scripts/update.ps1 +43 -0
  63. package/scripts/update.sh +43 -0
  64. package/scripts/watch-init.mjs +100 -0
  65. package/skills/.gitkeep +0 -0
  66. package/skills/build/SKILL.md +238 -0
  67. package/skills/collab/SKILL.md +218 -0
  68. package/skills/deploy/SKILL.md +144 -0
  69. package/skills/fixit/SKILL.md +112 -0
  70. package/skills/handoff/SKILL.md +175 -0
  71. package/skills/help/SKILL.md +101 -0
  72. package/skills/overnight/SKILL.md +220 -0
  73. package/skills/plan/SKILL.md +96 -0
  74. package/skills/preplan/SKILL.md +87 -0
  75. package/skills/prototype/SKILL.md +151 -0
  76. package/skills/release/SKILL.md +221 -0
  77. package/skills/report/SKILL.md +101 -0
  78. package/skills/review/SKILL.md +120 -0
  79. package/skills/self-test/SKILL.md +127 -0
  80. package/skills/status/SKILL.md +86 -0
  81. package/skills/tests/README.md +29 -0
  82. package/skills/tests/rdc-build.test.json +22 -0
  83. package/skills/tests/rdc-deploy.test.json +15 -0
  84. package/skills/tests/rdc-fixit.test.json +21 -0
  85. package/skills/tests/rdc-handoff.test.json +14 -0
  86. package/skills/tests/rdc-overnight.test.json +21 -0
  87. package/skills/tests/rdc-plan.test.json +14 -0
  88. package/skills/tests/rdc-preplan.test.json +15 -0
  89. package/skills/tests/rdc-prototype.test.json +14 -0
  90. package/skills/tests/rdc-release.test.json +15 -0
  91. package/skills/tests/rdc-report.test.json +14 -0
  92. package/skills/tests/rdc-review.test.json +14 -0
  93. package/skills/tests/rdc-status.test.json +16 -0
  94. package/skills/tests/rdc-workitems.test.json +15 -0
  95. package/skills/watch/SKILL.md +92 -0
  96. package/skills/workitems/SKILL.md +147 -0
  97. package/tests/validate-skills.js +183 -0
@@ -0,0 +1,15 @@
1
+ {
2
+ "projectName": "rdc-skills plugin development",
3
+ "permissions": {
4
+ "allow": [
5
+ "Bash(node:*)",
6
+ "Bash(bash:*)",
7
+ "Bash(git:*)",
8
+ "Bash(npm:*)"
9
+ ]
10
+ },
11
+ "hooks": {
12
+ "enableStopHook": true,
13
+ "stopHookPath": "hooks/no-stop-open-epics.js"
14
+ }
15
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
3
+ "name": "rdc-skills",
4
+ "description": "RDC typed-agent dispatch skill suite — single-plugin marketplace",
5
+ "owner": {
6
+ "name": "LIFEAI",
7
+ "email": "support@lifeai.tools"
8
+ },
9
+ "plugins": [
10
+ {
11
+ "name": "rdc-skills",
12
+ "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
13
+ "category": "development",
14
+ "source": {
15
+ "source": "github",
16
+ "repo": "LIFEAI/rdc-skills"
17
+ },
18
+ "homepage": "https://github.com/LIFEAI/rdc-skills"
19
+ }
20
+ ]
21
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "rdc",
3
+ "version": "0.7.9",
4
+ "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
5
+ "author": {
6
+ "name": "LIFEAI",
7
+ "email": "support@lifeai.tools"
8
+ },
9
+ "homepage": "https://github.com/LIFEAI/rdc-skills",
10
+ "repository": "https://github.com/LIFEAI/rdc-skills"
11
+ }
@@ -0,0 +1,25 @@
1
+ name: Publish to npm
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - 'v*'
7
+
8
+ permissions:
9
+ contents: read
10
+
11
+ jobs:
12
+ publish:
13
+ runs-on: ubuntu-latest
14
+ steps:
15
+ - uses: actions/checkout@v4
16
+
17
+ - uses: actions/setup-node@v4
18
+ with:
19
+ node-version: '24'
20
+ registry-url: 'https://registry.npmjs.org'
21
+
22
+ - name: Publish
23
+ run: npm publish --access public
24
+ env:
25
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
@@ -0,0 +1,53 @@
1
+ name: self-test
2
+
3
+ on:
4
+ push:
5
+ branches: ['**']
6
+ tags: ['v*']
7
+ pull_request:
8
+
9
+ jobs:
10
+ tier1:
11
+ name: Tier 1 static lint
12
+ runs-on: ubuntu-latest
13
+ steps:
14
+ - name: Checkout
15
+ uses: actions/checkout@v4
16
+
17
+ - name: Setup Node 20
18
+ uses: actions/setup-node@v4
19
+ with:
20
+ node-version: '20'
21
+
22
+ - name: Run rdc:self-test --strict (Tier 1)
23
+ # Tier 2 requires headless claude + clauth daemon — not available in standard CI.
24
+ # Tier 1 catches the backtick-drift + frontmatter class of bugs.
25
+ run: node scripts/self-test.mjs --strict
26
+
27
+ tier2-gate:
28
+ name: Tier 2 behavioral (tag releases only)
29
+ runs-on: ubuntu-latest
30
+ if: startsWith(github.ref, 'refs/tags/v')
31
+ needs: tier1
32
+ steps:
33
+ - name: Checkout
34
+ uses: actions/checkout@v4
35
+
36
+ - name: Setup Node 20
37
+ uses: actions/setup-node@v4
38
+ with:
39
+ node-version: '20'
40
+
41
+ - name: Install claude CLI
42
+ run: npm install -g @anthropic-ai/claude-code
43
+ env:
44
+ ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
45
+
46
+ - name: Run rdc:self-test --tier2 --quick (Tier 2)
47
+ # Runs each manifest in --quick mode. Skips long-running (slow:true) tests.
48
+ # Requires: ANTHROPIC_API_KEY secret set in repo settings.
49
+ # Note: check-cwd.js hook must allow RDC_TEST=1 sessions (see guides/agent-bootstrap.md § Known blocker).
50
+ run: node scripts/self-test.mjs --tier2 --quick
51
+ env:
52
+ ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
53
+ RDC_TEST: '1'
package/CHANGELOG.md ADDED
@@ -0,0 +1,246 @@
1
+ # Changelog — @lifeai/rdc-skills
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ---
9
+
10
+ ## 0.6.1 — Tier 2 stability + rdc:watch session watcher
11
+
12
+ ### Added
13
+
14
+ - **`rdc:watch` skill.** Initializes a session log and opens a static HTML viewer that tails Claude activity live via `fetch()` polling. Zero infra — pure filesystem + `.rdc/session-log/current.log` + `viewer.html`. New skill at `skills/rdc-watch.md`, init helper at `scripts/watch-init.mjs`, viewer asset at `assets/watcher/viewer.html`. Dark terminal theme, color-coded event kinds (`dispatch`/`commit`/`test`/`error`/`note`/`banner`), auto-scroll, stall detection.
15
+ - **Tier 2 behavioral harness (WP1–WP9).** Full work-item delta wiring through PostgREST, 13 baseline test manifests, Tier 2 runner, CI workflow, skill documentation.
16
+
17
+ ### Fixed
18
+
19
+ - **Windows spawn streaming.** `scripts/lib/runner.mjs` now passes `--verbose` alongside `--output-format stream-json` so Claude emits events to stdout on Windows. Without it, stream-json output was buffered/empty.
20
+ - **Main-db sandbox mode.** Tier 2 runner supports free, read-only sandbox mode against the main Supabase project so behavioral tests don't accrue hourly branch costs.
21
+
22
+ ---
23
+
24
+ ## v0.6.0 — Plugin conversion + agent-hide
25
+
26
+ ### Added
27
+
28
+ - **Claude Code plugin format.** New `.claude-plugin/plugin.json` manifest at repo root (name, version, description, author, homepage, repository) plus `.claude-plugin/marketplace.json` declaring this repo as a single-plugin marketplace pointing at itself (`source: "."`). Matches the schema used by `hookify`, `commit-commands`, `huggingface-skills`, and other official Anthropic plugins — directories (`skills/`, `hooks/`, `commands/`, `agents/`) are auto-discovered by convention, no explicit path keys needed.
29
+ - **New install path.**
30
+ ```
31
+ /plugin marketplace add LIFEAI/rdc-skills
32
+ /plugin install rdc-skills
33
+ ```
34
+ All 16 user-invocable skills load automatically via Claude Code's plugin runtime — no copy scripts, no `~/.claude/skills/user/` writes.
35
+
36
+ ### Changed
37
+
38
+ - **10 agent-type skills moved out of `skills/` into `guides/agents/`** (Thread D). Reclaims slots in the Claude Code skill menu cap. Agent playbooks (frontend, backend, data, design, infrastructure, content, cs2, viz, setup, verify) are now dispatched internally by `rdc:build` and are no longer user-invocable slash commands.
39
+ - **README install section rewritten** to lead with `/plugin install`. Legacy PowerShell/Bash install path documented under "Legacy install (deprecated)".
40
+
41
+ ### Deprecated
42
+
43
+ - `scripts/install.ps1`, `scripts/install.sh`, `scripts/install.js` — deprecation headers added. These will be **removed in v0.7.0**. Migrate to `/plugin install rdc-skills`.
44
+
45
+ ---
46
+
47
+ ## [0.4.0] — 2026-04-14
48
+
49
+ ### Added
50
+
51
+ #### `rdc:verify` — Verification Gate Skill
52
+ - New skill `skills/rdc-verify.md` — evidence-before-claims verification gate adapted from obra/superpowers `verification-before-completion` pattern
53
+ - **Iron Law**: NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE — no "should", no "probably", no reasoning from memory
54
+ - **Stack-specific commands**: `npx vitest run --dir <pkg>` + `npx tsc --noEmit --project <pkg>/tsconfig.json`
55
+ - **Explicit ban**: `pnpm build` / `pnpm test` / `pnpm -r` — crashes machine (800MB/process)
56
+ - Rationalization prevention table, required output format with quoted evidence
57
+
58
+ ### Changed
59
+
60
+ #### `rdc:build` — Mandatory Final Verification Phase
61
+ - New step 10: invoke `rdc:verify` across every package/app touched before marking epic done
62
+ - Step 11: push + version bump + summary **only after** verification evidence passes
63
+
64
+ #### `rdc:review` — Verification Gate Before CLEAN Verdict
65
+ - New step 9: invoke `rdc:verify` after fixes land — no CLEAN verdict without fresh vitest + tsc output quoted in report
66
+ - If verify fails → loop back, fix, re-run (never emit CLEAN optimistically)
67
+
68
+ ---
69
+
70
+ ## [0.3.0] — 2026-04-13
71
+
72
+ ### Added
73
+
74
+ #### Intelligent Project Detection (`scripts/install.js`)
75
+ - **`detectProjectInfo(projectRoot)`** — scans `package.json`, git remote, `.env.local` (incl. `apps/**`), `CLAUDE.md`, existing `.rdc/config.json` to auto-populate setup interview defaults
76
+ - **Auto-prompt setup interview** — default install now prompts `"No .rdc/config.json found. Run setup interview now? [Y/n]:"` instead of passive tip
77
+ - **Pre-filled interview** — detected values shown in `[brackets]`; press Enter to accept. Eliminates manual re-entry of already-known project metadata
78
+ - **Detection summary printed** — detected project name, GitHub, Supabase ref, branches, guides dir shown after preflight
79
+
80
+ #### `/rdc:setup` Skill
81
+ - **New Claude skill** `rdc-setup.md` — instructs Claude to perform a full project scan (15+ file types), emit structured detection summary, generate `.rdc/config.json` and overlay guides, offer docs/ migration, commit result
82
+ - Complements the `install.js` script-level detection with a richer AI-driven scan when running interactively in Claude Code
83
+ - Preserves existing `agent-bootstrap.md` custom sections when updating
84
+
85
+ ---
86
+
87
+ ## [0.2.0] — 2026-04-13
88
+
89
+ ### Added
90
+
91
+ #### `.rdc/` Project Directory Convention
92
+ - **`.rdc/config.json` schema** — project metadata: name, hook_scope, git config, Supabase ref, credential provider, repo list, path overrides, constraints
93
+ - **Standardised paths**: `.rdc/guides/`, `.rdc/plans/`, `.rdc/reports/`, `.rdc/research/`, `.rdc/state/`
94
+ - All 20 skills updated to read from `.rdc/` with fallback to legacy `docs/` structure for existing projects
95
+ - `guides/agent-bootstrap.md` updated to instruct agents to check `.rdc/config.json` for project metadata
96
+
97
+ #### Installer (`scripts/install.js`)
98
+ - **`--migrate <path>` flag** — interactive wizard: scans for `docs/guides/`, `docs/plans/`, `docs/reports/`, `docs/research/`; offers to move each to `.rdc/`; merges files if destination already exists; auto-detects GitHub org/repo from git remote
99
+ - **`--setup` generates `.rdc/config.json`** from interview answers in addition to `docs/guides/agent-bootstrap.md`
100
+ - **Preflight checks** — Node ≥ 18 (hard error), clauth daemon ping (warn), `.rdc/config.json` presence check (suggest `--setup`)
101
+ - **Multi-project support** — each project carries its own `.rdc/` committed to git; skills are global, intelligence travels with the repo
102
+
103
+ #### Multi-Repo Support
104
+ - `config.json` `repos[]` array — primary + satellite repos listed with roles
105
+ - One project, many repos: monorepo root holds `.rdc/config.json`, lists satellite repo paths
106
+
107
+ ---
108
+
109
+ ## [0.1.0] — 2026-04-13
110
+
111
+ ### Added
112
+
113
+ #### Core Architecture
114
+
115
+ - **Plugin scaffold** — Complete rdc-skills plugin repo structure extracted from regen-root monorepo
116
+ - **Two-layer guide system** — Plugin base guides + project overlay guides enabling skill portability across codebases
117
+ - Plugin base covers generic patterns (work items RPC, git workflow, standard builds)
118
+ - Project overlays (frontend.md, backend.md, data.md, etc.) inject stack-specific conventions
119
+ - Agent receives merged context — project layer wins on conflicts
120
+ - **Skill dispatch system** — Twelve skill commands integrated with Supabase work_items RPC
121
+ - `/rdc:status` — Show open epics, kanban, Coolify health, next action
122
+ - `/rdc:plan <topic>` — Architecture planning, create epic + child tasks
123
+ - `/rdc:preplan <topic>` — Research phase before planning
124
+ - `/rdc:build <epic-id>` — Execute epic tasks in parallel with typed agents
125
+ - `/rdc:review` — Quality gate: tests, types, stale docs, exports
126
+ - `/rdc:overnight` — Unattended full pipeline (chains all skills across queue)
127
+ - `/rdc:fixit <description>` — Sanctioned bypass for <5 files, <30 min hotfixes
128
+ - `/rdc:report` — Generate nightly markdown report to docs/reports/YYYY-MM-DD.md
129
+ - Plus agent bootstrap guide + domain-specific agent guides (frontend, backend, data, design, infrastructure, content, cs2)
130
+
131
+ #### TDD Enforcement (Option B)
132
+
133
+ - **Wave-based test-first builds** — rdc:build now requires tests-first per build wave
134
+ - npx vitest run per package before proceeding to next wave
135
+ - `pnpm build` NEVER invoked (memory constraints on dev machine)
136
+ - Allows async test runs in subagent while supervisor waits
137
+ - **Test harness integration** — skills coordinate with tsconfig paths, jest/vitest configs, test result tracking
138
+ - **Coverage reporting** — per-wave coverage aggregation, integration with GitHub PR checks
139
+
140
+ #### Stop Hook
141
+
142
+ - **no-stop-open-epics.js** — Blocks Claude from stopping when `get_open_epics()` returns todo items
143
+ - Only blocks when todo-status epics exist (in_progress = another session owns them)
144
+ - Project scope guard — only fires in sessions where cwd contains PROJECT_SCOPE folder
145
+ - Integrates with Supabase REST API (project-ref from env vars)
146
+ - Exit code 2 = block, 0 = allow
147
+ - Silent pass if Supabase credentials unavailable
148
+
149
+ #### Installation & Management
150
+
151
+ - **Windows installer** (scripts/install.ps1) — CLAUDE_HOME detection, symlink skills + hooks, summary report
152
+ - **Unix installer** (scripts/install.sh) — Bash equivalent for macOS/Linux
153
+ - **Update scripts** — git pull + reinstall (version bump reporting)
154
+ - **Uninstall scripts** — Safe removal of rdc-skills files only (never touches user files)
155
+ - **Validation test** (tests/validate-skills.js) — YAML frontmatter check, required sections, exit 1 on failure
156
+
157
+ #### Documentation
158
+
159
+ - **Plugin README** — Architecture diagram, quick start, skill reference table, guide types, Option B explanation
160
+ - **Generic work-items-rpc.md** — Complete RPC reference (generic, no hardcoded project IDs)
161
+ - get_open_epics, insert_work_item, update_work_item_status, get_work_items_by_epic, bump_epic_version
162
+ - Valid enum values, JS client patterns, direct SQL patterns
163
+ - **Project setup guide** — Two required files per project (agent-bootstrap.md, project overlay guides)
164
+ - **Contributing guide** — Fork → branch → PR workflow, validate before submit
165
+
166
+ #### Settings & Configuration
167
+
168
+ - **.claude/settings.json** — Plugin harness permissions, nodeID detection
169
+ - **.gitignore** — Standard Node.js + git exclusions
170
+
171
+ ### Changed
172
+
173
+ - N/A (initial release)
174
+
175
+ ### Deprecated
176
+
177
+ - N/A
178
+
179
+ ### Removed
180
+
181
+ - N/A
182
+
183
+ ### Fixed
184
+
185
+ - N/A
186
+
187
+ ### Security
188
+
189
+ - Credential handling via environment variables only (no hardcoded keys)
190
+ - clauth daemon tunnel for all sensitive operations
191
+ - Project scope guard prevents stop hook from firing in wrong context
192
+
193
+ ---
194
+
195
+ ## Installation & Setup
196
+
197
+ ### For end users
198
+
199
+ ```bash
200
+ # Windows
201
+ git clone https://github.com/LIFEAI/rdc-skills.git
202
+ npm run install:win
203
+
204
+ # macOS / Linux
205
+ git clone https://github.com/LIFEAI/rdc-skills.git
206
+ npm run install:unix
207
+ ```
208
+
209
+ Then configure your project:
210
+ 1. Create `docs/guides/agent-bootstrap.md` with credentials
211
+ 2. Create per-role overlay guides in `docs/guides/` (frontend.md, backend.md, etc.)
212
+ 3. Run `/rdc:status` to verify setup
213
+
214
+ ### For contributors
215
+
216
+ ```bash
217
+ git clone https://github.com/LIFEAI/rdc-skills.git
218
+ cd rdc-skills
219
+ npm run validate # Check all skills
220
+ npm run test # (future: comprehensive test suite)
221
+ ```
222
+
223
+ ---
224
+
225
+ ## Known Issues & Roadmap
226
+
227
+ ### Current Limitations
228
+
229
+ - Stop hook requires Supabase access (silent pass if unavailable)
230
+ - No built-in skill/guide templating yet (manual creation)
231
+ - Validation test basic (could extend to markdown lint, frontmatter schema, etc.)
232
+
233
+ ### Phase 2 (Future)
234
+
235
+ - Skill generator (`rdc:newskill`) for rapid skill creation
236
+ - Guide templating system
237
+ - Agent role auto-detection from codebase structure
238
+ - Integration with GitHub Actions CI
239
+ - Skill marketplace / package distribution
240
+ - TDD enforcement integration for all major test frameworks (Vitest, Jest, pytest, Gotest)
241
+
242
+ ---
243
+
244
+ ## License
245
+
246
+ MIT — See LICENSE file for details.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 LIFEAI
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/MANIFEST.md ADDED
@@ -0,0 +1,190 @@
1
+ # RDC Skills Library — Manifest
2
+
3
+ **Created:** 2026-04-13
4
+ **Last updated:** 2026-04-21
5
+ **Source:** Regen Root project `.claude/skills/user/`
6
+ **Files:** 17 skill files (2,277 lines), 10 agent guides, 9 main guides
7
+ **Size:** ~480K
8
+
9
+ ## Generic Conversion Summary
10
+
11
+ All skills have been converted from project-specific to generic/portable:
12
+
13
+ ### Path Replacements
14
+ - `C:/Dev/regen-root/` → `{PROJECT_ROOT}/`
15
+ - Hardcoded app names (rdc-marketing-engine, brand-studio, prt, etc.) → generic examples
16
+ - Specific Supabase project IDs → generic table references
17
+ - Developer-specific paths → variables
18
+
19
+ ### TDD Enhancements
20
+ - Added mandatory post-wave test gate to rdc:build
21
+ - Updated rdc:review with test coverage delta reporting
22
+ - Added test-first requirement to all agent skills
23
+ - TDD enforcement: red → implement → green cycle
24
+
25
+ ### Preserved Elements
26
+ - All logic and procedures (100%)
27
+ - All safety rules
28
+ - All RPC patterns
29
+ - Branch strategy (development → production)
30
+ - Work item lifecycle
31
+ - Escalation protocols
32
+ - Unattended mode patterns
33
+ - Status block format
34
+
35
+ ## Files Created
36
+
37
+ ```
38
+ /c/Dev/rdc-skills/
39
+ ├── README.md
40
+ ├── MANIFEST.md (this file)
41
+ └── skills/
42
+ ├── build/SKILL.md [+TDD enforcement, +verify gate]
43
+ ├── plan/SKILL.md
44
+ ├── preplan/SKILL.md
45
+ ├── review/SKILL.md [+test coverage delta, +verify gate]
46
+ ├── overnight/SKILL.md
47
+ ├── fixit/SKILL.md
48
+ ├── status/SKILL.md
49
+ ├── report/SKILL.md
50
+ ├── collab/SKILL.md [claude.ai ↔ Claude Code relay]
51
+ ├── handoff/SKILL.md
52
+ ├── prototype/SKILL.md
53
+ ├── workitems/SKILL.md
54
+ ├── help/SKILL.md
55
+ ├── deploy/SKILL.md [Coolify deployment ops]
56
+ ├── release/SKILL.md [atomic version release]
57
+ ├── self-test/SKILL.md [static lint + tier2 smoke tests]
58
+ └── watch/SKILL.md [session log + browser viewer]
59
+ └── guides/agents/ (agent-only playbooks — dispatched by rdc:build, not user-invocable)
60
+ ├── frontend.md
61
+ ├── backend.md
62
+ ├── cs2.md
63
+ ├── data.md
64
+ ├── design.md
65
+ ├── infrastructure.md
66
+ ├── content.md
67
+ ├── viz.md
68
+ ├── setup.md
69
+ └── verify.md
70
+ ```
71
+
72
+ **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>/`.
73
+
74
+ ## Skill Categories
75
+
76
+ ### Orchestration (8)
77
+ - rdc:build — dispatch typed agents in waves
78
+ - rdc:plan — architecture + epic/tasks
79
+ - rdc:preplan — research before planning
80
+ - rdc:review — quality gate
81
+ - rdc:overnight — unattended build supervisor
82
+ - rdc:fixit — quick-fix bypass
83
+ - rdc:status — project dashboard
84
+ - rdc:report — nightly report
85
+
86
+ ### DevOps (3)
87
+ - rdc:deploy — Coolify deployment ops (deploy, new, diagnose, audit)
88
+ - rdc:release — atomic version release with git tag + changelog
89
+ - rdc:watch — session log + browser viewer for Claude activity
90
+
91
+ ### Quality (1)
92
+ - rdc:self-test — static lint (tier1) + smoke tests (tier2)
93
+
94
+ ### Agent Guides (10, in `guides/agents/`) — [agent-only — dispatched by rdc:build, not user-invocable]
95
+ - frontend — React, UI, Tailwind
96
+ - backend — API, database, auth
97
+ - data — migrations, schema
98
+ - design — brand, tokens
99
+ - infrastructure — deployment, CI/CD
100
+ - content — copy, messaging
101
+ - cs2 — paradigm-level work
102
+ - viz — visualizations
103
+ - setup — project scan + .rdc/config.json generation
104
+ - verify — evidence-before-claims verification gate
105
+
106
+ ### Utility (1)
107
+ - rdc:collab — bidirectional claude.ai ↔ Claude Code relay via file transport
108
+
109
+ ### Bridge (3)
110
+ - rdc:handoff — planning → work items
111
+ - rdc:prototype — JSX prototypes
112
+ - rdc:workitems — work item CRUD
113
+
114
+ ### Reference (1)
115
+ - rdc:help — skill index
116
+
117
+ ## Usage Instructions
118
+
119
+ 1. **Clone or reference** the `/c/Dev/rdc-skills/` directory
120
+ 2. **Update path variables** in all skills for your project
121
+ 3. **Create project guides** (agent-bootstrap.md, frontend.md, etc.)
122
+ 4. **Set up database** (work_items RPC, prototype_registry, design_context)
123
+ 5. **Invoke skills** via your agent framework
124
+ - Interactive: `/rdc:build <epic-id>`
125
+ - Unattended: `/rdc:overnight`
126
+ - Quality: `/rdc:review --unattended`
127
+
128
+ ## Key Differences from Source
129
+
130
+ ### Added: TDD Enforcement
131
+
132
+ **rdc:build (Step 8):**
133
+ ```bash
134
+ # Post-wave test gate (mandatory)
135
+ cd packages/<name> && npx vitest run 2>&1 | tail -20
136
+ ```
137
+ All tests must pass before next wave.
138
+
139
+ **All agent skills:**
140
+ ```
141
+ TDD REQUIREMENT: Write tests FIRST for new functions/modules.
142
+ Run: npx vitest run packages/<name>
143
+ ```
144
+
145
+ **rdc:review (Step 3):**
146
+ ```bash
147
+ # Check test coverage delta
148
+ git diff origin/main...HEAD -- packages/*/src/ | grep -c "^+"
149
+ git diff origin/main...HEAD -- packages/*/test* | grep -c "^+"
150
+ ```
151
+ Flags any package with implementation added but 0 new tests.
152
+
153
+ **rdc:review report format:**
154
+ ```
155
+ | Package | Tests | Pass/Fail | New Tests Added | Issues |
156
+ ```
157
+
158
+ ### Preserved: All Logic
159
+
160
+ - Work item RPC patterns (never raw SQL)
161
+ - Agent type classification
162
+ - Wave-based parallelization
163
+ - Escalation protocols
164
+ - Unattended mode patterns
165
+ - Status block formatting
166
+ - Safety rules (100%)
167
+ - Branch strategy
168
+
169
+ ## Deployment
170
+
171
+ These skills are ready to use in any project that has:
172
+
173
+ 1. A monorepo with `packages/`, `apps/`, or `sites/` structure
174
+ 2. A database (Supabase, PostgreSQL, etc.) with work_items RPC functions
175
+ 3. Capability to run agents (Claude Code, subagents, or CLI)
176
+ 4. Git-based version control with at least 2 branches (dev + prod)
177
+ 5. A credential management system (clauth daemon or equivalent)
178
+
179
+ ## Questions?
180
+
181
+ - **Specific project integration:** Refer to your project's infrastructure documentation
182
+ - **Skill logic:** All skills are pure logic extracted from Regen Root; no project-specific magic
183
+ - **TDD requirements:** Built into every skill; red → implement → green is mandatory
184
+ - **Database schema:** You define; skills use generic `work_items` table and RPC patterns
185
+
186
+ ---
187
+
188
+ **Manifest created:** 2026-04-13
189
+ **Source project:** Regen Root (github.com/LIFEAI/regen-root)
190
+ **Genericization:** Complete — all hardcoded references removed, all logic preserved