@lifeaitools/rdc-skills 0.24.42 → 0.25.1

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 (202) hide show
  1. package/.claude/settings.json +15 -15
  2. package/.claude-plugin/marketplace.json +21 -21
  3. package/.claude-plugin/plugin.json +1560 -1371
  4. package/.github/workflows/publish.yml +34 -34
  5. package/.github/workflows/self-test.yml +58 -58
  6. package/CHANGELOG.md +322 -310
  7. package/LICENSE +21 -21
  8. package/MANIFEST.md +224 -221
  9. package/README.md +377 -376
  10. package/README.sandbox.md +3 -3
  11. package/assets/watcher/viewer.html +164 -164
  12. package/bin/rdc-skills-mcp.mjs +316 -316
  13. package/commands/build.md +183 -183
  14. package/commands/collab.md +180 -180
  15. package/commands/deploy.md +152 -152
  16. package/commands/design.md +31 -31
  17. package/commands/edit.md +28 -28
  18. package/commands/fixit.md +150 -124
  19. package/commands/handoff.md +173 -173
  20. package/commands/help.md +95 -95
  21. package/commands/overnight.md +220 -220
  22. package/commands/plan.md +158 -158
  23. package/commands/preplan.md +131 -131
  24. package/commands/prototype.md +145 -145
  25. package/commands/release.md +49 -49
  26. package/commands/report.md +99 -99
  27. package/commands/review.md +120 -120
  28. package/commands/self-test.md +113 -113
  29. package/commands/status.md +86 -86
  30. package/commands/watch.md +98 -98
  31. package/commands/workitems.md +137 -137
  32. package/git-sha.json +1 -1
  33. package/guides/agent-bootstrap.md +295 -295
  34. package/guides/agents/backend.md +104 -104
  35. package/guides/agents/content.md +94 -94
  36. package/guides/agents/cs2.md +56 -56
  37. package/guides/agents/data.md +87 -87
  38. package/guides/agents/design.md +77 -77
  39. package/guides/agents/frontend.md +92 -92
  40. package/guides/agents/infrastructure.md +81 -81
  41. package/guides/agents/setup.md +281 -281
  42. package/guides/agents/verify.md +151 -151
  43. package/guides/agents/viz.md +106 -106
  44. package/guides/backend.md +146 -146
  45. package/guides/content.md +147 -147
  46. package/guides/cs2.md +190 -190
  47. package/guides/data.md +123 -123
  48. package/guides/design.md +116 -116
  49. package/guides/engineering-behavior.md +43 -43
  50. package/guides/escalation-protocol.md +125 -125
  51. package/guides/frontend.md +151 -151
  52. package/guides/history-md-spec.md +297 -297
  53. package/guides/infrastructure.md +179 -179
  54. package/guides/lessons-learned-spec.md +145 -151
  55. package/guides/output-contract.md +108 -108
  56. package/guides/publish-md-spec.md +289 -289
  57. package/guides/rdc-skills-startup.md +30 -30
  58. package/guides/verify.md +11 -11
  59. package/hooks/check-cwd.js +31 -31
  60. package/hooks/check-rdc-environment.js +164 -164
  61. package/hooks/check-services.js +6 -6
  62. package/hooks/check-stale-work-items.js +19 -19
  63. package/hooks/foreground-process-gate.js +128 -128
  64. package/hooks/gate-watchdog-selfcheck.js +257 -257
  65. package/hooks/hook-logger.js +25 -25
  66. package/hooks/lib/run-evidence-gate.mjs +241 -241
  67. package/hooks/no-stop-open-epics.js +127 -127
  68. package/hooks/post-tool-batch-gate.js +203 -203
  69. package/hooks/post-work-check.js +21 -21
  70. package/hooks/postcompact-log.js +13 -13
  71. package/hooks/precompact-log.js +13 -13
  72. package/hooks/rate-limit-retry.js +46 -46
  73. package/hooks/rdc-invocation-marker.js +157 -157
  74. package/hooks/rdc-output-contract-gate.js +94 -94
  75. package/hooks/require-work-item-on-commit.js +294 -294
  76. package/hooks/restart-brief.js +19 -19
  77. package/hooks/run-hidden-hook.ps1 +47 -47
  78. package/hooks/task-completed-gate.js +274 -274
  79. package/hooks/work-item-exit-gate.js +944 -944
  80. package/lib/catalog.mjs +236 -236
  81. package/lib/cloud-rewrite.mjs +155 -155
  82. package/package.json +57 -57
  83. package/rules/work-items-rpc.md +520 -520
  84. package/scaffold/templates/HISTORY.md.template +39 -39
  85. package/scaffold/templates/PUBLISH.md.template +21 -21
  86. package/scaffold/templates/brochure-studio-default.html +70 -70
  87. package/scripts/acceptance.mjs +502 -502
  88. package/scripts/fixtures/guides/bad-guide.md +15 -15
  89. package/scripts/fixtures/guides-clean/good-guide.md +16 -16
  90. package/scripts/install-rdc-skills.js +1401 -1289
  91. package/scripts/install.ps1 +202 -202
  92. package/scripts/install.sh +132 -132
  93. package/scripts/lib/assertions.mjs +287 -287
  94. package/scripts/lib/manifest-schema.mjs +754 -754
  95. package/scripts/lib/runner.mjs +465 -465
  96. package/scripts/lib/sandbox.mjs +435 -435
  97. package/scripts/prepack.mjs +32 -32
  98. package/scripts/rdc-brochure.mjs +482 -482
  99. package/scripts/rdc-design-cli.mjs +134 -134
  100. package/scripts/rebuild-mcp.mjs +107 -107
  101. package/scripts/self-test.mjs +1460 -1460
  102. package/scripts/stamp-git-sha.mjs +29 -29
  103. package/scripts/test-guide-validator.mjs +196 -196
  104. package/scripts/test-rdc-hooks.mjs +145 -145
  105. package/scripts/uninstall.ps1 +77 -77
  106. package/scripts/uninstall.sh +69 -69
  107. package/scripts/update.ps1 +43 -43
  108. package/scripts/update.sh +43 -43
  109. package/scripts/validate-place-histories.js +461 -461
  110. package/scripts/validate-publish-manifests.js +502 -424
  111. package/scripts/watch-init.mjs +100 -100
  112. package/skills/brochure/SKILL.md +107 -107
  113. package/skills/build/SKILL.md +578 -563
  114. package/skills/channel-formatter/SKILL.md +538 -533
  115. package/skills/co-develop/SKILL.md +196 -196
  116. package/skills/collab/SKILL.md +239 -239
  117. package/skills/convert/SKILL.md +167 -140
  118. package/skills/deploy/SKILL.md +541 -541
  119. package/skills/design/SKILL.md +211 -211
  120. package/skills/design/reference/ownership.md +16 -16
  121. package/skills/design/reference/rampa.md +92 -92
  122. package/skills/design/reference/studio-model.md +153 -153
  123. package/skills/edit/SKILL.md +98 -98
  124. package/skills/env/SKILL.md +141 -0
  125. package/skills/fixit/SKILL.md +203 -165
  126. package/skills/fs-mcp/SKILL.md +183 -148
  127. package/skills/handoff/SKILL.md +236 -236
  128. package/skills/help/SKILL.md +143 -143
  129. package/skills/housekeeping/SKILL.md +160 -219
  130. package/skills/lifeai-brochure-author/SKILL.md +340 -340
  131. package/skills/new-model/SKILL.md +49 -0
  132. package/skills/onramp/SKILL.md +1459 -0
  133. package/skills/overnight/SKILL.md +251 -251
  134. package/skills/plan/SKILL.md +345 -345
  135. package/skills/preplan/SKILL.md +90 -90
  136. package/skills/prototype/SKILL.md +150 -150
  137. package/skills/rdc-brochurify/SKILL.md +245 -245
  138. package/skills/rdc-extract-verifier-rules/SKILL.md +191 -191
  139. package/skills/regen-media/SKILL.md +94 -0
  140. package/skills/release/SKILL.md +140 -140
  141. package/skills/report/SKILL.md +100 -100
  142. package/skills/review/SKILL.md +160 -152
  143. package/skills/rpms-filemap/SKILL.cloud.md +111 -111
  144. package/skills/rpms-filemap/SKILL.md +111 -111
  145. package/skills/self-test/SKILL.md +132 -132
  146. package/skills/status/SKILL.md +99 -99
  147. package/skills/terminal-config/SKILL.md +62 -62
  148. package/skills/tests/MATRIX.md +55 -54
  149. package/skills/tests/README.md +47 -47
  150. package/skills/tests/onramp.test.json +87 -0
  151. package/skills/tests/rdc-brochure.test.json +34 -34
  152. package/skills/tests/rdc-build.test.json +36 -36
  153. package/skills/tests/rdc-channel-formatter.test.json +45 -45
  154. package/skills/tests/rdc-co-develop.test.json +29 -29
  155. package/skills/tests/rdc-collab.test.json +29 -29
  156. package/skills/tests/rdc-convert.test.json +35 -35
  157. package/skills/tests/rdc-deploy.test.json +30 -30
  158. package/skills/tests/rdc-design.test.json +27 -27
  159. package/skills/tests/rdc-edit.test.json +29 -29
  160. package/skills/tests/rdc-fixit.test.json +36 -36
  161. package/skills/tests/rdc-fs-mcp.test.json +36 -36
  162. package/skills/tests/rdc-handoff.test.json +28 -28
  163. package/skills/tests/rdc-help.test.json +29 -29
  164. package/skills/tests/rdc-housekeeping.test.json +28 -32
  165. package/skills/tests/rdc-lifeai-brochure-author.test.json +35 -35
  166. package/skills/tests/rdc-overnight.test.json +37 -37
  167. package/skills/tests/rdc-plan.test.json +27 -27
  168. package/skills/tests/rdc-preplan.test.json +31 -31
  169. package/skills/tests/rdc-prototype.test.json +28 -28
  170. package/skills/tests/rdc-rdc-brochurify.test.json +23 -23
  171. package/skills/tests/rdc-rdc-extract-verifier-rules.test.json +34 -34
  172. package/skills/tests/rdc-regen-media.test.json +29 -0
  173. package/skills/tests/rdc-release.test.json +29 -29
  174. package/skills/tests/rdc-report.test.json +28 -28
  175. package/skills/tests/rdc-review.test.json +29 -29
  176. package/skills/tests/rdc-rpms-filemap.test.json +28 -28
  177. package/skills/tests/rdc-self-test.test.json +24 -24
  178. package/skills/tests/rdc-status.test.json +29 -29
  179. package/skills/tests/rdc-terminal-config.test.json +29 -29
  180. package/skills/tests/rdc-watch.test.json +24 -24
  181. package/skills/tests/rdc-workitems.test.json +27 -27
  182. package/skills/watch/SKILL.md +97 -97
  183. package/skills/workitems/SKILL.md +151 -151
  184. package/tests/acceptance.test.mjs +59 -59
  185. package/tests/channel-formatter.contract.test.mjs +251 -251
  186. package/tests/curl-surface.test.mjs +289 -289
  187. package/tests/harness-gates.test.mjs +325 -325
  188. package/tests/help-surface.test.mjs +61 -61
  189. package/tests/install-rdc-skills.test.mjs +49 -49
  190. package/tests/manifest-contract-fields.test.mjs +78 -78
  191. package/tests/mcp.test.mjs +271 -271
  192. package/tests/rdc-brochure.test.mjs +125 -125
  193. package/tests/require-work-item-on-commit.test.mjs +162 -162
  194. package/tests/run-evidence-gate.test.mjs +82 -82
  195. package/tests/skill-test-matrix.test.mjs +66 -66
  196. package/tests/validate-skills.js +27 -27
  197. package/tests/work-item-exit-gate-l2.test.mjs +368 -368
  198. package/tests/work-item-exit-gate-l3.test.mjs +197 -197
  199. package/RELEASE.md +0 -42
  200. package/tests/housekeeping-lessons-triage.test.mjs +0 -49
  201. package/tests/lessons-pipeline-contract.test.mjs +0 -27
  202. package/tests/release-contract.test.mjs +0 -16
