@lifeaitools/rdc-skills 0.24.38 → 0.24.41

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 (196) hide show
  1. package/.claude/settings.json +15 -15
  2. package/.claude-plugin/marketplace.json +21 -21
  3. package/.claude-plugin/plugin.json +1371 -1371
  4. package/.github/workflows/publish.yml +34 -34
  5. package/.github/workflows/self-test.yml +58 -58
  6. package/CHANGELOG.md +310 -310
  7. package/LICENSE +21 -21
  8. package/MANIFEST.md +221 -221
  9. package/README.md +376 -375
  10. package/README.sandbox.md +3 -3
  11. package/RELEASE.md +42 -0
  12. package/assets/watcher/viewer.html +164 -164
  13. package/bin/rdc-skills-mcp.mjs +316 -316
  14. package/commands/build.md +183 -183
  15. package/commands/collab.md +180 -180
  16. package/commands/deploy.md +152 -152
  17. package/commands/design.md +31 -31
  18. package/commands/edit.md +28 -28
  19. package/commands/fixit.md +124 -124
  20. package/commands/handoff.md +173 -173
  21. package/commands/help.md +95 -95
  22. package/commands/overnight.md +220 -220
  23. package/commands/plan.md +158 -158
  24. package/commands/preplan.md +131 -131
  25. package/commands/prototype.md +145 -145
  26. package/commands/release.md +49 -49
  27. package/commands/report.md +99 -99
  28. package/commands/review.md +120 -120
  29. package/commands/self-test.md +113 -113
  30. package/commands/status.md +86 -86
  31. package/commands/watch.md +98 -98
  32. package/commands/workitems.md +137 -137
  33. package/git-sha.json +1 -1
  34. package/guides/agent-bootstrap.md +295 -295
  35. package/guides/agents/backend.md +104 -104
  36. package/guides/agents/content.md +94 -94
  37. package/guides/agents/cs2.md +56 -56
  38. package/guides/agents/data.md +87 -87
  39. package/guides/agents/design.md +77 -77
  40. package/guides/agents/frontend.md +92 -92
  41. package/guides/agents/infrastructure.md +81 -81
  42. package/guides/agents/setup.md +281 -281
  43. package/guides/agents/verify.md +151 -151
  44. package/guides/agents/viz.md +106 -106
  45. package/guides/backend.md +146 -146
  46. package/guides/content.md +147 -147
  47. package/guides/cs2.md +190 -190
  48. package/guides/data.md +123 -123
  49. package/guides/design.md +116 -116
  50. package/guides/engineering-behavior.md +43 -43
  51. package/guides/escalation-protocol.md +125 -125
  52. package/guides/frontend.md +151 -151
  53. package/guides/history-md-spec.md +297 -297
  54. package/guides/infrastructure.md +179 -179
  55. package/guides/lessons-learned-spec.md +151 -145
  56. package/guides/output-contract.md +108 -108
  57. package/guides/publish-md-spec.md +289 -289
  58. package/guides/rdc-skills-startup.md +30 -30
  59. package/guides/verify.md +11 -11
  60. package/hooks/check-cwd.js +31 -31
  61. package/hooks/check-rdc-environment.js +164 -164
  62. package/hooks/check-services.js +6 -6
  63. package/hooks/check-stale-work-items.js +19 -19
  64. package/hooks/foreground-process-gate.js +128 -128
  65. package/hooks/gate-watchdog-selfcheck.js +257 -257
  66. package/hooks/hook-logger.js +25 -25
  67. package/hooks/lib/run-evidence-gate.mjs +241 -241
  68. package/hooks/no-stop-open-epics.js +127 -127
  69. package/hooks/post-tool-batch-gate.js +203 -203
  70. package/hooks/post-work-check.js +21 -21
  71. package/hooks/postcompact-log.js +13 -13
  72. package/hooks/precompact-log.js +13 -13
  73. package/hooks/rate-limit-retry.js +46 -46
  74. package/hooks/rdc-invocation-marker.js +157 -157
  75. package/hooks/rdc-output-contract-gate.js +94 -94
  76. package/hooks/require-work-item-on-commit.js +294 -294
  77. package/hooks/restart-brief.js +19 -19
  78. package/hooks/run-hidden-hook.ps1 +47 -47
  79. package/hooks/task-completed-gate.js +274 -274
  80. package/hooks/work-item-exit-gate.js +944 -944
  81. package/lib/catalog.mjs +236 -236
  82. package/lib/cloud-rewrite.mjs +155 -155
  83. package/package.json +57 -56
  84. package/rules/work-items-rpc.md +520 -520
  85. package/scaffold/templates/HISTORY.md.template +39 -39
  86. package/scaffold/templates/PUBLISH.md.template +21 -21
  87. package/scaffold/templates/brochure-studio-default.html +70 -70
  88. package/scripts/acceptance.mjs +502 -502
  89. package/scripts/fixtures/guides/bad-guide.md +15 -15
  90. package/scripts/fixtures/guides-clean/good-guide.md +16 -16
  91. package/scripts/install-rdc-skills.js +1289 -1289
  92. package/scripts/install.ps1 +202 -202
  93. package/scripts/install.sh +132 -132
  94. package/scripts/lib/assertions.mjs +287 -287
  95. package/scripts/lib/manifest-schema.mjs +754 -754
  96. package/scripts/lib/runner.mjs +465 -465
  97. package/scripts/lib/sandbox.mjs +435 -435
  98. package/scripts/prepack.mjs +32 -32
  99. package/scripts/rdc-brochure.mjs +482 -464
  100. package/scripts/rdc-design-cli.mjs +134 -134
  101. package/scripts/rebuild-mcp.mjs +107 -107
  102. package/scripts/self-test.mjs +1460 -1460
  103. package/scripts/stamp-git-sha.mjs +29 -29
  104. package/scripts/test-guide-validator.mjs +196 -196
  105. package/scripts/test-rdc-hooks.mjs +145 -145
  106. package/scripts/uninstall.ps1 +77 -77
  107. package/scripts/uninstall.sh +69 -69
  108. package/scripts/update.ps1 +43 -43
  109. package/scripts/update.sh +43 -43
  110. package/scripts/validate-place-histories.js +461 -461
  111. package/scripts/validate-publish-manifests.js +424 -424
  112. package/scripts/watch-init.mjs +100 -100
  113. package/skills/brochure/SKILL.md +107 -107
  114. package/skills/build/SKILL.md +563 -563
  115. package/skills/channel-formatter/SKILL.md +533 -533
  116. package/skills/co-develop/SKILL.md +196 -196
  117. package/skills/collab/SKILL.md +239 -239
  118. package/skills/convert/SKILL.md +140 -140
  119. package/skills/deploy/SKILL.md +541 -541
  120. package/skills/design/SKILL.md +211 -211
  121. package/skills/design/reference/ownership.md +16 -16
  122. package/skills/design/reference/rampa.md +92 -92
  123. package/skills/design/reference/studio-model.md +153 -153
  124. package/skills/edit/SKILL.md +98 -98
  125. package/skills/fixit/SKILL.md +165 -165
  126. package/skills/fs-mcp/SKILL.md +148 -148
  127. package/skills/handoff/SKILL.md +236 -200
  128. package/skills/help/SKILL.md +143 -143
  129. package/skills/housekeeping/SKILL.md +219 -160
  130. package/skills/lifeai-brochure-author/SKILL.md +340 -340
  131. package/skills/overnight/SKILL.md +251 -251
  132. package/skills/plan/SKILL.md +345 -345
  133. package/skills/preplan/SKILL.md +90 -90
  134. package/skills/prototype/SKILL.md +150 -150
  135. package/skills/rdc-brochurify/SKILL.md +245 -245
  136. package/skills/rdc-extract-verifier-rules/SKILL.md +191 -191
  137. package/skills/release/SKILL.md +140 -140
  138. package/skills/report/SKILL.md +100 -100
  139. package/skills/review/SKILL.md +152 -152
  140. package/skills/rpms-filemap/SKILL.cloud.md +111 -111
  141. package/skills/rpms-filemap/SKILL.md +111 -111
  142. package/skills/self-test/SKILL.md +132 -132
  143. package/skills/status/SKILL.md +99 -99
  144. package/skills/terminal-config/SKILL.md +62 -62
  145. package/skills/tests/MATRIX.md +54 -54
  146. package/skills/tests/README.md +47 -47
  147. package/skills/tests/rdc-brochure.test.json +34 -34
  148. package/skills/tests/rdc-build.test.json +36 -36
  149. package/skills/tests/rdc-channel-formatter.test.json +45 -45
  150. package/skills/tests/rdc-co-develop.test.json +29 -29
  151. package/skills/tests/rdc-collab.test.json +29 -29
  152. package/skills/tests/rdc-convert.test.json +35 -35
  153. package/skills/tests/rdc-deploy.test.json +30 -30
  154. package/skills/tests/rdc-design.test.json +27 -27
  155. package/skills/tests/rdc-edit.test.json +29 -29
  156. package/skills/tests/rdc-fixit.test.json +36 -36
  157. package/skills/tests/rdc-fs-mcp.test.json +36 -36
  158. package/skills/tests/rdc-handoff.test.json +28 -28
  159. package/skills/tests/rdc-help.test.json +29 -29
  160. package/skills/tests/rdc-housekeeping.test.json +32 -28
  161. package/skills/tests/rdc-lifeai-brochure-author.test.json +35 -35
  162. package/skills/tests/rdc-overnight.test.json +37 -37
  163. package/skills/tests/rdc-plan.test.json +27 -27
  164. package/skills/tests/rdc-preplan.test.json +31 -31
  165. package/skills/tests/rdc-prototype.test.json +28 -28
  166. package/skills/tests/rdc-rdc-brochurify.test.json +23 -23
  167. package/skills/tests/rdc-rdc-extract-verifier-rules.test.json +34 -34
  168. package/skills/tests/rdc-release.test.json +29 -29
  169. package/skills/tests/rdc-report.test.json +28 -28
  170. package/skills/tests/rdc-review.test.json +29 -29
  171. package/skills/tests/rdc-rpms-filemap.test.json +28 -28
  172. package/skills/tests/rdc-self-test.test.json +24 -24
  173. package/skills/tests/rdc-status.test.json +29 -29
  174. package/skills/tests/rdc-terminal-config.test.json +29 -29
  175. package/skills/tests/rdc-watch.test.json +24 -24
  176. package/skills/tests/rdc-workitems.test.json +27 -27
  177. package/skills/watch/SKILL.md +97 -97
  178. package/skills/workitems/SKILL.md +151 -151
  179. package/tests/acceptance.test.mjs +59 -59
  180. package/tests/channel-formatter.contract.test.mjs +251 -251
  181. package/tests/curl-surface.test.mjs +289 -289
  182. package/tests/harness-gates.test.mjs +325 -325
  183. package/tests/help-surface.test.mjs +61 -61
  184. package/tests/housekeeping-lessons-triage.test.mjs +49 -0
  185. package/tests/install-rdc-skills.test.mjs +49 -49
  186. package/tests/lessons-pipeline-contract.test.mjs +26 -0
  187. package/tests/manifest-contract-fields.test.mjs +78 -78
  188. package/tests/mcp.test.mjs +271 -271
  189. package/tests/rdc-brochure.test.mjs +125 -0
  190. package/tests/release-contract.test.mjs +16 -0
  191. package/tests/require-work-item-on-commit.test.mjs +162 -162
  192. package/tests/run-evidence-gate.test.mjs +82 -82
  193. package/tests/skill-test-matrix.test.mjs +66 -66
  194. package/tests/validate-skills.js +27 -27
  195. package/tests/work-item-exit-gate-l2.test.mjs +368 -368
  196. package/tests/work-item-exit-gate-l3.test.mjs +197 -197
