@lifeaitools/rdc-skills 0.25.4 → 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.
Files changed (71) hide show
  1. package/.claude-plugin/plugin.json +1574 -1528
  2. package/.github/workflows/self-test.yml +34 -34
  3. package/CHANGELOG.md +326 -313
  4. package/MANIFEST.md +224 -224
  5. package/README.md +372 -369
  6. package/RELEASE.md +26 -2
  7. package/commands/build.md +181 -181
  8. package/commands/collab.md +180 -180
  9. package/commands/deploy.md +148 -148
  10. package/commands/fixit.md +150 -150
  11. package/commands/handoff.md +173 -173
  12. package/commands/overnight.md +220 -220
  13. package/commands/plan.md +158 -158
  14. package/commands/preplan.md +131 -131
  15. package/commands/prototype.md +145 -145
  16. package/commands/report.md +99 -99
  17. package/commands/review.md +120 -120
  18. package/commands/status.md +86 -86
  19. package/commands/workitems.md +127 -127
  20. package/git-sha.json +1 -1
  21. package/guides/agent-bootstrap.md +195 -195
  22. package/guides/agents/backend.md +102 -102
  23. package/guides/agents/content.md +94 -94
  24. package/guides/agents/cs2.md +56 -56
  25. package/guides/agents/data.md +86 -86
  26. package/guides/agents/design.md +77 -77
  27. package/guides/agents/frontend.md +91 -91
  28. package/guides/agents/infrastructure.md +81 -81
  29. package/guides/agents/setup.md +272 -272
  30. package/guides/agents/verify.md +119 -119
  31. package/guides/agents/viz.md +106 -106
  32. package/hooks/check-rdc-environment.js +318 -164
  33. package/hooks/lib/box-lock.js +186 -0
  34. package/package.json +1 -1
  35. package/scripts/install-rdc-skills.js +1474 -1400
  36. package/scripts/local-install-with-stop.sh +41 -0
  37. package/scripts/probe-box-lock.mjs +179 -0
  38. package/scripts/probe-installed-hooks.mjs +60 -0
  39. package/scripts/probe-lock-holders.mjs +36 -0
  40. package/scripts/self-test.mjs +1459 -1459
  41. package/scripts/validate-publish-manifests.js +502 -502
  42. package/skills/build/SKILL.md +578 -578
  43. package/skills/channel-formatter/SKILL.md +538 -538
  44. package/skills/collab/SKILL.md +239 -239
  45. package/skills/convert/SKILL.md +150 -161
  46. package/skills/deploy/SKILL.md +541 -541
  47. package/skills/design/SKILL.md +205 -205
  48. package/skills/env/SKILL.md +139 -139
  49. package/skills/fixit/SKILL.md +203 -203
  50. package/skills/handoff/SKILL.md +236 -236
  51. package/skills/housekeeping/SKILL.md +189 -189
  52. package/skills/new-model/SKILL.md +14 -3
  53. package/skills/onramp/SKILL.md +1459 -1459
  54. package/skills/overnight/SKILL.md +251 -251
  55. package/skills/plan/SKILL.md +345 -345
  56. package/skills/preplan/SKILL.md +90 -90
  57. package/skills/prototype/SKILL.md +150 -150
  58. package/skills/regen-media/SKILL.md +94 -94
  59. package/skills/release/SKILL.md +140 -140
  60. package/skills/report/SKILL.md +100 -100
  61. package/skills/review/SKILL.md +151 -151
  62. package/skills/self-test/SKILL.md +108 -108
  63. package/skills/status/SKILL.md +99 -99
  64. package/skills/tests/MATRIX.md +55 -55
  65. package/skills/tests/onramp.test.json +87 -87
  66. package/skills/tests/rdc-regen-media.test.json +29 -29
  67. package/skills/watch/SKILL.md +84 -84
  68. package/skills/workitems/SKILL.md +151 -151
  69. package/tests/curl-surface.test.mjs +4 -2
  70. package/tests/help-surface.test.mjs +1 -1
  71. package/tests/install-rdc-skills.test.mjs +1 -1
