@lifeaitools/rdc-skills 0.24.7 → 0.24.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 (50) 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/package.json +3 -1
  31. package/scripts/self-test.mjs +1458 -1458
  32. package/skills/build/SKILL.md +554 -554
  33. package/skills/channel-formatter/SKILL.md +180 -9
  34. package/skills/collab/SKILL.md +239 -239
  35. package/skills/deploy/SKILL.md +541 -541
  36. package/skills/design/SKILL.md +205 -205
  37. package/skills/fixit/SKILL.md +165 -165
  38. package/skills/handoff/SKILL.md +200 -200
  39. package/skills/overnight/SKILL.md +251 -251
  40. package/skills/plan/SKILL.md +314 -314
  41. package/skills/preplan/SKILL.md +90 -90
  42. package/skills/prototype/SKILL.md +150 -150
  43. package/skills/release/SKILL.md +140 -140
  44. package/skills/report/SKILL.md +100 -100
  45. package/skills/review/SKILL.md +152 -152
  46. package/skills/self-test/SKILL.md +123 -123
  47. package/skills/status/SKILL.md +99 -99
  48. package/skills/watch/SKILL.md +90 -90
  49. package/skills/workitems/SKILL.md +151 -151
  50. package/tests/channel-formatter.contract.test.mjs +251 -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": "2fc0a320523abba6b5a122094627eb9c4e2e980d"
2
+ "sha": "f5ae61c0f6b40783d69bb93f6c75a46ceeff6acc"
3
3
  }