@lifeaitools/rdc-skills 0.25.5 → 0.25.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1550 -1550
- package/.github/workflows/self-test.yml +34 -34
- package/CHANGELOG.md +319 -319
- package/MANIFEST.md +224 -224
- package/README.md +367 -367
- package/commands/build.md +181 -181
- package/commands/collab.md +180 -180
- package/commands/deploy.md +148 -148
- package/commands/fixit.md +150 -150
- package/commands/handoff.md +173 -173
- package/commands/overnight.md +220 -220
- package/commands/plan.md +158 -158
- package/commands/preplan.md +131 -131
- package/commands/prototype.md +145 -145
- package/commands/report.md +99 -99
- package/commands/review.md +120 -120
- package/commands/status.md +86 -86
- package/commands/workitems.md +127 -127
- package/git-sha.json +1 -1
- package/guides/agent-bootstrap.md +195 -195
- package/guides/agents/backend.md +102 -102
- package/guides/agents/content.md +94 -94
- package/guides/agents/cs2.md +56 -56
- package/guides/agents/data.md +86 -86
- package/guides/agents/design.md +77 -77
- package/guides/agents/frontend.md +91 -91
- package/guides/agents/infrastructure.md +81 -81
- package/guides/agents/setup.md +272 -272
- package/guides/agents/verify.md +119 -119
- package/guides/agents/viz.md +106 -106
- package/hooks/check-rdc-environment.js +318 -164
- package/hooks/lib/box-lock.js +186 -0
- package/package.json +1 -1
- package/scripts/install-rdc-skills.js +1474 -1400
- package/scripts/local-install-with-stop.sh +41 -0
- package/scripts/probe-box-lock.mjs +179 -0
- package/scripts/probe-installed-hooks.mjs +60 -0
- package/scripts/probe-lock-holders.mjs +36 -0
- package/scripts/self-test.mjs +1459 -1459
- package/scripts/validate-publish-manifests.js +502 -502
- package/skills/build/SKILL.md +578 -578
- package/skills/channel-formatter/SKILL.md +538 -538
- package/skills/collab/SKILL.md +239 -239
- package/skills/convert/SKILL.md +138 -138
- package/skills/deploy/SKILL.md +541 -541
- package/skills/design/SKILL.md +205 -205
- package/skills/env/SKILL.md +139 -139
- package/skills/fixit/SKILL.md +203 -203
- package/skills/handoff/SKILL.md +236 -236
- package/skills/housekeeping/SKILL.md +189 -189
- package/skills/onramp/SKILL.md +1459 -1459
- package/skills/overnight/SKILL.md +251 -251
- package/skills/plan/SKILL.md +345 -345
- package/skills/preplan/SKILL.md +90 -90
- package/skills/prototype/SKILL.md +150 -150
- package/skills/regen-media/SKILL.md +94 -94
- package/skills/release/SKILL.md +140 -140
- package/skills/report/SKILL.md +100 -100
- package/skills/review/SKILL.md +151 -151
- package/skills/self-test/SKILL.md +108 -108
- package/skills/status/SKILL.md +99 -99
- package/skills/tests/MATRIX.md +55 -55
- package/skills/tests/onramp.test.json +87 -87
- package/skills/tests/rdc-regen-media.test.json +29 -29
- package/skills/watch/SKILL.md +84 -84
- package/skills/workitems/SKILL.md +151 -151
|
@@ -1,87 +1,87 @@
|
|
|
1
|
-
{
|
|
2
|
-
"skill": "rdc:onramp",
|
|
3
|
-
"description": "Tier-2 self-test for rdc:onramp enrollment skill",
|
|
4
|
-
"tier": 2,
|
|
5
|
-
"sandbox": true,
|
|
6
|
-
"env": {
|
|
7
|
-
"RDC_TEST": "1"
|
|
8
|
-
},
|
|
9
|
-
"invocation": {
|
|
10
|
-
"slug": "onramp-selftest",
|
|
11
|
-
"name": "Onramp Self Test",
|
|
12
|
-
"flags": ["--archetype", "working-landscapes", "--dry-run"]
|
|
13
|
-
},
|
|
14
|
-
"assertions": [
|
|
15
|
-
{
|
|
16
|
-
"type": "exit_code",
|
|
17
|
-
"expect": 0,
|
|
18
|
-
"description": "Skill exits cleanly under RDC_TEST with --dry-run"
|
|
19
|
-
},
|
|
20
|
-
{
|
|
21
|
-
"type": "stdout_contains",
|
|
22
|
-
"pattern": "Preflight",
|
|
23
|
-
"description": "Checklist begins with Preflight step"
|
|
24
|
-
},
|
|
25
|
-
{
|
|
26
|
-
"type": "stdout_contains",
|
|
27
|
-
"pattern": "Resolve drift",
|
|
28
|
-
"description": "Drift resolution step is emitted"
|
|
29
|
-
},
|
|
30
|
-
{
|
|
31
|
-
"type": "stdout_contains",
|
|
32
|
-
"pattern": "\\[RDC_TEST\\]",
|
|
33
|
-
"description": "Sandbox short-circuit marker present — confirms external calls were skipped"
|
|
34
|
-
},
|
|
35
|
-
{
|
|
36
|
-
"type": "file_absent",
|
|
37
|
-
"path": "places/onramp-selftest/_context.md",
|
|
38
|
-
"description": "Scaffolder MUST NOT write _context.md — projection-drift violation gate"
|
|
39
|
-
}
|
|
40
|
-
],
|
|
41
|
-
"door_contracts": [
|
|
42
|
-
{
|
|
43
|
-
"name": "enroll_place_signature",
|
|
44
|
-
"description": "enroll_place RPC must accept (text, text, jsonb, text) and return jsonb",
|
|
45
|
-
"type": "rpc_introspection",
|
|
46
|
-
"project_id": "uvojezuorjgqzmhhgluu",
|
|
47
|
-
"query": "SELECT p.proname, pg_get_function_identity_arguments(p.oid) AS args, pg_get_function_result(p.oid) AS returns FROM pg_proc p WHERE p.proname = 'enroll_place';",
|
|
48
|
-
"expect_args_contains": ["text", "jsonb"],
|
|
49
|
-
"expect_returns": "jsonb"
|
|
50
|
-
},
|
|
51
|
-
{
|
|
52
|
-
"name": "insert_work_item_accepts_project_node_id",
|
|
53
|
-
"description": "insert_work_item must accept p_project_node_id parameter",
|
|
54
|
-
"type": "rpc_introspection",
|
|
55
|
-
"project_id": "uvojezuorjgqzmhhgluu",
|
|
56
|
-
"query": "SELECT proname, pg_get_function_identity_arguments(oid) FROM pg_proc WHERE proname = 'insert_work_item';",
|
|
57
|
-
"expect_args_contains": ["p_project_node_id"]
|
|
58
|
-
}
|
|
59
|
-
],
|
|
60
|
-
"disk_ahead_test": {
|
|
61
|
-
"description": "disk-ahead state must STOP and open a reconciliation work item",
|
|
62
|
-
"setup": "mkdir -p places/disk-ahead-test",
|
|
63
|
-
"invocation_slug": "disk-ahead-test",
|
|
64
|
-
"invocation_name": "Disk Ahead Test",
|
|
65
|
-
"assertions": [
|
|
66
|
-
{
|
|
67
|
-
"type": "stdout_contains",
|
|
68
|
-
"pattern": "disk-ahead",
|
|
69
|
-
"description": "Skill identifies the disk-ahead state"
|
|
70
|
-
},
|
|
71
|
-
{
|
|
72
|
-
"type": "stdout_contains",
|
|
73
|
-
"pattern": "STOP",
|
|
74
|
-
"description": "Skill STOPs on disk-ahead"
|
|
75
|
-
},
|
|
76
|
-
{
|
|
77
|
-
"type": "exit_nonzero",
|
|
78
|
-
"description": "Skill exits non-zero on disk-ahead (not a clean enrollment)"
|
|
79
|
-
}
|
|
80
|
-
],
|
|
81
|
-
"teardown": "rmdir places/disk-ahead-test 2>/dev/null || true"
|
|
82
|
-
},
|
|
83
|
-
"idempotency_test": {
|
|
84
|
-
"description": "Running rdc:onramp twice for already-enrolled should produce zero new writes",
|
|
85
|
-
"note": "Under RDC_TEST=1 this is verified by checking that [RDC_TEST] skipping markers appear (not real insert calls) and the checklist reports already-enrolled"
|
|
86
|
-
}
|
|
87
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"skill": "rdc:onramp",
|
|
3
|
+
"description": "Tier-2 self-test for rdc:onramp enrollment skill",
|
|
4
|
+
"tier": 2,
|
|
5
|
+
"sandbox": true,
|
|
6
|
+
"env": {
|
|
7
|
+
"RDC_TEST": "1"
|
|
8
|
+
},
|
|
9
|
+
"invocation": {
|
|
10
|
+
"slug": "onramp-selftest",
|
|
11
|
+
"name": "Onramp Self Test",
|
|
12
|
+
"flags": ["--archetype", "working-landscapes", "--dry-run"]
|
|
13
|
+
},
|
|
14
|
+
"assertions": [
|
|
15
|
+
{
|
|
16
|
+
"type": "exit_code",
|
|
17
|
+
"expect": 0,
|
|
18
|
+
"description": "Skill exits cleanly under RDC_TEST with --dry-run"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"type": "stdout_contains",
|
|
22
|
+
"pattern": "Preflight",
|
|
23
|
+
"description": "Checklist begins with Preflight step"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"type": "stdout_contains",
|
|
27
|
+
"pattern": "Resolve drift",
|
|
28
|
+
"description": "Drift resolution step is emitted"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"type": "stdout_contains",
|
|
32
|
+
"pattern": "\\[RDC_TEST\\]",
|
|
33
|
+
"description": "Sandbox short-circuit marker present — confirms external calls were skipped"
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"type": "file_absent",
|
|
37
|
+
"path": "places/onramp-selftest/_context.md",
|
|
38
|
+
"description": "Scaffolder MUST NOT write _context.md — projection-drift violation gate"
|
|
39
|
+
}
|
|
40
|
+
],
|
|
41
|
+
"door_contracts": [
|
|
42
|
+
{
|
|
43
|
+
"name": "enroll_place_signature",
|
|
44
|
+
"description": "enroll_place RPC must accept (text, text, jsonb, text) and return jsonb",
|
|
45
|
+
"type": "rpc_introspection",
|
|
46
|
+
"project_id": "uvojezuorjgqzmhhgluu",
|
|
47
|
+
"query": "SELECT p.proname, pg_get_function_identity_arguments(p.oid) AS args, pg_get_function_result(p.oid) AS returns FROM pg_proc p WHERE p.proname = 'enroll_place';",
|
|
48
|
+
"expect_args_contains": ["text", "jsonb"],
|
|
49
|
+
"expect_returns": "jsonb"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"name": "insert_work_item_accepts_project_node_id",
|
|
53
|
+
"description": "insert_work_item must accept p_project_node_id parameter",
|
|
54
|
+
"type": "rpc_introspection",
|
|
55
|
+
"project_id": "uvojezuorjgqzmhhgluu",
|
|
56
|
+
"query": "SELECT proname, pg_get_function_identity_arguments(oid) FROM pg_proc WHERE proname = 'insert_work_item';",
|
|
57
|
+
"expect_args_contains": ["p_project_node_id"]
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"disk_ahead_test": {
|
|
61
|
+
"description": "disk-ahead state must STOP and open a reconciliation work item",
|
|
62
|
+
"setup": "mkdir -p places/disk-ahead-test",
|
|
63
|
+
"invocation_slug": "disk-ahead-test",
|
|
64
|
+
"invocation_name": "Disk Ahead Test",
|
|
65
|
+
"assertions": [
|
|
66
|
+
{
|
|
67
|
+
"type": "stdout_contains",
|
|
68
|
+
"pattern": "disk-ahead",
|
|
69
|
+
"description": "Skill identifies the disk-ahead state"
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"type": "stdout_contains",
|
|
73
|
+
"pattern": "STOP",
|
|
74
|
+
"description": "Skill STOPs on disk-ahead"
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"type": "exit_nonzero",
|
|
78
|
+
"description": "Skill exits non-zero on disk-ahead (not a clean enrollment)"
|
|
79
|
+
}
|
|
80
|
+
],
|
|
81
|
+
"teardown": "rmdir places/disk-ahead-test 2>/dev/null || true"
|
|
82
|
+
},
|
|
83
|
+
"idempotency_test": {
|
|
84
|
+
"description": "Running rdc:onramp twice for already-enrolled should produce zero new writes",
|
|
85
|
+
"note": "Under RDC_TEST=1 this is verified by checking that [RDC_TEST] skipping markers appear (not real insert calls) and the checklist reports already-enrolled"
|
|
86
|
+
}
|
|
87
|
+
}
|
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
{
|
|
2
|
-
"manifest_version": 1,
|
|
3
|
-
"skill": "rdc:regen-media",
|
|
4
|
-
"description": "Regen Media uses local keyless Codex gpt-image-2 as the primary image-generation path and avoids live generation under RDC_TEST.",
|
|
5
|
-
"fixture": {
|
|
6
|
-
"prompt": "rdc:regen-media generate a 2048x1152 homepage hero image",
|
|
7
|
-
"env": { "RDC_TEST": "1" }
|
|
8
|
-
},
|
|
9
|
-
"assertions": {
|
|
10
|
-
"exit_code": 0,
|
|
11
|
-
"commits_made": { "min": 0 },
|
|
12
|
-
"stdout_contains": ["image_gen", "gpt-image-2"]
|
|
13
|
-
},
|
|
14
|
-
"acceptance": {
|
|
15
|
-
"output_contains": [
|
|
16
|
-
"image_gen",
|
|
17
|
-
"gpt-image-2",
|
|
18
|
-
"--enable image_generation",
|
|
19
|
-
"RDC_TEST"
|
|
20
|
-
],
|
|
21
|
-
"output_not_contains": [
|
|
22
|
-
"OPENAI_API_KEY=",
|
|
23
|
-
"generate_gpt_image is the default",
|
|
24
|
-
"upload completed",
|
|
25
|
-
"raw MCP"
|
|
26
|
-
]
|
|
27
|
-
},
|
|
28
|
-
"teardown": { "reset_branch": true }
|
|
29
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"manifest_version": 1,
|
|
3
|
+
"skill": "rdc:regen-media",
|
|
4
|
+
"description": "Regen Media uses local keyless Codex gpt-image-2 as the primary image-generation path and avoids live generation under RDC_TEST.",
|
|
5
|
+
"fixture": {
|
|
6
|
+
"prompt": "rdc:regen-media generate a 2048x1152 homepage hero image",
|
|
7
|
+
"env": { "RDC_TEST": "1" }
|
|
8
|
+
},
|
|
9
|
+
"assertions": {
|
|
10
|
+
"exit_code": 0,
|
|
11
|
+
"commits_made": { "min": 0 },
|
|
12
|
+
"stdout_contains": ["image_gen", "gpt-image-2"]
|
|
13
|
+
},
|
|
14
|
+
"acceptance": {
|
|
15
|
+
"output_contains": [
|
|
16
|
+
"image_gen",
|
|
17
|
+
"gpt-image-2",
|
|
18
|
+
"--enable image_generation",
|
|
19
|
+
"RDC_TEST"
|
|
20
|
+
],
|
|
21
|
+
"output_not_contains": [
|
|
22
|
+
"OPENAI_API_KEY=",
|
|
23
|
+
"generate_gpt_image is the default",
|
|
24
|
+
"upload completed",
|
|
25
|
+
"raw MCP"
|
|
26
|
+
]
|
|
27
|
+
},
|
|
28
|
+
"teardown": { "reset_branch": true }
|
|
29
|
+
}
|
package/skills/watch/SKILL.md
CHANGED
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: rdc:watch
|
|
1
|
+
---
|
|
2
|
+
name: rdc:watch
|
|
3
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
|
-
```
|
|
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
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
|
-
|
|
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
30
|
3. **Open the viewer in the browser, unless running under `RDC_TEST=1`.**
|
|
31
31
|
- Normal attended use: run the exact `open_hint` line from the script output. On Windows that's `start "" "<viewer-path>"`.
|
|
32
32
|
- `RDC_TEST=1`: do not run `open_hint`, `start`, `open`, `xdg-open`, or any focus/window API. Report the viewer path only.
|
|
33
|
-
|
|
33
|
+
|
|
34
34
|
4. **Report to the user.** One line:
|
|
35
35
|
```
|
|
36
36
|
watcher live at <viewer-path> — tailing <log-path>
|
|
@@ -39,59 +39,59 @@ description: "Usage `rdc:watch` — Initialize a live session-log viewer and rep
|
|
|
39
39
|
```
|
|
40
40
|
watcher initialized at <viewer-path> — not opened because RDC_TEST=1
|
|
41
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.
|
|
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.
|