@lifeaitools/rdc-skills 0.25.2 → 0.25.3

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 (61) hide show
  1. package/.claude-plugin/plugin.json +1560 -1560
  2. package/.github/workflows/self-test.yml +34 -34
  3. package/CHANGELOG.md +322 -322
  4. package/MANIFEST.md +224 -224
  5. package/README.md +379 -379
  6. package/RELEASE.md +49 -0
  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/package.json +57 -57
  33. package/scripts/install-rdc-skills.js +1401 -1401
  34. package/scripts/self-test.mjs +1460 -1460
  35. package/scripts/validate-publish-manifests.js +502 -502
  36. package/skills/build/SKILL.md +559 -559
  37. package/skills/channel-formatter/SKILL.md +538 -538
  38. package/skills/collab/SKILL.md +239 -239
  39. package/skills/convert/SKILL.md +167 -167
  40. package/skills/deploy/SKILL.md +541 -541
  41. package/skills/design/SKILL.md +205 -205
  42. package/skills/env/SKILL.md +139 -141
  43. package/skills/fixit/SKILL.md +203 -203
  44. package/skills/handoff/SKILL.md +236 -236
  45. package/skills/housekeeping/SKILL.md +1 -1
  46. package/skills/onramp/SKILL.md +1459 -1459
  47. package/skills/overnight/SKILL.md +251 -251
  48. package/skills/plan/SKILL.md +345 -345
  49. package/skills/preplan/SKILL.md +90 -90
  50. package/skills/prototype/SKILL.md +150 -150
  51. package/skills/regen-media/SKILL.md +94 -94
  52. package/skills/release/SKILL.md +140 -140
  53. package/skills/report/SKILL.md +100 -100
  54. package/skills/review/SKILL.md +151 -151
  55. package/skills/self-test/SKILL.md +108 -108
  56. package/skills/status/SKILL.md +99 -99
  57. package/skills/tests/MATRIX.md +55 -55
  58. package/skills/tests/onramp.test.json +87 -87
  59. package/skills/tests/rdc-regen-media.test.json +29 -29
  60. package/skills/watch/SKILL.md +84 -84
  61. package/skills/workitems/SKILL.md +151 -151
@@ -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": "721879cc114100736cd99acbfeee09a5ece2fbd8"
2
+ "sha": "7a77a9d962212b9731c805820f4f59127fe9ca9b"
3
3
  }