@lifeaitools/rdc-skills 0.24.6 → 0.24.8

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 (51) hide show
  1. package/.claude-plugin/plugin.json +20 -5
  2. package/.github/workflows/self-test.yml +34 -34
  3. package/MANIFEST.md +23 -0
  4. package/README.md +37 -0
  5. package/commands/build.md +181 -181
  6. package/commands/collab.md +180 -180
  7. package/commands/deploy.md +148 -148
  8. package/commands/fixit.md +105 -105
  9. package/commands/handoff.md +173 -173
  10. package/commands/overnight.md +218 -218
  11. package/commands/plan.md +158 -158
  12. package/commands/preplan.md +131 -131
  13. package/commands/prototype.md +145 -145
  14. package/commands/report.md +99 -99
  15. package/commands/review.md +120 -120
  16. package/commands/status.md +86 -86
  17. package/commands/workitems.md +127 -127
  18. package/git-sha.json +1 -1
  19. package/guides/agent-bootstrap.md +195 -195
  20. package/guides/agents/backend.md +102 -102
  21. package/guides/agents/content.md +94 -94
  22. package/guides/agents/cs2.md +56 -56
  23. package/guides/agents/data.md +86 -86
  24. package/guides/agents/design.md +77 -77
  25. package/guides/agents/frontend.md +91 -91
  26. package/guides/agents/infrastructure.md +81 -81
  27. package/guides/agents/setup.md +272 -272
  28. package/guides/agents/verify.md +119 -119
  29. package/guides/agents/viz.md +106 -106
  30. package/hooks/task-completed-gate.js +25 -3
  31. package/package.json +1 -1
  32. package/scripts/self-test.mjs +1458 -1458
  33. package/skills/build/SKILL.md +554 -554
  34. package/skills/channel-formatter/SKILL.md +174 -9
  35. package/skills/collab/SKILL.md +239 -239
  36. package/skills/deploy/SKILL.md +541 -541
  37. package/skills/design/SKILL.md +205 -205
  38. package/skills/fixit/SKILL.md +165 -165
  39. package/skills/handoff/SKILL.md +200 -200
  40. package/skills/overnight/SKILL.md +251 -251
  41. package/skills/plan/SKILL.md +314 -314
  42. package/skills/preplan/SKILL.md +90 -90
  43. package/skills/prototype/SKILL.md +150 -150
  44. package/skills/release/SKILL.md +140 -140
  45. package/skills/report/SKILL.md +100 -100
  46. package/skills/review/SKILL.md +152 -152
  47. package/skills/self-test/SKILL.md +123 -123
  48. package/skills/status/SKILL.md +99 -99
  49. package/skills/watch/SKILL.md +90 -90
  50. package/skills/workitems/SKILL.md +151 -151
  51. package/tests/harness-gates.test.mjs +30 -0
@@ -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": "c7ae6c2095cf0f711bf4740bc82adbdb805ab966"
2
+ "sha": "f6df094e61e5c0ece0ac8149e97142c78d04a21c"
3
3
  }