@lifeaitools/rdc-skills 0.24.38 → 0.24.39

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 (191) 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 +377 -377
  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 +124 -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 +153 -153
  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 +56 -56
  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 +1289 -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 +464 -464
  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 +424 -424
  111. package/scripts/watch-init.mjs +100 -100
  112. package/skills/brochure/SKILL.md +107 -107
  113. package/skills/build/SKILL.md +563 -563
  114. package/skills/channel-formatter/SKILL.md +533 -533
  115. package/skills/co-develop/SKILL.md +196 -196
  116. package/skills/collab/SKILL.md +239 -239
  117. package/skills/convert/SKILL.md +140 -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/fixit/SKILL.md +165 -165
  125. package/skills/fs-mcp/SKILL.md +148 -148
  126. package/skills/handoff/SKILL.md +236 -200
  127. package/skills/help/SKILL.md +143 -143
  128. package/skills/housekeeping/SKILL.md +189 -189
  129. package/skills/lifeai-brochure-author/SKILL.md +340 -340
  130. package/skills/overnight/SKILL.md +251 -251
  131. package/skills/plan/SKILL.md +345 -345
  132. package/skills/preplan/SKILL.md +90 -90
  133. package/skills/prototype/SKILL.md +150 -150
  134. package/skills/rdc-brochurify/SKILL.md +245 -245
  135. package/skills/rdc-extract-verifier-rules/SKILL.md +191 -191
  136. package/skills/release/SKILL.md +140 -140
  137. package/skills/report/SKILL.md +100 -100
  138. package/skills/review/SKILL.md +152 -152
  139. package/skills/rpms-filemap/SKILL.cloud.md +111 -111
  140. package/skills/rpms-filemap/SKILL.md +111 -111
  141. package/skills/self-test/SKILL.md +132 -132
  142. package/skills/status/SKILL.md +99 -99
  143. package/skills/terminal-config/SKILL.md +62 -62
  144. package/skills/tests/MATRIX.md +54 -54
  145. package/skills/tests/README.md +47 -47
  146. package/skills/tests/rdc-brochure.test.json +34 -34
  147. package/skills/tests/rdc-build.test.json +36 -36
  148. package/skills/tests/rdc-channel-formatter.test.json +45 -45
  149. package/skills/tests/rdc-co-develop.test.json +29 -29
  150. package/skills/tests/rdc-collab.test.json +29 -29
  151. package/skills/tests/rdc-convert.test.json +35 -35
  152. package/skills/tests/rdc-deploy.test.json +30 -30
  153. package/skills/tests/rdc-design.test.json +27 -27
  154. package/skills/tests/rdc-edit.test.json +29 -29
  155. package/skills/tests/rdc-fixit.test.json +36 -36
  156. package/skills/tests/rdc-fs-mcp.test.json +36 -36
  157. package/skills/tests/rdc-handoff.test.json +28 -28
  158. package/skills/tests/rdc-help.test.json +29 -29
  159. package/skills/tests/rdc-housekeeping.test.json +31 -31
  160. package/skills/tests/rdc-lifeai-brochure-author.test.json +35 -35
  161. package/skills/tests/rdc-overnight.test.json +37 -37
  162. package/skills/tests/rdc-plan.test.json +27 -27
  163. package/skills/tests/rdc-preplan.test.json +31 -31
  164. package/skills/tests/rdc-prototype.test.json +28 -28
  165. package/skills/tests/rdc-rdc-brochurify.test.json +23 -23
  166. package/skills/tests/rdc-rdc-extract-verifier-rules.test.json +34 -34
  167. package/skills/tests/rdc-release.test.json +29 -29
  168. package/skills/tests/rdc-report.test.json +28 -28
  169. package/skills/tests/rdc-review.test.json +29 -29
  170. package/skills/tests/rdc-rpms-filemap.test.json +28 -28
  171. package/skills/tests/rdc-self-test.test.json +24 -24
  172. package/skills/tests/rdc-status.test.json +29 -29
  173. package/skills/tests/rdc-terminal-config.test.json +29 -29
  174. package/skills/tests/rdc-watch.test.json +24 -24
  175. package/skills/tests/rdc-workitems.test.json +27 -27
  176. package/skills/watch/SKILL.md +97 -97
  177. package/skills/workitems/SKILL.md +151 -151
  178. package/tests/acceptance.test.mjs +59 -59
  179. package/tests/channel-formatter.contract.test.mjs +251 -251
  180. package/tests/curl-surface.test.mjs +289 -289
  181. package/tests/harness-gates.test.mjs +325 -325
  182. package/tests/help-surface.test.mjs +61 -61
  183. package/tests/install-rdc-skills.test.mjs +49 -49
  184. package/tests/manifest-contract-fields.test.mjs +78 -78
  185. package/tests/mcp.test.mjs +271 -271
  186. package/tests/require-work-item-on-commit.test.mjs +162 -162
  187. package/tests/run-evidence-gate.test.mjs +82 -82
  188. package/tests/skill-test-matrix.test.mjs +66 -66
  189. package/tests/validate-skills.js +27 -27
  190. package/tests/work-item-exit-gate-l2.test.mjs +368 -368
  191. package/tests/work-item-exit-gate-l3.test.mjs +197 -197