@@ -1,202 +1,202 @@
1
- # DEPRECATED as of v0.6.0 — use /plugin install rdc-skills.
2
- # Will be removed in v0.7.0. See README.md "Install" section.
3
- #
4
- # Install rdc-skills plugin to Claude Code
5
- # Windows PowerShell script
6
- #
7
- # Usage:
8
- # ./install.ps1 # standard install
9
- # ./install.ps1 -SkipHooks # skip hooks registration (e.g. if you manage hooks manually)
10
- # ./install.ps1 -Profile core # portable hooks only
11
- # ./install.ps1 -Profile lifeai # LIFEAI/regen-root hooks
12
- # ./install.ps1 -ClaudeHome <path> # custom CLAUDE_HOME
13
-
14
- param(
15
- [string]$ClaudeHome = "",
16
- [ValidateSet("auto", "core", "lifeai")]
17
- [string]$Profile = "auto",
18
- [switch]$SkipHooks = $false,
19
- [switch]$Force = $false
20
- )
21
-
22
- # Detect CLAUDE_HOME
23
- if (-not $ClaudeHome) {
24
- $ClaudeHome = Join-Path $env:USERPROFILE ".claude"
25
- }
26
-
27
- $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
28
- $repoRoot = Split-Path -Parent $scriptDir
29
- $lifeaiRoot = Join-Path (Split-Path -Parent $repoRoot) "regen-root"
30
- $installProfile = if ($Profile -eq "auto") {
31
- if ((Test-Path (Join-Path $lifeaiRoot "CLAUDE.md")) -and (Test-Path (Join-Path $lifeaiRoot ".rdc"))) { "lifeai" } else { "core" }
32
- } else {
33
- $Profile
34
- }
35
-
36
- Write-Host ""
37
- Write-Host " rdc-skills Installer" -ForegroundColor Green
38
- Write-Host " ====================" -ForegroundColor Green
39
- Write-Host ""
40
- Write-Host " CLAUDE_HOME : $ClaudeHome" -ForegroundColor Cyan
41
- Write-Host " Plugin root : $repoRoot" -ForegroundColor Cyan
42
- Write-Host " Profile : $installProfile$(if ($Profile -eq 'auto') { ' (auto)' } else { '' })" -ForegroundColor Cyan
43
- Write-Host ""
44
-
45
- if (-not (Test-Path $ClaudeHome)) {
46
- Write-Host " ERROR: CLAUDE_HOME not found: $ClaudeHome" -ForegroundColor Red
47
- exit 1
48
- }
49
-
50
- # ── 1. Skills ────────────────────────────────────────────────────────────────
51
-
52
- $skillsDir = Join-Path $ClaudeHome "skills" "user"
53
- if (-not (Test-Path $skillsDir)) {
54
- New-Item -ItemType Directory -Path $skillsDir -Force | Out-Null
55
- }
56
-
57
- $srcSkills = Join-Path $repoRoot "skills"
58
- $skillFiles = Get-ChildItem -Path $srcSkills -Filter "*.md" -ErrorAction SilentlyContinue
59
- foreach ($f in $skillFiles) {
60
- Copy-Item -Path $f.FullName -Destination (Join-Path $skillsDir $f.Name) -Force
61
- }
62
- Write-Host " [1/3] Skills ✓ $($skillFiles.Count) file(s) → $skillsDir" -ForegroundColor Green
63
-
64
- # ── 2. Hooks (files) ─────────────────────────────────────────────────────────
65
-
66
- $hooksDir = Join-Path $ClaudeHome "hooks"
67
- if (-not (Test-Path $hooksDir)) {
68
- New-Item -ItemType Directory -Path $hooksDir -Force | Out-Null
69
- }
70
-
71
- $srcHooks = Join-Path $repoRoot "hooks"
72
- $hookFiles = Get-ChildItem -Path $srcHooks -File -ErrorAction SilentlyContinue | Where-Object { $_.Extension -in @(".js", ".ps1") }
73
- foreach ($f in $hookFiles) {
74
- Copy-Item -Path $f.FullName -Destination (Join-Path $hooksDir $f.Name) -Force
75
- }
76
- Write-Host " [2/3] Hook files ✓ $($hookFiles.Count) file(s) → $hooksDir" -ForegroundColor Green
77
-
78
- # ── 3. Register hooks in settings.json ───────────────────────────────────────
79
-
80
- if ($SkipHooks) {
81
- Write-Host " [3/3] Hook wiring ⏭ skipped (--SkipHooks)" -ForegroundColor DarkGray
82
- } else {
83
- $settingsPath = Join-Path $ClaudeHome "settings.json"
84
-
85
- # Load existing settings (or start fresh)
86
- if (Test-Path $settingsPath) {
87
- $settings = Get-Content $settingsPath -Raw | ConvertFrom-Json
88
- } else {
89
- $settings = [PSCustomObject]@{}
90
- }
91
-
92
- # Build hooks block — all paths use forward slashes for cross-platform compat
93
- $hooksBase = $hooksDir.Replace("\", "/")
94
-
95
- $hooksConfig = [PSCustomObject]@{
96
- UserPromptExpansion = @(
97
- [PSCustomObject]@{
98
- hooks = @(
99
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC slash command..." }
100
- )
101
- }
102
- )
103
- UserPromptSubmit = @(
104
- [PSCustomObject]@{
105
- hooks = @(
106
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC prompt..." }
107
- )
108
- }
109
- )
110
- PreToolUse = @(
111
- [PSCustomObject]@{
112
- hooks = @(
113
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/foreground-process-gate.js`""; statusMessage = "Checking foreground process policy..." }
114
- )
115
- },
116
- [PSCustomObject]@{
117
- matcher = "Bash"
118
- hooks = @(
119
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/require-work-item-on-commit.js`"" }
120
- )
121
- }
122
- )
123
- PostToolUse = @(
124
- [PSCustomObject]@{
125
- hooks = @(
126
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-services.js`"" }
127
- )
128
- }
129
- )
130
- Stop = @(
131
- [PSCustomObject]@{
132
- hooks = @(
133
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-output-contract-gate.js`""; statusMessage = "Checking RDC output contract..." },
134
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/post-work-check.js`""; statusMessage = "Checking for undocumented work..." }
135
- )
136
- }
137
- )
138
- }
139
-
140
- if ($installProfile -eq "lifeai") {
141
- $hooksConfig | Add-Member -NotePropertyName "SessionStart" -NotePropertyValue @(
142
- [PSCustomObject]@{
143
- hooks = @(
144
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-cwd.js`"" },
145
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-stale-work-items.js`""; statusMessage = "Checking for stale work items..." }
146
- )
147
- }
148
- )
149
- $hooksConfig.PreToolUse[0].hooks += [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/work-item-exit-gate.js`""; statusMessage = "Checking work item exit gates..." }
150
- $hooksConfig | Add-Member -NotePropertyName "PreCompact" -NotePropertyValue @(
151
- [PSCustomObject]@{ hooks = @([PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/precompact-log.js`"" }) }
152
- )
153
- $hooksConfig | Add-Member -NotePropertyName "PostCompact" -NotePropertyValue @(
154
- [PSCustomObject]@{
155
- hooks = @(
156
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/postcompact-log.js`"" },
157
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/restart-brief.js`""; statusMessage = "Writing restart brief..." }
158
- )
159
- }
160
- )
161
- $hooksConfig.Stop[0].hooks = @(
162
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rate-limit-retry.js`""; statusMessage = "Checking for rate limits..." }
163
- ) + $hooksConfig.Stop[0].hooks + @(
164
- [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/no-stop-open-epics.js`""; statusMessage = "Checking for open epics..." }
165
- )
166
- }
167
-
168
- # Add/replace hooks key
169
- if ($settings.PSObject.Properties["hooks"]) {
170
- $settings.hooks = $hooksConfig
171
- } else {
172
- $settings | Add-Member -NotePropertyName "hooks" -NotePropertyValue $hooksConfig -Force
173
- }
174
-
175
- # Write back with 2-space indent
176
- $settings | ConvertTo-Json -Depth 20 | Set-Content $settingsPath -Encoding UTF8
177
- Write-Host " [3/3] Hook wiring ✓ registered in $settingsPath" -ForegroundColor Green
178
- }
179
- }
180
- }
181
-
182
- # ── Summary ───────────────────────────────────────────────────────────────────
183
-
184
- Write-Host ""
185
- Write-Host " Installation complete!" -ForegroundColor Green
186
- Write-Host ""
187
- Write-Host " Next steps:" -ForegroundColor Yellow
188
- Write-Host " 1. Create project overlay guides (required for project-specific context):"
189
- Write-Host " docs/guides/agent-bootstrap.md ← credentials, git rules, Supabase ref"
190
- Write-Host " docs/guides/frontend.md ← your design system rules"
191
- Write-Host " docs/guides/backend.md ← your API/DB patterns"
192
- Write-Host " docs/guides/data.md ← your migration patterns"
193
- Write-Host ""
194
- Write-Host " 2. Use rdc-skills/guides/*.md as starting-point templates"
195
- Write-Host ""
196
- Write-Host " 3. Restart Claude Code so hook changes take effect"
197
- Write-Host ""
198
- Write-Host " 4. Run /rdc:status in Claude Code to verify"
199
- Write-Host ""
200
- Write-Host " Docs: https://github.com/LIFEAI/rdc-skills#readme" -ForegroundColor Cyan
201
- Write-Host ""
202
- }
1
+ # DEPRECATED as of v0.6.0 — use /plugin install rdc-skills.
2
+ # Will be removed in v0.7.0. See README.md "Install" section.
3
+ #
4
+ # Install rdc-skills plugin to Claude Code
5
+ # Windows PowerShell script
6
+ #
7
+ # Usage:
8
+ # ./install.ps1 # standard install
9
+ # ./install.ps1 -SkipHooks # skip hooks registration (e.g. if you manage hooks manually)
10
+ # ./install.ps1 -Profile core # portable hooks only
11
+ # ./install.ps1 -Profile lifeai # LIFEAI/regen-root hooks
12
+ # ./install.ps1 -ClaudeHome <path> # custom CLAUDE_HOME
13
+
14
+ param(
15
+ [string]$ClaudeHome = "",
16
+ [ValidateSet("auto", "core", "lifeai")]
17
+ [string]$Profile = "auto",
18
+ [switch]$SkipHooks = $false,
19
+ [switch]$Force = $false
20
+ )
21
+
22
+ # Detect CLAUDE_HOME
23
+ if (-not $ClaudeHome) {
24
+ $ClaudeHome = Join-Path $env:USERPROFILE ".claude"
25
+ }
26
+
27
+ $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
28
+ $repoRoot = Split-Path -Parent $scriptDir
29
+ $lifeaiRoot = Join-Path (Split-Path -Parent $repoRoot) "regen-root"
30
+ $installProfile = if ($Profile -eq "auto") {
31
+ if ((Test-Path (Join-Path $lifeaiRoot "CLAUDE.md")) -and (Test-Path (Join-Path $lifeaiRoot ".rdc"))) { "lifeai" } else { "core" }
32
+ } else {
33
+ $Profile
34
+ }
35
+
36
+ Write-Host ""
37
+ Write-Host " rdc-skills Installer" -ForegroundColor Green
38
+ Write-Host " ====================" -ForegroundColor Green
39
+ Write-Host ""
40
+ Write-Host " CLAUDE_HOME : $ClaudeHome" -ForegroundColor Cyan
41
+ Write-Host " Plugin root : $repoRoot" -ForegroundColor Cyan
42
+ Write-Host " Profile : $installProfile$(if ($Profile -eq 'auto') { ' (auto)' } else { '' })" -ForegroundColor Cyan
43
+ Write-Host ""
44
+
45
+ if (-not (Test-Path $ClaudeHome)) {
46
+ Write-Host " ERROR: CLAUDE_HOME not found: $ClaudeHome" -ForegroundColor Red
47
+ exit 1
48
+ }
49
+
50
+ # ── 1. Skills ────────────────────────────────────────────────────────────────
51
+
52
+ $skillsDir = Join-Path $ClaudeHome "skills" "user"
53
+ if (-not (Test-Path $skillsDir)) {
54
+ New-Item -ItemType Directory -Path $skillsDir -Force | Out-Null
55
+ }
56
+
57
+ $srcSkills = Join-Path $repoRoot "skills"
58
+ $skillFiles = Get-ChildItem -Path $srcSkills -Filter "*.md" -ErrorAction SilentlyContinue
59
+ foreach ($f in $skillFiles) {
60
+ Copy-Item -Path $f.FullName -Destination (Join-Path $skillsDir $f.Name) -Force
61
+ }
62
+ Write-Host " [1/3] Skills ✓ $($skillFiles.Count) file(s) → $skillsDir" -ForegroundColor Green
63
+
64
+ # ── 2. Hooks (files) ─────────────────────────────────────────────────────────
65
+
66
+ $hooksDir = Join-Path $ClaudeHome "hooks"
67
+ if (-not (Test-Path $hooksDir)) {
68
+ New-Item -ItemType Directory -Path $hooksDir -Force | Out-Null
69
+ }
70
+
71
+ $srcHooks = Join-Path $repoRoot "hooks"
72
+ $hookFiles = Get-ChildItem -Path $srcHooks -File -ErrorAction SilentlyContinue | Where-Object { $_.Extension -in @(".js", ".ps1") }
73
+ foreach ($f in $hookFiles) {
74
+ Copy-Item -Path $f.FullName -Destination (Join-Path $hooksDir $f.Name) -Force
75
+ }
76
+ Write-Host " [2/3] Hook files ✓ $($hookFiles.Count) file(s) → $hooksDir" -ForegroundColor Green
77
+
78
+ # ── 3. Register hooks in settings.json ───────────────────────────────────────
79
+
80
+ if ($SkipHooks) {
81
+ Write-Host " [3/3] Hook wiring ⏭ skipped (--SkipHooks)" -ForegroundColor DarkGray
82
+ } else {
83
+ $settingsPath = Join-Path $ClaudeHome "settings.json"
84
+
85
+ # Load existing settings (or start fresh)
86
+ if (Test-Path $settingsPath) {
87
+ $settings = Get-Content $settingsPath -Raw | ConvertFrom-Json
88
+ } else {
89
+ $settings = [PSCustomObject]@{}
90
+ }
91
+
92
+ # Build hooks block — all paths use forward slashes for cross-platform compat
93
+ $hooksBase = $hooksDir.Replace("\", "/")
94
+
95
+ $hooksConfig = [PSCustomObject]@{
96
+ UserPromptExpansion = @(
97
+ [PSCustomObject]@{
98
+ hooks = @(
99
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC slash command..." }
100
+ )
101
+ }
102
+ )
103
+ UserPromptSubmit = @(
104
+ [PSCustomObject]@{
105
+ hooks = @(
106
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC prompt..." }
107
+ )
108
+ }
109
+ )
110
+ PreToolUse = @(
111
+ [PSCustomObject]@{
112
+ hooks = @(
113
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/foreground-process-gate.js`""; statusMessage = "Checking foreground process policy..." }
114
+ )
115
+ },
116
+ [PSCustomObject]@{
117
+ matcher = "Bash"
118
+ hooks = @(
119
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/require-work-item-on-commit.js`"" }
120
+ )
121
+ }
122
+ )
123
+ PostToolUse = @(
124
+ [PSCustomObject]@{
125
+ hooks = @(
126
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-services.js`"" }
127
+ )
128
+ }
129
+ )
130
+ Stop = @(
131
+ [PSCustomObject]@{
132
+ hooks = @(
133
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-output-contract-gate.js`""; statusMessage = "Checking RDC output contract..." },
134
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/post-work-check.js`""; statusMessage = "Checking for undocumented work..." }
135
+ )
136
+ }
137
+ )
138
+ }
139
+
140
+ if ($installProfile -eq "lifeai") {
141
+ $hooksConfig | Add-Member -NotePropertyName "SessionStart" -NotePropertyValue @(
142
+ [PSCustomObject]@{
143
+ hooks = @(
144
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-cwd.js`"" },
145
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-stale-work-items.js`""; statusMessage = "Checking for stale work items..." }
146
+ )
147
+ }
148
+ )
149
+ $hooksConfig.PreToolUse[0].hooks += [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/work-item-exit-gate.js`""; statusMessage = "Checking work item exit gates..." }
150
+ $hooksConfig | Add-Member -NotePropertyName "PreCompact" -NotePropertyValue @(
151
+ [PSCustomObject]@{ hooks = @([PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/precompact-log.js`"" }) }
152
+ )
153
+ $hooksConfig | Add-Member -NotePropertyName "PostCompact" -NotePropertyValue @(
154
+ [PSCustomObject]@{
155
+ hooks = @(
156
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/postcompact-log.js`"" },
157
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/restart-brief.js`""; statusMessage = "Writing restart brief..." }
158
+ )
159
+ }
160
+ )
161
+ $hooksConfig.Stop[0].hooks = @(
162
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rate-limit-retry.js`""; statusMessage = "Checking for rate limits..." }
163
+ ) + $hooksConfig.Stop[0].hooks + @(
164
+ [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/no-stop-open-epics.js`""; statusMessage = "Checking for open epics..." }
165
+ )
166
+ }
167
+
168
+ # Add/replace hooks key
169
+ if ($settings.PSObject.Properties["hooks"]) {
170
+ $settings.hooks = $hooksConfig
171
+ } else {
172
+ $settings | Add-Member -NotePropertyName "hooks" -NotePropertyValue $hooksConfig -Force
173
+ }
174
+
175
+ # Write back with 2-space indent
176
+ $settings | ConvertTo-Json -Depth 20 | Set-Content $settingsPath -Encoding UTF8
177
+ Write-Host " [3/3] Hook wiring ✓ registered in $settingsPath" -ForegroundColor Green
178
+ }
179
+ }
180
+ }
181
+
182
+ # ── Summary ───────────────────────────────────────────────────────────────────
183
+
184
+ Write-Host ""
185
+ Write-Host " Installation complete!" -ForegroundColor Green
186
+ Write-Host ""
187
+ Write-Host " Next steps:" -ForegroundColor Yellow
188
+ Write-Host " 1. Create project overlay guides (required for project-specific context):"
189
+ Write-Host " docs/guides/agent-bootstrap.md ← credentials, git rules, Supabase ref"
190
+ Write-Host " docs/guides/frontend.md ← your design system rules"
191
+ Write-Host " docs/guides/backend.md ← your API/DB patterns"
192
+ Write-Host " docs/guides/data.md ← your migration patterns"
193
+ Write-Host ""
194
+ Write-Host " 2. Use rdc-skills/guides/*.md as starting-point templates"
195
+ Write-Host ""
196
+ Write-Host " 3. Restart Claude Code so hook changes take effect"
197
+ Write-Host ""
198
+ Write-Host " 4. Run /rdc:status in Claude Code to verify"
199
+ Write-Host ""
200
+ Write-Host " Docs: https://github.com/LIFEAI/rdc-skills#readme" -ForegroundColor Cyan
201
+ Write-Host ""
202
+ }