@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.
- package/.claude/settings.json +15 -0
- package/.claude-plugin/marketplace.json +21 -0
- package/.claude-plugin/plugin.json +11 -0
- package/.github/workflows/publish.yml +25 -0
- package/.github/workflows/self-test.yml +53 -0
- package/CHANGELOG.md +246 -0
- package/LICENSE +21 -0
- package/MANIFEST.md +190 -0
- package/README.md +188 -0
- package/README.sandbox.md +3 -0
- package/assets/watcher/viewer.html +164 -0
- package/commands/build.md +183 -0
- package/commands/collab.md +180 -0
- package/commands/deploy.md +138 -0
- package/commands/fixit.md +112 -0
- package/commands/handoff.md +173 -0
- package/commands/help.md +88 -0
- package/commands/overnight.md +220 -0
- package/commands/plan.md +158 -0
- package/commands/preplan.md +131 -0
- package/commands/prototype.md +145 -0
- package/commands/release.md +159 -0
- package/commands/report.md +99 -0
- package/commands/review.md +120 -0
- package/commands/self-test.md +107 -0
- package/commands/status.md +86 -0
- package/commands/watch.md +92 -0
- package/commands/workitems.md +132 -0
- package/guides/.gitkeep +0 -0
- package/guides/agent-bootstrap.md +191 -0
- package/guides/agents/backend.md +104 -0
- package/guides/agents/content.md +94 -0
- package/guides/agents/cs2.md +56 -0
- package/guides/agents/data.md +87 -0
- package/guides/agents/design.md +77 -0
- package/guides/agents/frontend.md +92 -0
- package/guides/agents/infrastructure.md +81 -0
- package/guides/agents/setup.md +279 -0
- package/guides/agents/verify.md +132 -0
- package/guides/agents/viz.md +106 -0
- package/guides/backend.md +146 -0
- package/guides/content.md +147 -0
- package/guides/cs2.md +190 -0
- package/guides/data.md +123 -0
- package/guides/design.md +116 -0
- package/guides/frontend.md +151 -0
- package/guides/infrastructure.md +179 -0
- package/guides/output-contract.md +98 -0
- package/hooks/no-stop-open-epics.js +125 -0
- package/package.json +31 -0
- package/rules/work-items-rpc.md +399 -0
- package/scripts/install-rdc-skills.js +559 -0
- package/scripts/install.ps1 +165 -0
- package/scripts/install.sh +132 -0
- package/scripts/lib/assertions.mjs +264 -0
- package/scripts/lib/manifest-schema.mjs +607 -0
- package/scripts/lib/runner.mjs +429 -0
- package/scripts/lib/sandbox.mjs +435 -0
- package/scripts/self-test.mjs +1108 -0
- package/scripts/uninstall.ps1 +77 -0
- package/scripts/uninstall.sh +69 -0
- package/scripts/update.ps1 +43 -0
- package/scripts/update.sh +43 -0
- package/scripts/watch-init.mjs +100 -0
- package/skills/.gitkeep +0 -0
- package/skills/build/SKILL.md +238 -0
- package/skills/collab/SKILL.md +218 -0
- package/skills/deploy/SKILL.md +144 -0
- package/skills/fixit/SKILL.md +112 -0
- package/skills/handoff/SKILL.md +175 -0
- package/skills/help/SKILL.md +101 -0
- package/skills/overnight/SKILL.md +220 -0
- package/skills/plan/SKILL.md +96 -0
- package/skills/preplan/SKILL.md +87 -0
- package/skills/prototype/SKILL.md +151 -0
- package/skills/release/SKILL.md +221 -0
- package/skills/report/SKILL.md +101 -0
- package/skills/review/SKILL.md +120 -0
- package/skills/self-test/SKILL.md +127 -0
- package/skills/status/SKILL.md +86 -0
- package/skills/tests/README.md +29 -0
- package/skills/tests/rdc-build.test.json +22 -0
- package/skills/tests/rdc-deploy.test.json +15 -0
- package/skills/tests/rdc-fixit.test.json +21 -0
- package/skills/tests/rdc-handoff.test.json +14 -0
- package/skills/tests/rdc-overnight.test.json +21 -0
- package/skills/tests/rdc-plan.test.json +14 -0
- package/skills/tests/rdc-preplan.test.json +15 -0
- package/skills/tests/rdc-prototype.test.json +14 -0
- package/skills/tests/rdc-release.test.json +15 -0
- package/skills/tests/rdc-report.test.json +14 -0
- package/skills/tests/rdc-review.test.json +14 -0
- package/skills/tests/rdc-status.test.json +16 -0
- package/skills/tests/rdc-workitems.test.json +15 -0
- package/skills/watch/SKILL.md +92 -0
- package/skills/workitems/SKILL.md +147 -0
- 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
|