@@ -1,29 +1,29 @@
1
- {
2
- "manifest_version": 1,
3
- "skill": "rdc:status",
4
- "description": "Status is read-only: prints kanban + health, makes no commits.",
5
- "fixture": {
6
- "prompt": "rdc:status",
7
- "env": { "RDC_TEST": "1" }
8
- },
9
- "assertions": {
10
- "exit_code": 0,
11
- "commits_made": { "min": 0 },
12
- "stdout_contains": ["Recommended Next"]
13
- },
14
- "acceptance": {
15
- "output_contains": [
16
- "Recommended Next",
17
- "read-only",
18
- "work items",
19
- "health"
20
- ],
21
- "output_not_contains": [
22
- "raw MCP",
23
- "UUID",
24
- "UPDATE work_items",
25
- "INSERT"
26
- ]
27
- },
28
- "teardown": { "reset_branch": true }
29
- }
1
+ {
2
+ "manifest_version": 1,
3
+ "skill": "rdc:status",
4
+ "description": "Status is read-only: prints kanban + health, makes no commits.",
5
+ "fixture": {
6
+ "prompt": "rdc:status",
7
+ "env": { "RDC_TEST": "1" }
8
+ },
9
+ "assertions": {
10
+ "exit_code": 0,
11
+ "commits_made": { "min": 0 },
12
+ "stdout_contains": ["Recommended Next"]
13
+ },
14
+ "acceptance": {
15
+ "output_contains": [
16
+ "Recommended Next",
17
+ "read-only",
18
+ "work items",
19
+ "health"
20
+ ],
21
+ "output_not_contains": [
22
+ "raw MCP",
23
+ "UUID",
24
+ "UPDATE work_items",
25
+ "INSERT"
26
+ ]
27
+ },
28
+ "teardown": { "reset_branch": true }
29
+ }
@@ -1,29 +1,29 @@
1
- {
2
- "manifest_version": 1,
3
- "skill": "rdc:terminal-config",
4
- "description": "Terminal config audits focus-safe launch policy without changing Windows Terminal settings.",
5
- "fixture": {
6
- "prompt": "rdc:terminal-config audit hidden-window launch policy and do not write settings",
7
- "env": { "RDC_TEST": "1" }
8
- },
9
- "assertions": {
10
- "exit_code": 0,
11
- "commits_made": { "min": 0 },
12
- "stdout_contains": ["hidden-window", "No settings written"]
13
- },
14
- "acceptance": {
15
- "output_contains": [
16
- "hidden-window",
17
- "No settings written",
18
- "read before edit",
19
- "JSON/TOML syntax"
20
- ],
21
- "output_not_contains": [
22
- "SetForegroundWindow",
23
- "ShowWindow",
24
- "collapse all windows",
25
- "restore all windows"
26
- ]
27
- },
28
- "teardown": { "reset_branch": true }
29
- }
1
+ {
2
+ "manifest_version": 1,
3
+ "skill": "rdc:terminal-config",
4
+ "description": "Terminal config audits focus-safe launch policy without changing Windows Terminal settings.",
5
+ "fixture": {
6
+ "prompt": "rdc:terminal-config audit hidden-window launch policy and do not write settings",
7
+ "env": { "RDC_TEST": "1" }
8
+ },
9
+ "assertions": {
10
+ "exit_code": 0,
11
+ "commits_made": { "min": 0 },
12
+ "stdout_contains": ["hidden-window", "No settings written"]
13
+ },
14
+ "acceptance": {
15
+ "output_contains": [
16
+ "hidden-window",
17
+ "No settings written",
18
+ "read before edit",
19
+ "JSON/TOML syntax"
20
+ ],
21
+ "output_not_contains": [
22
+ "SetForegroundWindow",
23
+ "ShowWindow",
24
+ "collapse all windows",
25
+ "restore all windows"
26
+ ]
27
+ },
28
+ "teardown": { "reset_branch": true }
29
+ }
@@ -1,24 +1,24 @@
1
- {
2
- "manifest_version": 1,
3
- "skill": "rdc:watch",
4
- "description": "Watch initializes or describes the live viewer in RDC_TEST mode without launching a foreground browser.",
5
- "fixture": {
6
- "prompt": "rdc:watch",
7
- "env": { "RDC_TEST": "1" }
8
- },
9
- "assertions": {
10
- "exit_code": 0,
11
- "stdout_contains": ["watcher"]
12
- },
13
- "acceptance": {
14
- "output_contains": ["not opened", "RDC_TEST=1"],
15
- "output_not_contains": ["SetForegroundWindow", "AppActivate", "BringWindowToTop", "SwitchToThisWindow"],
16
- "tool_calls_argument_matches": [
17
- {
18
- "tools": ["Bash", "Shell"],
19
- "pattern": "watch-init\\.mjs"
20
- }
21
- ]
22
- },
23
- "teardown": { "reset_branch": true }
24
- }
1
+ {
2
+ "manifest_version": 1,
3
+ "skill": "rdc:watch",
4
+ "description": "Watch initializes or describes the live viewer in RDC_TEST mode without launching a foreground browser.",
5
+ "fixture": {
6
+ "prompt": "rdc:watch",
7
+ "env": { "RDC_TEST": "1" }
8
+ },
9
+ "assertions": {
10
+ "exit_code": 0,
11
+ "stdout_contains": ["watcher"]
12
+ },
13
+ "acceptance": {
14
+ "output_contains": ["not opened", "RDC_TEST=1"],
15
+ "output_not_contains": ["SetForegroundWindow", "AppActivate", "BringWindowToTop", "SwitchToThisWindow"],
16
+ "tool_calls_argument_matches": [
17
+ {
18
+ "tools": ["Bash", "Shell"],
19
+ "pattern": "watch-init\\.mjs"
20
+ }
21
+ ]
22
+ },
23
+ "teardown": { "reset_branch": true }
24
+ }
@@ -1,27 +1,27 @@
1
- {
2
- "manifest_version": 1,
3
- "skill": "rdc:workitems",
4
- "description": "Workitems list action is read-only — queries epics via RPC, no commits.",
5
- "fixture": {
6
- "prompt": "rdc:workitems epics",
7
- "env": { "RDC_TEST": "1" }
8
- },
9
- "assertions": {
10
- "exit_code": 0,
11
- "commits_made": { "min": 0 },
12
- "stdout_contains": ["Open Epics"]
13
- },
14
- "acceptance": {
15
- "output_contains": [
16
- "get_open_epics",
17
- "Open Epics"
18
- ],
19
- "output_not_contains": [
20
- "insert_work_item",
21
- "update_work_item_status",
22
- "bump_epic_version",
23
- "raw MCP"
24
- ]
25
- },
26
- "teardown": { "reset_branch": true }
27
- }
1
+ {
2
+ "manifest_version": 1,
3
+ "skill": "rdc:workitems",
4
+ "description": "Workitems list action is read-only — queries epics via RPC, no commits.",
5
+ "fixture": {
6
+ "prompt": "rdc:workitems epics",
7
+ "env": { "RDC_TEST": "1" }
8
+ },
9
+ "assertions": {
10
+ "exit_code": 0,
11
+ "commits_made": { "min": 0 },
12
+ "stdout_contains": ["Open Epics"]
13
+ },
14
+ "acceptance": {
15
+ "output_contains": [
16
+ "get_open_epics",
17
+ "Open Epics"
18
+ ],
19
+ "output_not_contains": [
20
+ "insert_work_item",
21
+ "update_work_item_status",
22
+ "bump_epic_version",
23
+ "raw MCP"
24
+ ]
25
+ },
26
+ "teardown": { "reset_branch": true }
27
+ }
@@ -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.