@lifeaitools/rdc-skills 0.9.31 → 0.9.33

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 (59) hide show
  1. package/.claude-plugin/plugin.json +24 -2
  2. package/.github/workflows/self-test.yml +34 -34
  3. package/MANIFEST.md +4 -0
  4. package/commands/build.md +183 -183
  5. package/commands/collab.md +180 -180
  6. package/commands/deploy.md +152 -138
  7. package/commands/fixit.md +116 -104
  8. package/commands/handoff.md +173 -173
  9. package/commands/overnight.md +220 -220
  10. package/commands/plan.md +158 -158
  11. package/commands/preplan.md +131 -131
  12. package/commands/prototype.md +145 -145
  13. package/commands/report.md +99 -99
  14. package/commands/review.md +120 -120
  15. package/commands/status.md +86 -86
  16. package/commands/workitems.md +132 -127
  17. package/guides/agent-bootstrap.md +265 -206
  18. package/guides/agents/backend.md +104 -104
  19. package/guides/agents/content.md +94 -94
  20. package/guides/agents/cs2.md +56 -56
  21. package/guides/agents/data.md +87 -87
  22. package/guides/agents/design.md +77 -77
  23. package/guides/agents/frontend.md +92 -92
  24. package/guides/agents/infrastructure.md +81 -81
  25. package/guides/agents/setup.md +279 -279
  26. package/guides/agents/verify.md +119 -119
  27. package/guides/agents/viz.md +106 -106
  28. package/hooks/foreground-process-gate.js +109 -0
  29. package/hooks/hook-logger.js +25 -0
  30. package/hooks/run-hidden-hook.ps1 +47 -0
  31. package/hooks/work-item-exit-gate.js +297 -0
  32. package/package.json +3 -3
  33. package/rules/work-items-rpc.md +56 -7
  34. package/scripts/fixtures/guides/bad-guide.md +15 -0
  35. package/scripts/fixtures/guides-clean/good-guide.md +16 -0
  36. package/scripts/install-rdc-skills.js +53 -9
  37. package/scripts/install.ps1 +17 -11
  38. package/scripts/self-test.mjs +1323 -1113
  39. package/scripts/test-guide-validator.mjs +194 -0
  40. package/skills/build/SKILL.md +355 -355
  41. package/skills/co-develop/SKILL.md +182 -0
  42. package/skills/collab/SKILL.md +217 -217
  43. package/skills/deploy/SKILL.md +198 -152
  44. package/skills/design/SKILL.md +211 -211
  45. package/skills/fixit/SKILL.md +132 -122
  46. package/skills/handoff/SKILL.md +200 -200
  47. package/skills/help/SKILL.md +104 -102
  48. package/skills/overnight/SKILL.md +224 -224
  49. package/skills/plan/SKILL.md +252 -251
  50. package/skills/preplan/SKILL.md +86 -86
  51. package/skills/prototype/SKILL.md +150 -150
  52. package/skills/release/SKILL.md +342 -342
  53. package/skills/report/SKILL.md +100 -100
  54. package/skills/review/SKILL.md +121 -120
  55. package/skills/self-test/SKILL.md +126 -126
  56. package/skills/status/SKILL.md +99 -97
  57. package/skills/terminal-config/SKILL.md +18 -18
  58. package/skills/watch/SKILL.md +91 -91
  59. package/skills/workitems/SKILL.md +151 -146