@@ -1,69 +1,69 @@
1
- ---
2
- name: rdc:workitems
3
- description: >-
4
- Usage `rdc:workitems <action> [args]` — create, update, query work items via Supabase RPCs. Actions: add, update, done, list, epics. Use for "add to backlog", "mark done", "show open epics", any work item CRUD.
5
- ---
6
-
7
- > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
8
- > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
9
- > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
10
-
11
- > 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`).
12
-
13
-
14
- # rdc:workitems — Work Item Management
15
-
16
- ## Rules
17
-
18
- 1. **Epic first, always.** Never create a task without a parent epic.
19
- 2. **Label everything.** Minimum one system label per item.
20
- 3. **Check first.** `get_open_epics()` before creating anything new.
21
- 4. **Link design docs.** Put `.rdc/plans/` or `.rdc/research/` paths in descriptions (fallback: `.rdc/plans/` / `.rdc/research/`).
22
-
23
- ## Read Epics
24
-
25
- ```sql
26
- SELECT get_open_epics();
27
- SELECT get_open_epics('urgent');
28
- SELECT get_open_epics(p_label_filter := 'custom-label');
29
- ```
30
-
31
- ## Create Epic
32
-
33
- ```sql
34
- SELECT insert_work_item(
35
- p_title := 'EPIC: Clear descriptive title',
36
- p_description := 'What and why. Reference .rdc/plans/<n>.md if applicable.',
37
- p_item_type := 'epic',
38
- p_priority := 'high',
39
- p_labels := ARRAY['system-label'],
40
- p_source := 'planning'
41
- );
42
- ```
43
-
44
- ## Create Task
45
-
46
- ```sql
47
- SELECT insert_work_item(
48
- p_title := 'Specific actionable task title',
49
- p_description := 'What: <deliverable>
50
- Where: <files to create/modify>
51
- Agent type: frontend | backend | data | design | infra | content | cs2
52
- Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
53
- Design doc: .rdc/plans/<n>.md (fallback: .rdc/plans/<n>.md, if exists)
54
- Depends on: <other task title if sequential>
55
- Est: <hours>',
56
- p_parent_id := '<epic-uuid>'::uuid,
57
- p_item_type := 'task',
58
- p_priority := 'high',
59
- p_labels := ARRAY['system-label'],
60
- p_estimated_hours := 2,
61
- p_source := 'planning'
62
- );
63
- ```
64
-
65
- ## Update Status
66
-
1
+ ---
2
+ name: rdc:workitems
3
+ description: >-
4
+ Usage `rdc:workitems <action> [args]` — create, update, query work items via Supabase RPCs. Actions: add, update, done, list, epics. Use for "add to backlog", "mark done", "show open epics", any work item CRUD.
5
+ ---
6
+
7
+ > **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
8
+ > Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
9
+ > One checklist upfront, updated in place, shown again at end with a 1-line verdict.
10
+
11
+ > 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`).
12
+
13
+
14
+ # rdc:workitems — Work Item Management
15
+
16
+ ## Rules
17
+
18
+ 1. **Epic first, always.** Never create a task without a parent epic.
19
+ 2. **Label everything.** Minimum one system label per item.
20
+ 3. **Check first.** `get_open_epics()` before creating anything new.
21
+ 4. **Link design docs.** Put `.rdc/plans/` or `.rdc/research/` paths in descriptions (fallback: `.rdc/plans/` / `.rdc/research/`).
22
+
23
+ ## Read Epics
24
+
25
+ ```sql
26
+ SELECT get_open_epics();
27
+ SELECT get_open_epics('urgent');
28
+ SELECT get_open_epics(p_label_filter := 'custom-label');
29
+ ```
30
+
31
+ ## Create Epic
32
+
33
+ ```sql
34
+ SELECT insert_work_item(
35
+ p_title := 'EPIC: Clear descriptive title',
36
+ p_description := 'What and why. Reference .rdc/plans/<n>.md if applicable.',
37
+ p_item_type := 'epic',
38
+ p_priority := 'high',
39
+ p_labels := ARRAY['system-label'],
40
+ p_source := 'planning'
41
+ );
42
+ ```
43
+
44
+ ## Create Task
45
+
46
+ ```sql
47
+ SELECT insert_work_item(
48
+ p_title := 'Specific actionable task title',
49
+ p_description := 'What: <deliverable>
50
+ Where: <files to create/modify>
51
+ Agent type: frontend | backend | data | design | infra | content | cs2
52
+ Guide: .rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md)
53
+ Design doc: .rdc/plans/<n>.md (fallback: .rdc/plans/<n>.md, if exists)
54
+ Depends on: <other task title if sequential>
55
+ Est: <hours>',
56
+ p_parent_id := '<epic-uuid>'::uuid,
57
+ p_item_type := 'task',
58
+ p_priority := 'high',
59
+ p_labels := ARRAY['system-label'],
60
+ p_estimated_hours := 2,
61
+ p_source := 'planning'
62
+ );
63
+ ```
64
+
65
+ ## Update Status
66
+
67
67
  ```sql
68
68
  SELECT update_work_item_status('<uuid>'::uuid, 'in_progress');
69
69
  SELECT update_work_item_status('<uuid>'::uuid, 'review', '["Implementation complete; ready for validator"]'::jsonb, '<agent-session-id>', 'agent');
@@ -74,64 +74,64 @@ SELECT update_work_item_status('<uuid>'::uuid, 'blocked', '["Why it is blocked"]
74
74
  Non-epic `done` is a validator-only close and requires an existing
75
75
  `implementation_report.codeflow_post`, checked required checklist evidence, and
76
76
  originating-agent tick audit.
77
-
78
- ## Read Tasks in an Epic
79
-
80
- ```sql
81
- SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
82
- SELECT get_work_items_by_epic('<epic-uuid>'::uuid, 'todo');
83
- ```
84
-
85
- ## Bump Epic Version
86
-
87
- ```sql
88
- SELECT bump_epic_version('<epic-uuid>'::uuid, '0.2.0', 'What changed', 'planning');
89
- ```
90
-
91
- ## Valid Values
92
-
93
- | Field | Values |
94
- |-------|--------|
95
- | status | `todo` `in_progress` `blocked` `review` `done` `archived` |
96
- | priority | `urgent` `high` `normal` `low` |
97
- | item_type | `epic` `task` `subtask` `bug` `spike` |
98
-
99
- ## System Labels
100
-
101
- | Label | When |
102
- |-------|------|
103
- | `project-a` | Your-app-specific work |
104
- | `project-b` | Another app work |
105
- | `cs2` | Core paradigm packages |
106
- | `hail` | Grammar, DSL compiler |
107
- | `pal` | Moment windows, memory |
108
- | `virtue` | Virtue engine, coherence |
109
- | `marketing` | Outreach, campaigns |
110
- | `media` | Assets, R2, image pipeline |
111
- | `infrastructure` | CI/CD, deployment |
112
- | `ui` | Component library |
113
- | `data` | Schema, migrations |
114
- | `content` | Copy, messaging |
115
- | `website` | Public-facing sites |
116
-
117
- ## Agent Type → Guide File Reference
118
-
119
- | Type | Guide | Use For |
120
- |------|-------|---------|
121
- | `frontend` | .rdc/guides/frontend.md | React, pages, UI, Tailwind |
122
- | `backend` | .rdc/guides/backend.md | API routes, database, auth |
123
- | `data` | .rdc/guides/data.md | Migrations, schema, RPC |
124
- | `design` | .rdc/guides/design.md | Brand, palette, OG images |
125
- | `infra` | .rdc/guides/infrastructure.md | CI/CD, deploy, DNS |
126
- | `content` | .rdc/guides/content.md | Copy, messaging, tone |
127
- | `cs2` | .rdc/guides/cs2.md | CS 2.0 paradigm |
128
- | `hail` | .rdc/guides/cs2.md + packages/hail/CLAUDE.md | Grammar, DSL |
129
- | `viz` | .rdc/guides/frontend.md + design.md | Custom visualizations |
130
-
131
- ## What NOT to Do
132
-
133
- - Never raw INSERT/UPDATE against work items — RPC functions only
134
- - Never create tasks without a parent epic
135
- - Never leave labels empty
136
- - Never write vague titles ("Fix stuff") — be specific
137
- - Never put design intention in the task — put it in `.rdc/research/` (fallback: `.rdc/research/`) and link
77
+
78
+ ## Read Tasks in an Epic
79
+
80
+ ```sql
81
+ SELECT get_work_items_by_epic('<epic-uuid>'::uuid);
82
+ SELECT get_work_items_by_epic('<epic-uuid>'::uuid, 'todo');
83
+ ```
84
+
85
+ ## Bump Epic Version
86
+
87
+ ```sql
88
+ SELECT bump_epic_version('<epic-uuid>'::uuid, '0.2.0', 'What changed', 'planning');
89
+ ```
90
+
91
+ ## Valid Values
92
+
93
+ | Field | Values |
94
+ |-------|--------|
95
+ | status | `todo` `in_progress` `blocked` `review` `done` `archived` |
96
+ | priority | `urgent` `high` `normal` `low` |
97
+ | item_type | `epic` `task` `subtask` `bug` `spike` |
98
+
99
+ ## System Labels
100
+
101
+ | Label | When |
102
+ |-------|------|
103
+ | `project-a` | Your-app-specific work |
104
+ | `project-b` | Another app work |
105
+ | `cs2` | Core paradigm packages |
106
+ | `hail` | Grammar, DSL compiler |
107
+ | `pal` | Moment windows, memory |
108
+ | `virtue` | Virtue engine, coherence |
109
+ | `marketing` | Outreach, campaigns |
110
+ | `media` | Assets, R2, image pipeline |
111
+ | `infrastructure` | CI/CD, deployment |
112
+ | `ui` | Component library |
113
+ | `data` | Schema, migrations |
114
+ | `content` | Copy, messaging |
115
+ | `website` | Public-facing sites |
116
+
117
+ ## Agent Type → Guide File Reference
118
+
119
+ | Type | Guide | Use For |
120
+ |------|-------|---------|
121
+ | `frontend` | .rdc/guides/frontend.md | React, pages, UI, Tailwind |
122
+ | `backend` | .rdc/guides/backend.md | API routes, database, auth |
123
+ | `data` | .rdc/guides/data.md | Migrations, schema, RPC |
124
+ | `design` | .rdc/guides/design.md | Brand, palette, OG images |
125
+ | `infra` | .rdc/guides/infrastructure.md | CI/CD, deploy, DNS |
126
+ | `content` | .rdc/guides/content.md | Copy, messaging, tone |
127
+ | `cs2` | .rdc/guides/cs2.md | CS 2.0 paradigm |
128
+ | `hail` | .rdc/guides/cs2.md + packages/hail/CLAUDE.md | Grammar, DSL |
129
+ | `viz` | .rdc/guides/frontend.md + design.md | Custom visualizations |
130
+
131
+ ## What NOT to Do
132
+
133
+ - Never raw INSERT/UPDATE against work items — RPC functions only
134
+ - Never create tasks without a parent epic
135
+ - Never leave labels empty
136
+ - Never write vague titles ("Fix stuff") — be specific
137
+ - Never put design intention in the task — put it in `.rdc/research/` (fallback: `.rdc/research/`) and link
package/git-sha.json CHANGED
@@ -1,3 +1,3 @@
1
1
  {
2
- "sha": "8cf6a60d35ad77a755b3309e9a99bbe4328e2e7c"
2
+ "sha": "63de440233deb666609d8b50d0cea47946e1cc2e"
3
3
  }