@@ -1,97 +1,97 @@
1
- ---
2
- name: rdc:watch
3
- description: "Usage `rdc:watch` — Initialize a live session-log viewer and report its path; open it only during attended, non-test use. Zero infrastructure — pure filesystem + static HTML."
4
- ---
5
-
6
- > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
7
- > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
8
- > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
9
-
10
- > If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
11
-
12
-
13
- # rdc:watch — Session Log Watcher
14
-
15
- ## When to Use
16
- - Start of any long-running session where Dave needs visibility into what you're doing
17
- - Before `rdc:overnight`, `rdc:build` on a large epic, or any multi-hour grind
18
- - Anytime the user asks for "a log", "a viewer", "tail", or "what are you doing right now"
19
-
20
- ## Procedure
21
-
22
- 1. **Initialize the log and viewer.** Run the helper script from the plugin directory in the user's current project:
23
- ```bash
24
- node ${CLAUDE_PLUGIN_ROOT}/scripts/watch-init.mjs
25
- ```
26
- (If `CLAUDE_PLUGIN_ROOT` is not set, resolve the plugin path from your invocation context or the installed plugin cache.)
27
-
28
- 2. **Parse the output.** The script prints `run_id`, `log_path`, `current`, `viewer`, and `open_hint`. Capture `log_path` and `viewer` for the rest of the session.
29
-
30
- 3. **Open the viewer in the browser, unless running under `RDC_TEST=1`.**
31
- - Normal attended use: run the exact `open_hint` line from the script output. On Windows that's `start "" "<viewer-path>"`.
32
- - `RDC_TEST=1`: do not run `open_hint`, `start`, `open`, `xdg-open`, or any focus/window API. Report the viewer path only.
33
-
34
- 4. **Report to the user.** One line:
35
- ```
36
- watcher live at <viewer-path> — tailing <log-path>
37
- ```
38
- In `RDC_TEST=1`, say:
39
- ```
40
- watcher initialized at <viewer-path> — not opened because RDC_TEST=1
41
- ```
42
-
43
- 5. **Append one line per substantive action for the rest of the session.** Use the documented format — one line, no multi-line payloads:
44
- ```
45
- [<ISO-timestamp>] [<kind>] <message>
46
- ```
47
- Append to BOTH `<log-path>` (the full history) AND `current.log` (what the viewer polls). The viewer diffs `current.log` by length and only appends new lines.
48
-
49
- ### Log format
50
-
51
- - `ISO-timestamp` — `new Date().toISOString()`
52
- - `kind` — one of: `dispatch`, `commit`, `test`, `error`, `note`, `banner`
53
- - `message` — single line, no newlines. Keep under ~200 chars.
54
-
55
- ### Kinds
56
-
57
- | Kind | When to append |
58
- |------|----------------|
59
- | `dispatch` | About to dispatch a subagent — include role + epic/task id |
60
- | `commit` | After a git commit lands — include short sha + subject |
61
- | `test` | Test run kicked off or result came back |
62
- | `error` | Anything that failed — include what and why in one line |
63
- | `note` | General progress ticks (reading files, analyzing, planning) |
64
- | `banner` | Session start/end markers, major phase changes |
65
-
66
- ### Examples
67
-
68
- ```
69
- [2026-04-15T23:14:02.318Z] [dispatch] frontend agent → epic abc123 task 4 (rebuild DynamicForm)
70
- [2026-04-15T23:17:41.902Z] [commit] 3f2a1b9 feat(marketing-engine): DynamicForm rhf+zod
71
- [2026-04-15T23:18:05.113Z] [test] pnpm --filter @regen/rdc-marketing-engine test
72
- [2026-04-15T23:18:41.002Z] [error] tsc: src/components/Form.tsx:42 — Property 'foo' does not exist
73
- [2026-04-15T23:19:00.000Z] [note] retrying with corrected type import
74
- [2026-04-15T23:45:10.000Z] [banner] Phase 2 complete — moving to review
75
- ```
76
-
77
- ### Appending from bash (Windows-safe)
78
-
79
- ```bash
80
- printf '[%s] [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" "dispatch" "your message" >> "$LOG_PATH"
81
- printf '[%s] [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" "dispatch" "your message" >> "$CURRENT_PATH"
82
- ```
83
-
84
- Or from Node:
85
- ```js
86
- import { appendFileSync } from "node:fs";
87
- const line = `[${new Date().toISOString()}] [note] ${msg}\n`;
88
- appendFileSync(logPath, line);
89
- appendFileSync(currentPath, line);
90
- ```
91
-
92
- ## Notes
93
-
94
- - Log files live in the **user's project**, not the rdc-skills repo. Path: `<projectRoot>/.rdc/session-log/`
95
- - Each invocation creates a **new run id** and overwrites `current.log`. Prior run logs remain on disk as `<runId>.log`.
96
- - The viewer is a single static HTML file polling `current.log` via `fetch()` every 2s — no server, no deps.
97
- - This skill does NOT replace `rdc:report` (the end-of-session Obsidian writeup). It's a live tail for attended or semi-attended sessions.
1
+ ---
2
+ name: rdc:watch
3
+ description: "Usage `rdc:watch` — Initialize a live session-log viewer and report its path; open it only during attended, non-test use. Zero infrastructure — pure filesystem + static HTML."
4
+ ---
5
+
6
+ > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
7
+ > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
8
+ > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
9
+
10
+ > If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
11
+
12
+
13
+ # rdc:watch — Session Log Watcher
14
+
15
+ ## When to Use
16
+ - Start of any long-running session where Dave needs visibility into what you're doing
17
+ - Before `rdc:overnight`, `rdc:build` on a large epic, or any multi-hour grind
18
+ - Anytime the user asks for "a log", "a viewer", "tail", or "what are you doing right now"
19
+
20
+ ## Procedure
21
+
22
+ 1. **Initialize the log and viewer.** Run the helper script from the plugin directory in the user's current project:
23
+ ```bash
24
+ node ${CLAUDE_PLUGIN_ROOT}/scripts/watch-init.mjs
25
+ ```
26
+ (If `CLAUDE_PLUGIN_ROOT` is not set, resolve the plugin path from your invocation context or the installed plugin cache.)
27
+
28
+ 2. **Parse the output.** The script prints `run_id`, `log_path`, `current`, `viewer`, and `open_hint`. Capture `log_path` and `viewer` for the rest of the session.
29
+
30
+ 3. **Open the viewer in the browser, unless running under `RDC_TEST=1`.**
31
+ - Normal attended use: run the exact `open_hint` line from the script output. On Windows that's `start "" "<viewer-path>"`.
32
+ - `RDC_TEST=1`: do not run `open_hint`, `start`, `open`, `xdg-open`, or any focus/window API. Report the viewer path only.
33
+
34
+ 4. **Report to the user.** One line:
35
+ ```
36
+ watcher live at <viewer-path> — tailing <log-path>
37
+ ```
38
+ In `RDC_TEST=1`, say:
39
+ ```
40
+ watcher initialized at <viewer-path> — not opened because RDC_TEST=1
41
+ ```
42
+
43
+ 5. **Append one line per substantive action for the rest of the session.** Use the documented format — one line, no multi-line payloads:
44
+ ```
45
+ [<ISO-timestamp>] [<kind>] <message>
46
+ ```
47
+ Append to BOTH `<log-path>` (the full history) AND `current.log` (what the viewer polls). The viewer diffs `current.log` by length and only appends new lines.
48
+
49
+ ### Log format
50
+
51
+ - `ISO-timestamp` — `new Date().toISOString()`
52
+ - `kind` — one of: `dispatch`, `commit`, `test`, `error`, `note`, `banner`
53
+ - `message` — single line, no newlines. Keep under ~200 chars.
54
+
55
+ ### Kinds
56
+
57
+ | Kind | When to append |
58
+ |------|----------------|
59
+ | `dispatch` | About to dispatch a subagent — include role + epic/task id |
60
+ | `commit` | After a git commit lands — include short sha + subject |
61
+ | `test` | Test run kicked off or result came back |
62
+ | `error` | Anything that failed — include what and why in one line |
63
+ | `note` | General progress ticks (reading files, analyzing, planning) |
64
+ | `banner` | Session start/end markers, major phase changes |
65
+
66
+ ### Examples
67
+
68
+ ```
69
+ [2026-04-15T23:14:02.318Z] [dispatch] frontend agent → epic abc123 task 4 (rebuild DynamicForm)
70
+ [2026-04-15T23:17:41.902Z] [commit] 3f2a1b9 feat(marketing-engine): DynamicForm rhf+zod
71
+ [2026-04-15T23:18:05.113Z] [test] pnpm --filter @regen/rdc-marketing-engine test
72
+ [2026-04-15T23:18:41.002Z] [error] tsc: src/components/Form.tsx:42 — Property 'foo' does not exist
73
+ [2026-04-15T23:19:00.000Z] [note] retrying with corrected type import
74
+ [2026-04-15T23:45:10.000Z] [banner] Phase 2 complete — moving to review
75
+ ```
76
+
77
+ ### Appending from bash (Windows-safe)
78
+
79
+ ```bash
80
+ printf '[%s] [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" "dispatch" "your message" >> "$LOG_PATH"
81
+ printf '[%s] [%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" "dispatch" "your message" >> "$CURRENT_PATH"
82
+ ```
83
+
84
+ Or from Node:
85
+ ```js
86
+ import { appendFileSync } from "node:fs";
87
+ const line = `[${new Date().toISOString()}] [note] ${msg}\n`;
88
+ appendFileSync(logPath, line);
89
+ appendFileSync(currentPath, line);
90
+ ```
91
+
92
+ ## Notes
93
+
94
+ - Log files live in the **user's project**, not the rdc-skills repo. Path: `<projectRoot>/.rdc/session-log/`
95
+ - Each invocation creates a **new run id** and overwrites `current.log`. Prior run logs remain on disk as `<runId>.log`.
96
+ - The viewer is a single static HTML file polling `current.log` via `fetch()` every 2s — no server, no deps.
97
+ - This skill does NOT replace `rdc:report` (the end-of-session Obsidian writeup). It's a live tail for attended or semi-attended sessions.
@@ -1,151 +1,151 @@
1
- ---
2
- name: rdc:workitems
3
- description: "Usage `rdc:workitems [add|done|status|list|query]` — Manual work item CRUD outside the normal build flow: add to backlog, mark done, update status, list open epics, query by label."
4
- ---
5
-
6
- > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
7
- > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
8
- > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
9
-
10
- > If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
11
-
12
- > **Sandbox contract:** This skill honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag. Supabase work item writes (`insert_work_item`, `update_work_item_status`, `bump_epic_version`) are skipped under `RDC_TEST=1`.
13
-
14
-
15
- # rdc:workitems — Work Item Management
16
-
17
- ## When to Use
18
- - Project lead says "create a ticket", "add to backlog", "log this bug", "update status"
19
- - An agent needs to create or update epics/tasks during a build session
20
- - Checking what work is open before starting a new epic
21
-
22
- ## Arguments
23
-
24
- - `rdc:workitems epics` — list open epics
25
- - `rdc:workitems add <title> --epic <id>` — create a task under an epic
26
- - `rdc:workitems update <id> --status <status>` — update a work item's status
27
- - `rdc:workitems done <id>` — mark a task complete
28
- - `rdc:workitems list <epic-id>` — list tasks in an epic
29
-
30
- ## Rules
31
-
32
- 1. **Epic first, always.** Never create a task without a parent epic.
33
- 2. **Label everything.** Minimum one system label per item.
34
- 3. **Check first.** `get_open_epics()` before creating anything new.
35
- 4. **Link design docs.** Put `.rdc/plans/` or `.rdc/research/` paths in descriptions (fallback: `.rdc/plans/` / `.rdc/research/`).
36
-
37
- ## Read Epics
38
-
39
- ```sql
40
- SELECT get_open_epics();
41
- SELECT get_open_epics('urgent');
42
- SELECT get_open_epics(p_label_filter := 'custom-label');
43
- ```
44
-
45
- ## Create Epic
46
-
47
- ```sql
48
- SELECT insert_work_item(
49
- p_title := 'EPIC: Clear descriptive title',
50
- p_description := 'What and why. Reference .rdc/plans/<n>.md if applicable.',
51
- p_item_type := 'epic',
52
- p_priority := 'high',
53
- p_labels := ARRAY['system-label'],
54
- p_source := 'planning'
55
- );
56
- ```
57
-
58
- ## Create Task
59
-
60
- ```sql
61
- SELECT insert_work_item(
62
- p_title := 'Specific actionable task title',
63
- p_description := 'What: <deliverable>
64
- Where: <files to create/modify>
65
- Agent type: frontend | backend | data | design | infra | content | cs2
66
- Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
67
- Design doc: .rdc/plans/<n>.md (fallback: .rdc/plans/<n>.md, if exists)
68
- Depends on: <other task title if sequential>
69
- Est: <hours>',
70
- p_parent_id := '<epic-uuid>'::uuid,
71
- p_item_type := 'task',
72
- p_priority := 'high',
73
- p_labels := ARRAY['system-label'],
74
- p_estimated_hours := 2,
75
- p_source := 'planning'
76
- );
77
- ```
78
-
79
- ## Update Status
80
-
81
- ```sql
82
- SELECT update_work_item_status('<uuid>'::uuid, 'in_progress');
83
- SELECT update_work_item_status('<uuid>'::uuid, 'review', '["Implementation complete; ready for validator"]'::jsonb, '<agent-session-id>', 'agent');
84
- SELECT update_work_item_status('<uuid>'::uuid, 'done', '["Validator verified implementation report, CodeFlow post, and checklist evidence"]'::jsonb, '<validator-session-id>', 'validator');
85
- SELECT update_work_item_status('<uuid>'::uuid, 'blocked', '["Why it is blocked"]'::jsonb);
86
- ```
87
-
88
- Non-epic `done` is a validator-only close and requires an existing
89
- `implementation_report.codeflow_post`, checked required checklist evidence, and
90
- originating-agent tick audit.
91
-
92
- ## Read Tasks in an Epic
93
-
94
- ```sql
95
- SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
96
- SELECT get_work_items_by_epic('<epic-uuid>'::uuid, 'todo');
97
- ```
98
-
99
- ## Bump Epic Version
100
-
101
- ```sql
102
- SELECT bump_epic_version('<epic-uuid>'::uuid, '0.2.0', 'What changed', 'planning');
103
- ```
104
-
105
- ## Valid Values
106
-
107
- | Field | Values |
108
- |-------|--------|
109
- | status | `todo` `in_progress` `blocked` `review` `done` `archived` |
110
- | priority | `urgent` `high` `normal` `low` |
111
- | item_type | `epic` `task` `subtask` `bug` `spike` |
112
-
113
- ## System Labels
114
-
115
- | Label | When |
116
- |-------|------|
117
- | `project-a` | Your-app-specific work |
118
- | `project-b` | Another app work |
119
- | `cs2` | Core paradigm packages |
120
- | `hail` | Grammar, DSL compiler |
121
- | `pal` | Moment windows, memory |
122
- | `virtue` | Virtue engine, coherence |
123
- | `marketing` | Outreach, campaigns |
124
- | `media` | Assets, R2, image pipeline |
125
- | `infrastructure` | CI/CD, deployment |
126
- | `ui` | Component library |
127
- | `data` | Schema, migrations |
128
- | `content` | Copy, messaging |
129
- | `website` | Public-facing sites |
130
-
131
- ## Agent Type → Guide File Reference
132
-
133
- | Type | Guide | Use For |
134
- |------|-------|---------|
135
- | `frontend` | .rdc/guides/frontend.md | React, pages, UI, Tailwind |
136
- | `backend` | .rdc/guides/backend.md | API routes, database, auth |
137
- | `data` | .rdc/guides/data.md | Migrations, schema, RPC |
138
- | `design` | .rdc/guides/design.md | Brand, palette, OG images |
139
- | `infra` | .rdc/guides/infrastructure.md | CI/CD, deploy, DNS |
140
- | `content` | .rdc/guides/content.md | Copy, messaging, tone |
141
- | `cs2` | .rdc/guides/cs2.md | CS 2.0 paradigm |
142
- | `hail` | .rdc/guides/cs2.md + packages/hail/CLAUDE.md | Grammar, DSL |
143
- | `viz` | .rdc/guides/frontend.md + design.md | Custom visualizations |
144
-
145
- ## What NOT to Do
146
-
147
- - Never raw INSERT/UPDATE against work items — RPC functions only
148
- - Never create tasks without a parent epic
149
- - Never leave labels empty
150
- - Never write vague titles ("Fix stuff") — be specific
151
- - Never put design intention in the task — put it in `.rdc/research/` (fallback: `.rdc/research/`) and link
1
+ ---
2
+ name: rdc:workitems
3
+ description: "Usage `rdc:workitems [add|done|status|list|query]` — Manual work item CRUD outside the normal build flow: add to backlog, mark done, update status, list open epics, query by label."
4
+ ---
5
+
6
+ > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
7
+ > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
8
+ > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
9
+
10
+ > If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
11
+
12
+ > **Sandbox contract:** This skill honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag. Supabase work item writes (`insert_work_item`, `update_work_item_status`, `bump_epic_version`) are skipped under `RDC_TEST=1`.
13
+
14
+
15
+ # rdc:workitems — Work Item Management
16
+
17
+ ## When to Use
18
+ - Project lead says "create a ticket", "add to backlog", "log this bug", "update status"
19
+ - An agent needs to create or update epics/tasks during a build session
20
+ - Checking what work is open before starting a new epic
21
+
22
+ ## Arguments
23
+
24
+ - `rdc:workitems epics` — list open epics
25
+ - `rdc:workitems add <title> --epic <id>` — create a task under an epic
26
+ - `rdc:workitems update <id> --status <status>` — update a work item's status
27
+ - `rdc:workitems done <id>` — mark a task complete
28
+ - `rdc:workitems list <epic-id>` — list tasks in an epic
29
+
30
+ ## Rules
31
+
32
+ 1. **Epic first, always.** Never create a task without a parent epic.
33
+ 2. **Label everything.** Minimum one system label per item.
34
+ 3. **Check first.** `get_open_epics()` before creating anything new.
35
+ 4. **Link design docs.** Put `.rdc/plans/` or `.rdc/research/` paths in descriptions (fallback: `.rdc/plans/` / `.rdc/research/`).
36
+
37
+ ## Read Epics
38
+
39
+ ```sql
40
+ SELECT get_open_epics();
41
+ SELECT get_open_epics('urgent');
42
+ SELECT get_open_epics(p_label_filter := 'custom-label');
43
+ ```
44
+
45
+ ## Create Epic
46
+
47
+ ```sql
48
+ SELECT insert_work_item(
49
+ p_title := 'EPIC: Clear descriptive title',
50
+ p_description := 'What and why. Reference .rdc/plans/<n>.md if applicable.',
51
+ p_item_type := 'epic',
52
+ p_priority := 'high',
53
+ p_labels := ARRAY['system-label'],
54
+ p_source := 'planning'
55
+ );
56
+ ```
57
+
58
+ ## Create Task
59
+
60
+ ```sql
61
+ SELECT insert_work_item(
62
+ p_title := 'Specific actionable task title',
63
+ p_description := 'What: <deliverable>
64
+ Where: <files to create/modify>
65
+ Agent type: frontend | backend | data | design | infra | content | cs2
66
+ Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
67
+ Design doc: .rdc/plans/<n>.md (fallback: .rdc/plans/<n>.md, if exists)
68
+ Depends on: <other task title if sequential>
69
+ Est: <hours>',
70
+ p_parent_id := '<epic-uuid>'::uuid,
71
+ p_item_type := 'task',
72
+ p_priority := 'high',
73
+ p_labels := ARRAY['system-label'],
74
+ p_estimated_hours := 2,
75
+ p_source := 'planning'
76
+ );
77
+ ```
78
+
79
+ ## Update Status
80
+
81
+ ```sql
82
+ SELECT update_work_item_status('<uuid>'::uuid, 'in_progress');
83
+ SELECT update_work_item_status('<uuid>'::uuid, 'review', '["Implementation complete; ready for validator"]'::jsonb, '<agent-session-id>', 'agent');
84
+ SELECT update_work_item_status('<uuid>'::uuid, 'done', '["Validator verified implementation report, CodeFlow post, and checklist evidence"]'::jsonb, '<validator-session-id>', 'validator');
85
+ SELECT update_work_item_status('<uuid>'::uuid, 'blocked', '["Why it is blocked"]'::jsonb);
86
+ ```
87
+
88
+ Non-epic `done` is a validator-only close and requires an existing
89
+ `implementation_report.codeflow_post`, checked required checklist evidence, and
90
+ originating-agent tick audit.
91
+
92
+ ## Read Tasks in an Epic
93
+
94
+ ```sql
95
+ SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
96
+ SELECT get_work_items_by_epic('<epic-uuid>'::uuid, 'todo');
97
+ ```
98
+
99
+ ## Bump Epic Version
100
+
101
+ ```sql
102
+ SELECT bump_epic_version('<epic-uuid>'::uuid, '0.2.0', 'What changed', 'planning');
103
+ ```
104
+
105
+ ## Valid Values
106
+
107
+ | Field | Values |
108
+ |-------|--------|
109
+ | status | `todo` `in_progress` `blocked` `review` `done` `archived` |
110
+ | priority | `urgent` `high` `normal` `low` |
111
+ | item_type | `epic` `task` `subtask` `bug` `spike` |
112
+
113
+ ## System Labels
114
+
115
+ | Label | When |
116
+ |-------|------|
117
+ | `project-a` | Your-app-specific work |
118
+ | `project-b` | Another app work |
119
+ | `cs2` | Core paradigm packages |
120
+ | `hail` | Grammar, DSL compiler |
121
+ | `pal` | Moment windows, memory |
122
+ | `virtue` | Virtue engine, coherence |
123
+ | `marketing` | Outreach, campaigns |
124
+ | `media` | Assets, R2, image pipeline |
125
+ | `infrastructure` | CI/CD, deployment |
126
+ | `ui` | Component library |
127
+ | `data` | Schema, migrations |
128
+ | `content` | Copy, messaging |
129
+ | `website` | Public-facing sites |
130
+
131
+ ## Agent Type → Guide File Reference
132
+
133
+ | Type | Guide | Use For |
134
+ |------|-------|---------|
135
+ | `frontend` | .rdc/guides/frontend.md | React, pages, UI, Tailwind |
136
+ | `backend` | .rdc/guides/backend.md | API routes, database, auth |
137
+ | `data` | .rdc/guides/data.md | Migrations, schema, RPC |
138
+ | `design` | .rdc/guides/design.md | Brand, palette, OG images |
139
+ | `infra` | .rdc/guides/infrastructure.md | CI/CD, deploy, DNS |
140
+ | `content` | .rdc/guides/content.md | Copy, messaging, tone |
141
+ | `cs2` | .rdc/guides/cs2.md | CS 2.0 paradigm |
142
+ | `hail` | .rdc/guides/cs2.md + packages/hail/CLAUDE.md | Grammar, DSL |
143
+ | `viz` | .rdc/guides/frontend.md + design.md | Custom visualizations |
144
+
145
+ ## What NOT to Do
146
+
147
+ - Never raw INSERT/UPDATE against work items — RPC functions only
148
+ - Never create tasks without a parent epic
149
+ - Never leave labels empty
150
+ - Never write vague titles ("Fix stuff") — be specific
151
+ - Never put design intention in the task — put it in `.rdc/research/` (fallback: `.rdc/research/`) and link
@@ -1,59 +1,59 @@
1
- #!/usr/bin/env node
2
- import assert from 'node:assert/strict';
3
- import { spawnSync } from 'node:child_process';
4
- import { mkdtempSync, rmSync } from 'node:fs';
5
- import { tmpdir } from 'node:os';
6
- import { join, resolve } from 'node:path';
7
- import { fileURLToPath } from 'node:url';
8
- import { dirname } from 'node:path';
9
-
10
- const __dirname = dirname(fileURLToPath(import.meta.url));
11
- const REPO_ROOT = resolve(__dirname, '..');
12
- const script = join(REPO_ROOT, 'scripts', 'acceptance.mjs');
13
- const { codexToolCalls, normalizeSkillName } = await import(`file://${script.replace(/\\/g, '/')}`);
14
-
15
- const syntax = spawnSync(process.execPath, ['--check', script], { encoding: 'utf8' });
16
- assert.equal(syntax.status, 0, syntax.stderr);
17
-
18
- const codexEvents = [
19
- {
20
- type: 'item.started',
21
- item: {
22
- type: 'command_execution',
23
- command: 'pwsh -Command "rg -n regenerative C:/Dev/local-corpus"',
24
- },
25
- },
26
- ].map((event) => JSON.stringify(event)).join('\n');
27
- const parsedCalls = codexToolCalls(codexEvents);
28
- assert.equal(parsedCalls[0]?.name, 'Grep');
29
- assert.match(parsedCalls[0]?.input?.command || '', /local-corpus/);
30
- assert.equal(normalizeSkillName('lifeai-brochure-author'), 'lifeai-brochure-author');
31
- assert.equal(normalizeSkillName('build'), 'rdc:build');
32
-
33
- const missing = spawnSync(process.execPath, [script, '--skill', 'rdc:not-a-real-skill'], {
34
- cwd: REPO_ROOT,
35
- encoding: 'utf8',
36
- });
37
- assert.equal(missing.status, 1);
38
- assert.match(missing.stderr, /missing acceptance manifest/);
39
-
40
- const codex = spawnSync(process.execPath, [script, '--engine', 'codex', '--skill', 'rdc:not-a-real-skill'], {
41
- cwd: REPO_ROOT,
42
- encoding: 'utf8',
43
- });
44
- assert.equal(codex.status, 1);
45
- assert.doesNotMatch(codex.stderr, /not wired/i);
46
- assert.match(codex.stderr, /missing acceptance manifest/);
47
-
48
- const emptyProject = mkdtempSync(join(tmpdir(), 'rdc-acceptance-empty-'));
49
- try {
50
- const none = spawnSync(process.execPath, [script, '--changed', '--base', 'HEAD', '--project-root', emptyProject], {
51
- cwd: REPO_ROOT,
52
- encoding: 'utf8',
53
- });
54
- assert.notEqual(none.status, 0);
55
- } finally {
56
- rmSync(emptyProject, { recursive: true, force: true });
57
- }
58
-
59
- console.log('acceptance tests — PASS');
1
+ #!/usr/bin/env node
2
+ import assert from 'node:assert/strict';
3
+ import { spawnSync } from 'node:child_process';
4
+ import { mkdtempSync, rmSync } from 'node:fs';
5
+ import { tmpdir } from 'node:os';
6
+ import { join, resolve } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+ import { dirname } from 'node:path';
9
+
10
+ const __dirname = dirname(fileURLToPath(import.meta.url));
11
+ const REPO_ROOT = resolve(__dirname, '..');
12
+ const script = join(REPO_ROOT, 'scripts', 'acceptance.mjs');
13
+ const { codexToolCalls, normalizeSkillName } = await import(`file://${script.replace(/\\/g, '/')}`);
14
+
15
+ const syntax = spawnSync(process.execPath, ['--check', script], { encoding: 'utf8' });
16
+ assert.equal(syntax.status, 0, syntax.stderr);
17
+
18
+ const codexEvents = [
19
+ {
20
+ type: 'item.started',
21
+ item: {
22
+ type: 'command_execution',
23
+ command: 'pwsh -Command "rg -n regenerative C:/Dev/local-corpus"',
24
+ },
25
+ },
26
+ ].map((event) => JSON.stringify(event)).join('\n');
27
+ const parsedCalls = codexToolCalls(codexEvents);
28
+ assert.equal(parsedCalls[0]?.name, 'Grep');
29
+ assert.match(parsedCalls[0]?.input?.command || '', /local-corpus/);
30
+ assert.equal(normalizeSkillName('lifeai-brochure-author'), 'lifeai-brochure-author');
31
+ assert.equal(normalizeSkillName('build'), 'rdc:build');
32
+
33
+ const missing = spawnSync(process.execPath, [script, '--skill', 'rdc:not-a-real-skill'], {
34
+ cwd: REPO_ROOT,
35
+ encoding: 'utf8',
36
+ });
37
+ assert.equal(missing.status, 1);
38
+ assert.match(missing.stderr, /missing acceptance manifest/);
39
+
40
+ const codex = spawnSync(process.execPath, [script, '--engine', 'codex', '--skill', 'rdc:not-a-real-skill'], {
41
+ cwd: REPO_ROOT,
42
+ encoding: 'utf8',
43
+ });
44
+ assert.equal(codex.status, 1);
45
+ assert.doesNotMatch(codex.stderr, /not wired/i);
46
+ assert.match(codex.stderr, /missing acceptance manifest/);
47
+
48
+ const emptyProject = mkdtempSync(join(tmpdir(), 'rdc-acceptance-empty-'));
49
+ try {
50
+ const none = spawnSync(process.execPath, [script, '--changed', '--base', 'HEAD', '--project-root', emptyProject], {
51
+ cwd: REPO_ROOT,
52
+ encoding: 'utf8',
53
+ });
54
+ assert.notEqual(none.status, 0);
55
+ } finally {
56
+ rmSync(emptyProject, { recursive: true, force: true });
57
+ }
58
+
59
+ console.log('acceptance tests — PASS');