@@ -1,81 +1,81 @@
1
- > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
2
- > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
3
- > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
4
-
5
- > 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`).
6
-
7
- > **Sandbox contract:** This guide honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag — Coolify deploys, DNS writes, CF cache purges, container restarts, and `git push` are all skipped. Registry SELECTs, health checks, and git reads run normally.
8
-
9
-
10
- # rdc:infra — Infrastructure Agent
11
-
12
- ## Mandatory First Step
13
-
14
- Read the guide before ANY operations:
15
- ```
16
- {PROJECT_ROOT}/.rdc/guides/infrastructure.md
17
- (fallback: {PROJECT_ROOT}/.rdc/guides/infrastructure.md)
18
- ```
19
-
20
- ## Rule 1: Never Work Around Broken Infrastructure
21
-
22
- When a service is unavailable, STOP and report:
23
- ```
24
- BLOCKED: [service] is not responding.
25
- Fix: [reconnect MCP / restart credential daemon]
26
- I cannot proceed until this is resolved.
27
- ```
28
-
29
- ## Deployment Registry — Check BEFORE Any Deploy
30
-
31
- ```sql
32
- SELECT get_deployment('<slug>');
33
- SELECT slug, display_name, domain, build_type, status FROM deployment_registry ORDER BY slug;
34
- ```
35
-
36
- **NEVER guess deployment UUIDs, domains, or build commands.**
37
-
38
- ## Watch Paths — Must Set on Every Monorepo App
39
-
40
- | App Type | Watch Paths |
41
- |----------|-------------|
42
- | Monorepo app | `apps/<n>/**` and `packages/**` |
43
- | Static monorepo | `sites/<n>/**` |
44
-
45
- Without watch_paths, every push rebuilds all apps.
46
-
47
- ## Build Types
48
-
49
- | Type | Pack | Install | Build |
50
- |------|------|---------|-------|
51
- | Monorepo | nixpacks | `pnpm install --frozen-lockfile` | `pnpm turbo run build --filter=<filter>` |
52
- | Static | static | — | — |
53
-
54
- ## New App — Checklist
55
-
56
- 1. Look up deployment registry for existing entry
57
- 2. Check for Coolify UUID (if exists)
58
- 3. Set watch_paths per app type *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify config write`)*
59
- 4. Deploy and verify health *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify deploy`)*
60
- 5. Update deployment_registry in database
61
-
62
- ## Environment Tiers
63
-
64
- | Tier | Rules |
65
- |------|-------|
66
- | development | Free to experiment, no confirmation needed |
67
- | staging | Confirm before deploying |
68
- | production | ALWAYS confirm before deploy, ALWAYS verify after |
69
-
70
- ## Git Workflow
71
-
72
- - Branch: development branch — NEVER touch production
73
- - Before push: `git fetch origin`
74
- - Never force-push
75
-
76
- ## Safety Rules
77
-
78
- - MCP connectors first, credential daemon second
79
- - Never print credential keys to stdout
80
- - If daemon is down: report BLOCKED, do not work around it
81
- - Push after every logical block *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping git push` instead)*
1
+ > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
2
+ > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
3
+ > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
4
+
5
+ > 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`).
6
+
7
+ > **Sandbox contract:** This guide honors `RDC_TEST=1` per `guides/agent-bootstrap.md` § RDC_TEST Sandbox Contract. Destructive external calls short-circuit under the flag — Coolify deploys, DNS writes, CF cache purges, container restarts, and `git push` are all skipped. Registry SELECTs, health checks, and git reads run normally.
8
+
9
+
10
+ # rdc:infra — Infrastructure Agent
11
+
12
+ ## Mandatory First Step
13
+
14
+ Read the guide before ANY operations:
15
+ ```
16
+ {PROJECT_ROOT}/.rdc/guides/infrastructure.md
17
+ (fallback: {PROJECT_ROOT}/.rdc/guides/infrastructure.md)
18
+ ```
19
+
20
+ ## Rule 1: Never Work Around Broken Infrastructure
21
+
22
+ When a service is unavailable, STOP and report:
23
+ ```
24
+ BLOCKED: [service] is not responding.
25
+ Fix: [reconnect MCP / restart credential daemon]
26
+ I cannot proceed until this is resolved.
27
+ ```
28
+
29
+ ## Deployment Registry — Check BEFORE Any Deploy
30
+
31
+ ```sql
32
+ SELECT get_deployment('<slug>');
33
+ SELECT slug, display_name, domain, build_type, status FROM deployment_registry ORDER BY slug;
34
+ ```
35
+
36
+ **NEVER guess deployment UUIDs, domains, or build commands.**
37
+
38
+ ## Watch Paths — Must Set on Every Monorepo App
39
+
40
+ | App Type | Watch Paths |
41
+ |----------|-------------|
42
+ | Monorepo app | `apps/<n>/**` and `packages/**` |
43
+ | Static monorepo | `sites/<n>/**` |
44
+
45
+ Without watch_paths, every push rebuilds all apps.
46
+
47
+ ## Build Types
48
+
49
+ | Type | Pack | Install | Build |
50
+ |------|------|---------|-------|
51
+ | Monorepo | nixpacks | `pnpm install --frozen-lockfile` | `pnpm turbo run build --filter=<filter>` |
52
+ | Static | static | — | — |
53
+
54
+ ## New App — Checklist
55
+
56
+ 1. Look up deployment registry for existing entry
57
+ 2. Check for Coolify UUID (if exists)
58
+ 3. Set watch_paths per app type *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify config write`)*
59
+ 4. Deploy and verify health *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping Coolify deploy`)*
60
+ 5. Update deployment_registry in database
61
+
62
+ ## Environment Tiers
63
+
64
+ | Tier | Rules |
65
+ |------|-------|
66
+ | development | Free to experiment, no confirmation needed |
67
+ | staging | Confirm before deploying |
68
+ | production | ALWAYS confirm before deploy, ALWAYS verify after |
69
+
70
+ ## Git Workflow
71
+
72
+ - Branch: development branch — NEVER touch production
73
+ - Before push: `git fetch origin`
74
+ - Never force-push
75
+
76
+ ## Safety Rules
77
+
78
+ - MCP connectors first, credential daemon second
79
+ - Never print credential keys to stdout
80
+ - If daemon is down: report BLOCKED, do not work around it
81
+ - Push after every logical block *(skip if `$RDC_TEST=1` — echo `[RDC_TEST] skipping git push` instead)*