@elevasis/sdk 1.21.0 → 1.22.1

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 (160) hide show
  1. package/dist/cli.cjs +1239 -173
  2. package/dist/index.d.ts +1752 -464
  3. package/dist/index.js +3477 -143
  4. package/dist/node/index.d.ts +1 -0
  5. package/dist/node/index.js +19 -1
  6. package/dist/test-utils/index.d.ts +1188 -127
  7. package/dist/test-utils/index.js +3359 -152
  8. package/dist/worker/index.js +3148 -80
  9. package/package.json +2 -2
  10. package/reference/claude-config/hooks/post-edit-validate.mjs +98 -98
  11. package/reference/claude-config/hooks/scaffold-registry-reminder.mjs +188 -188
  12. package/reference/claude-config/hooks/tool-failure-recovery.mjs +73 -73
  13. package/reference/claude-config/registries/graph-skills.json +4 -4
  14. package/reference/claude-config/registries/knowledge-flags.json +0 -2
  15. package/reference/claude-config/rules/active-change-index.md +80 -80
  16. package/reference/claude-config/rules/agent-start-here.md +277 -277
  17. package/reference/claude-config/rules/deployment.md +57 -57
  18. package/reference/claude-config/rules/error-handling.md +56 -56
  19. package/reference/claude-config/rules/execution.md +40 -40
  20. package/reference/claude-config/rules/frontend.md +4 -4
  21. package/reference/claude-config/rules/observability.md +31 -31
  22. package/reference/claude-config/rules/operations.md +29 -17
  23. package/reference/claude-config/rules/organization-model.md +113 -81
  24. package/reference/claude-config/rules/organization-os.md +115 -113
  25. package/reference/claude-config/rules/package-taxonomy.md +33 -33
  26. package/reference/claude-config/rules/platform.md +42 -42
  27. package/reference/claude-config/rules/shared-types.md +49 -46
  28. package/reference/claude-config/rules/task-tracking.md +47 -47
  29. package/reference/claude-config/rules/ui.md +200 -200
  30. package/reference/claude-config/rules/vibe.md +235 -235
  31. package/reference/claude-config/scripts/statusline-command.js +18 -18
  32. package/reference/claude-config/settings.json +34 -34
  33. package/reference/claude-config/skills/deploy/{SKILL.md → skill.md} +156 -156
  34. package/reference/claude-config/skills/dsp/SKILL.md +66 -66
  35. package/reference/claude-config/skills/elevasis/SKILL.md +235 -235
  36. package/reference/claude-config/skills/explore/SKILL.md +6 -6
  37. package/reference/claude-config/skills/git-sync/SKILL.md +126 -126
  38. package/reference/claude-config/skills/knowledge/SKILL.md +314 -299
  39. package/reference/claude-config/skills/knowledge/operations/codify-level-a.md +100 -100
  40. package/reference/claude-config/skills/knowledge/operations/codify-level-b.md +159 -159
  41. package/reference/claude-config/skills/knowledge/operations/customers.md +109 -109
  42. package/reference/claude-config/skills/knowledge/operations/features.md +76 -76
  43. package/reference/claude-config/skills/knowledge/operations/goals.md +118 -118
  44. package/reference/claude-config/skills/knowledge/operations/identity.md +93 -93
  45. package/reference/claude-config/skills/knowledge/operations/labels.md +94 -94
  46. package/reference/claude-config/skills/knowledge/operations/offerings.md +109 -109
  47. package/reference/claude-config/skills/knowledge/operations/roles.md +99 -99
  48. package/reference/claude-config/skills/knowledge/operations/techStack.md +30 -30
  49. package/reference/claude-config/skills/project/SKILL.md +1088 -1088
  50. package/reference/claude-config/skills/run-ui/SKILL.md +73 -73
  51. package/reference/claude-config/skills/save/SKILL.md +3 -3
  52. package/reference/claude-config/skills/setup/SKILL.md +275 -275
  53. package/reference/claude-config/skills/status/SKILL.md +59 -59
  54. package/reference/claude-config/skills/submit-request/SKILL.md +180 -180
  55. package/reference/claude-config/skills/sync/SKILL.md +47 -47
  56. package/reference/claude-config/skills/tutorial/SKILL.md +259 -259
  57. package/reference/claude-config/skills/tutorial/progress-template.md +74 -74
  58. package/reference/claude-config/skills/tutorial/technical.md +1303 -1303
  59. package/reference/claude-config/skills/tutorial/vibe-coder.md +890 -890
  60. package/reference/claude-config/sync-notes/2026-04-22-git-sync-and-sync-notes.md +27 -27
  61. package/reference/claude-config/sync-notes/2026-04-22-lead-gen-deliverability-removal.md +30 -30
  62. package/reference/claude-config/sync-notes/2026-04-24-test-utils-and-template-tests.md +73 -73
  63. package/reference/claude-config/sync-notes/2026-04-24-ui-consolidation-and-sdk-cli-train.md +86 -86
  64. package/reference/claude-config/sync-notes/2026-04-25-auth-role-system-and-settings-roles.md +55 -55
  65. package/reference/claude-config/sync-notes/2026-04-27-crm-hitl-action-layer-cutover.md +97 -97
  66. package/reference/claude-config/sync-notes/2026-04-27-lead-gen-substrate-train.md +112 -112
  67. package/reference/claude-config/sync-notes/2026-04-29-crm-state-and-lead-gen-processing-status.md +93 -93
  68. package/reference/claude-config/sync-notes/2026-05-02-crm-ownership-next-action.md +58 -58
  69. package/reference/claude-config/sync-notes/2026-05-02-template-hardcode-workos-config.md +56 -56
  70. package/reference/claude-config/sync-notes/2026-05-04-elevasis-workspace.md +71 -71
  71. package/reference/claude-config/sync-notes/2026-05-04-knowledge-bundle.md +83 -83
  72. package/reference/claude-config/sync-notes/2026-05-04-template-skills-run-ui-and-tutorial.md +59 -59
  73. package/reference/claude-config/sync-notes/2026-05-05-list-builder.md +42 -42
  74. package/reference/claude-config/sync-notes/2026-05-06-crm-spine.md +60 -60
  75. package/reference/claude-config/sync-notes/2026-05-06-sdk-changes-release-train.md +37 -37
  76. package/reference/claude-config/sync-notes/2026-05-07-sdk-changes-release-train.md +34 -34
  77. package/reference/claude-config/sync-notes/2026-05-08-resource-governance-scaffold-guidance.md +38 -38
  78. package/reference/claude-config/sync-notes/2026-05-09-clients-domain.md +32 -32
  79. package/reference/claude-config/sync-notes/2026-05-09-command-system.md +33 -33
  80. package/reference/claude-config/sync-notes/2026-05-09-resource-governance-and-misc.md +69 -69
  81. package/reference/claude-config/sync-notes/2026-05-12-sdk-ready-release-train.md +30 -30
  82. package/reference/claude-config/sync-notes/2026-05-14-organization-model-ontology-refactor.md +45 -0
  83. package/reference/claude-config/sync-notes/README.md +43 -43
  84. package/reference/cli.mdx +808 -808
  85. package/reference/concepts.mdx +146 -146
  86. package/reference/deployment/api.mdx +297 -297
  87. package/reference/deployment/command-center.mdx +209 -209
  88. package/reference/deployment/index.mdx +195 -195
  89. package/reference/deployment/provided-features.mdx +107 -107
  90. package/reference/deployment/ui-execution.mdx +250 -250
  91. package/reference/examples/organization-model.ts +171 -84
  92. package/reference/framework/agent.mdx +156 -156
  93. package/reference/framework/index.mdx +195 -195
  94. package/reference/framework/interaction-guidance.mdx +182 -182
  95. package/reference/framework/memory.mdx +326 -326
  96. package/reference/framework/project-structure.mdx +282 -282
  97. package/reference/framework/tutorial-system.mdx +135 -135
  98. package/reference/getting-started.mdx +142 -142
  99. package/reference/index.mdx +106 -106
  100. package/reference/packages/core/src/README.md +14 -14
  101. package/reference/packages/core/src/business/README.md +2 -2
  102. package/reference/packages/core/src/knowledge/README.md +32 -32
  103. package/reference/packages/core/src/organization-model/README.md +149 -149
  104. package/reference/packages/core/src/test-utils/README.md +37 -37
  105. package/reference/packages/ui/src/api/README.md +18 -18
  106. package/reference/packages/ui/src/app/README.md +24 -24
  107. package/reference/packages/ui/src/auth/README.md +18 -18
  108. package/reference/packages/ui/src/components/README.md +24 -24
  109. package/reference/packages/ui/src/execution/README.md +16 -16
  110. package/reference/packages/ui/src/features/README.md +28 -28
  111. package/reference/packages/ui/src/graph/README.md +16 -16
  112. package/reference/packages/ui/src/hooks/README.md +23 -23
  113. package/reference/packages/ui/src/initialization/README.md +19 -19
  114. package/reference/packages/ui/src/knowledge/README.md +31 -31
  115. package/reference/packages/ui/src/organization/README.md +18 -18
  116. package/reference/packages/ui/src/profile/README.md +19 -19
  117. package/reference/packages/ui/src/provider/README.md +32 -32
  118. package/reference/packages/ui/src/router/README.md +18 -18
  119. package/reference/packages/ui/src/sse/README.md +13 -13
  120. package/reference/packages/ui/src/test-utils/README.md +7 -7
  121. package/reference/packages/ui/src/theme/README.md +23 -23
  122. package/reference/packages/ui/src/theme/presets/README.md +19 -19
  123. package/reference/packages/ui/src/types/README.md +16 -16
  124. package/reference/packages/ui/src/utils/README.md +18 -18
  125. package/reference/packages/ui/src/zustand/README.md +18 -18
  126. package/reference/platform-tools/adapters-integration.mdx +301 -301
  127. package/reference/platform-tools/adapters-platform.mdx +553 -553
  128. package/reference/platform-tools/index.mdx +217 -217
  129. package/reference/platform-tools/type-safety.mdx +82 -82
  130. package/reference/resources/index.mdx +349 -349
  131. package/reference/resources/patterns.mdx +449 -449
  132. package/reference/resources/types.mdx +116 -116
  133. package/reference/roadmap.mdx +165 -165
  134. package/reference/runtime.mdx +173 -173
  135. package/reference/scaffold/core/organization-graph.mdx +110 -90
  136. package/reference/scaffold/core/organization-model.mdx +225 -213
  137. package/reference/scaffold/index.mdx +67 -67
  138. package/reference/scaffold/operations/propagation-pipeline.md +77 -77
  139. package/reference/scaffold/operations/scaffold-maintenance.md +12 -12
  140. package/reference/scaffold/operations/workflow-recipes.md +138 -138
  141. package/reference/scaffold/recipes/add-a-feature.md +307 -85
  142. package/reference/scaffold/recipes/add-a-resource.md +137 -103
  143. package/reference/scaffold/recipes/customize-knowledge-browser.md +5 -5
  144. package/reference/scaffold/recipes/customize-organization-model.md +275 -138
  145. package/reference/scaffold/recipes/extend-a-base-entity.md +8 -8
  146. package/reference/scaffold/recipes/extend-crm.md +3 -3
  147. package/reference/scaffold/recipes/extend-lead-gen.md +394 -394
  148. package/reference/scaffold/recipes/gate-by-feature-or-admin.md +118 -118
  149. package/reference/scaffold/recipes/index.md +46 -46
  150. package/reference/scaffold/recipes/query-the-knowledge-graph.md +197 -170
  151. package/reference/scaffold/reference/contracts.md +2136 -2093
  152. package/reference/scaffold/reference/glossary.md +76 -76
  153. package/reference/scaffold/ui/composition-extensibility.mdx +233 -233
  154. package/reference/scaffold/ui/customization.md +243 -243
  155. package/reference/scaffold/ui/feature-flags-and-gating.md +46 -46
  156. package/reference/scaffold/ui/feature-shell.mdx +72 -72
  157. package/reference/scaffold/ui/recipes.md +221 -214
  158. package/reference/spine/spine-primer.md +96 -96
  159. package/reference/templates/index.mdx +47 -47
  160. package/reference/troubleshooting.mdx +223 -223
@@ -1,156 +1,156 @@
1
- ---
2
- name: deploy
3
- description: Test, build, fix issues, then commit and push
4
- ---
5
-
6
- # Deploy
7
-
8
- Test, build, fix issues, then commit and push.
9
-
10
- **Usage:** `/deploy [--skip] [--minor | --major] [commit message]`
11
-
12
- ## Flags
13
-
14
- - `--skip` -- Skip tests, type checking, and build (Steps 2-4). Go straight from pre-flight to commit and push.
15
- - `--minor` -- Bump the minor version instead of patch (e.g. 1.0.0 -> 1.1.0).
16
- - `--major` -- Bump the major version instead of patch (e.g. 1.0.0 -> 2.0.0).
17
-
18
- ## Process
19
-
20
- ### Step 1: Pre-flight Check
21
-
22
- Run in parallel:
23
-
24
- ```bash
25
- git status
26
- git diff --stat
27
- ```
28
-
29
- If there are no changes, report "Nothing to deploy" and stop.
30
-
31
- ### Step 1b: Version Bump
32
-
33
- Read the current version from `package.json`, then bump it:
34
-
35
- - Default: bump **patch** (e.g. 1.0.0 -> 1.0.1)
36
- - `--minor`: bump **minor** (e.g. 1.0.0 -> 1.1.0)
37
- - `--major`: bump **major** (e.g. 1.0.0 -> 2.0.0)
38
-
39
- Use the Edit tool to update the `"version"` field in `package.json` directly. Do not use `npm version` or any CLI command.
40
-
41
- ### Step 2: Run Tests
42
-
43
- ```bash
44
- pnpm test
45
- ```
46
-
47
- If tests fail:
48
-
49
- 1. Read the failing test output
50
- 2. Attempt to fix the issue
51
- 3. Re-run tests
52
- 4. If still failing after 2 attempts, stop and report the failures
53
-
54
- ### Step 3: Type Check
55
-
56
- ```bash
57
- pnpm lint
58
- ```
59
-
60
- If type errors exist:
61
-
62
- 1. Read the errors
63
- 2. Attempt to fix
64
- 3. Re-run
65
- 4. If still failing after 2 attempts, stop and report
66
-
67
- ### Step 4: Build
68
-
69
- ```bash
70
- pnpm build
71
- ```
72
-
73
- If build fails:
74
-
75
- 1. Read the error output
76
- 2. Attempt to fix
77
- 3. Re-run
78
- 4. If still failing after 2 attempts, stop and report
79
-
80
- ### Step 5: Commit
81
-
82
- 1. Stage all changed files: `git add -A`
83
- 2. Create commit with the provided message (or auto-generate from changes)
84
- 3. Format: conventional commits (feat:, fix:, chore:, docs:, etc.)
85
-
86
- ```bash
87
- git add -A
88
- git commit -m "<message>"
89
- ```
90
-
91
- ### Step 6: Push
92
-
93
- ```bash
94
- git push
95
- ```
96
-
97
- If push fails (e.g., remote has new commits):
98
-
99
- 1. `git pull --rebase`
100
- 2. Re-run tests to verify no conflicts broke anything
101
- 3. `git push`
102
-
103
- ### Step 7: Report
104
-
105
- ```
106
- Deploy Complete
107
- ===============
108
- Version: <old> -> <new>
109
- Tests: passed
110
- Types: clean
111
- Build: success
112
- Commit: <hash> - <message>
113
- Push: pushed to <branch>
114
- ```
115
-
116
- ### Step 8: Project Task Status Transition
117
-
118
- After a successful push, mark any linked project task as `submitted`. This is a best-effort fanout -- it must never fail the deploy.
119
-
120
- 1. **Resolve the task ID.** Look for a `prj_tasks` UUID tied to the current work, in this order:
121
- - A task UUID explicitly captured in the current conversation (e.g. from a previous `/save`, `/project work`, or `project:task:*` invocation).
122
- - The most recent in-progress task on the most-recently-touched project, via:
123
-
124
- ```bash
125
- pnpm elevasis-sdk project:list --status active --pretty
126
- pnpm elevasis-sdk project:list --status blocked --pretty
127
- pnpm elevasis-sdk project:task:list --project <project-id> --status in_progress --pretty
128
- ```
129
-
130
- - If the session produced an ambiguous or empty result, PROMPT the user once: "Mark a project task as submitted? (task UUID, or 'skip')". Default is skip.
131
-
132
- 2. **Fire the transition** (only when a single confident task ID is resolved):
133
-
134
- ```bash
135
- pnpm elevasis-sdk project:task:update <task-id> --status submitted
136
- ```
137
-
138
- 3. **Failure handling.** If the CLI call errors, no task ID can be resolved, or the user declines, emit a single warning line and continue:
139
-
140
- ```
141
- Warning: skipped project:task status transition (<reason>). Deploy itself succeeded.
142
- ```
143
-
144
- Never retry, never block the deploy report, never exit non-zero on this step.
145
-
146
- ## Error Recovery
147
-
148
- If any step fails and cannot be auto-fixed:
149
-
150
- ```
151
- Deploy Failed at Step N: [step name]
152
- =====================================
153
- Error: [description]
154
- Attempted fixes: [what was tried]
155
- Manual action needed: [what the user should do]
156
- ```
1
+ ---
2
+ name: deploy
3
+ description: Test, build, fix issues, then commit and push
4
+ ---
5
+
6
+ # Deploy
7
+
8
+ Test, build, fix issues, then commit and push.
9
+
10
+ **Usage:** `/deploy [--skip] [--minor | --major] [commit message]`
11
+
12
+ ## Flags
13
+
14
+ - `--skip` -- Skip tests, type checking, and build (Steps 2-4). Go straight from pre-flight to commit and push.
15
+ - `--minor` -- Bump the minor version instead of patch (e.g. 1.0.0 -> 1.1.0).
16
+ - `--major` -- Bump the major version instead of patch (e.g. 1.0.0 -> 2.0.0).
17
+
18
+ ## Process
19
+
20
+ ### Step 1: Pre-flight Check
21
+
22
+ Run in parallel:
23
+
24
+ ```bash
25
+ git status
26
+ git diff --stat
27
+ ```
28
+
29
+ If there are no changes, report "Nothing to deploy" and stop.
30
+
31
+ ### Step 1b: Version Bump
32
+
33
+ Read the current version from `package.json`, then bump it:
34
+
35
+ - Default: bump **patch** (e.g. 1.0.0 -> 1.0.1)
36
+ - `--minor`: bump **minor** (e.g. 1.0.0 -> 1.1.0)
37
+ - `--major`: bump **major** (e.g. 1.0.0 -> 2.0.0)
38
+
39
+ Use the Edit tool to update the `"version"` field in `package.json` directly. Do not use `npm version` or any CLI command.
40
+
41
+ ### Step 2: Run Tests
42
+
43
+ ```bash
44
+ pnpm test
45
+ ```
46
+
47
+ If tests fail:
48
+
49
+ 1. Read the failing test output
50
+ 2. Attempt to fix the issue
51
+ 3. Re-run tests
52
+ 4. If still failing after 2 attempts, stop and report the failures
53
+
54
+ ### Step 3: Type Check
55
+
56
+ ```bash
57
+ pnpm lint
58
+ ```
59
+
60
+ If type errors exist:
61
+
62
+ 1. Read the errors
63
+ 2. Attempt to fix
64
+ 3. Re-run
65
+ 4. If still failing after 2 attempts, stop and report
66
+
67
+ ### Step 4: Build
68
+
69
+ ```bash
70
+ pnpm build
71
+ ```
72
+
73
+ If build fails:
74
+
75
+ 1. Read the error output
76
+ 2. Attempt to fix
77
+ 3. Re-run
78
+ 4. If still failing after 2 attempts, stop and report
79
+
80
+ ### Step 5: Commit
81
+
82
+ 1. Stage all changed files: `git add -A`
83
+ 2. Create commit with the provided message (or auto-generate from changes)
84
+ 3. Format: conventional commits (feat:, fix:, chore:, docs:, etc.)
85
+
86
+ ```bash
87
+ git add -A
88
+ git commit -m "<message>"
89
+ ```
90
+
91
+ ### Step 6: Push
92
+
93
+ ```bash
94
+ git push
95
+ ```
96
+
97
+ If push fails (e.g., remote has new commits):
98
+
99
+ 1. `git pull --rebase`
100
+ 2. Re-run tests to verify no conflicts broke anything
101
+ 3. `git push`
102
+
103
+ ### Step 7: Report
104
+
105
+ ```
106
+ Deploy Complete
107
+ ===============
108
+ Version: <old> -> <new>
109
+ Tests: passed
110
+ Types: clean
111
+ Build: success
112
+ Commit: <hash> - <message>
113
+ Push: pushed to <branch>
114
+ ```
115
+
116
+ ### Step 8: Project Task Status Transition
117
+
118
+ After a successful push, mark any linked project task as `submitted`. This is a best-effort fanout -- it must never fail the deploy.
119
+
120
+ 1. **Resolve the task ID.** Look for a `prj_tasks` UUID tied to the current work, in this order:
121
+ - A task UUID explicitly captured in the current conversation (e.g. from a previous `/save`, `/project work`, or `project:task:*` invocation).
122
+ - The most recent in-progress task on the most-recently-touched project, via:
123
+
124
+ ```bash
125
+ pnpm elevasis-sdk project:list --status active --pretty
126
+ pnpm elevasis-sdk project:list --status blocked --pretty
127
+ pnpm elevasis-sdk project:task:list --project <project-id> --status in_progress --pretty
128
+ ```
129
+
130
+ - If the session produced an ambiguous or empty result, PROMPT the user once: "Mark a project task as submitted? (task UUID, or 'skip')". Default is skip.
131
+
132
+ 2. **Fire the transition** (only when a single confident task ID is resolved):
133
+
134
+ ```bash
135
+ pnpm elevasis-sdk project:task:update <task-id> --status submitted
136
+ ```
137
+
138
+ 3. **Failure handling.** If the CLI call errors, no task ID can be resolved, or the user declines, emit a single warning line and continue:
139
+
140
+ ```
141
+ Warning: skipped project:task status transition (<reason>). Deploy itself succeeded.
142
+ ```
143
+
144
+ Never retry, never block the deploy report, never exit non-zero on this step.
145
+
146
+ ## Error Recovery
147
+
148
+ If any step fails and cannot be auto-fixed:
149
+
150
+ ```
151
+ Deploy Failed at Step N: [step name]
152
+ =====================================
153
+ Error: [description]
154
+ Attempted fixes: [what was tried]
155
+ Manual action needed: [what the user should do]
156
+ ```
@@ -1,66 +1,66 @@
1
- ---
2
- name: dsp
3
- description: Dispatch subagents in parallel for implementation tasks
4
- ---
5
-
6
- # DSP -- Dispatch Subagents in Parallel
7
-
8
- Parallel agent dispatch for implementation tasks. Orchestrate, then delegate to subagents.
9
-
10
- **Usage:** `/dsp <instructions>`
11
-
12
- ## Rules
13
-
14
- 1. **Always dispatch, never self-execute** -- the purpose is to offload work to subagents
15
- 2. **Parallel within waves** -- all agents in a wave dispatched in a SINGLE message
16
- 3. **Orient first** -- read `.claude/rules/agent-start-here.md` before planning to understand project structure and task routing
17
-
18
- ## Process
19
-
20
- ### Step 1: Understand Context
21
-
22
- 1. Read `.claude/rules/agent-start-here.md` for project structure, task-class routing, and boundary resolution
23
- 2. Read relevant architecture/feature docs based on the task domain
24
- 3. If the task touches code, explore the relevant `src/` directories
25
-
26
- ### Step 2: Analyze Complexity
27
-
28
- **Single-Wave** -- all tasks independent, dispatch everything at once
29
- **Multi-Wave** -- tasks have dependencies, execute waves sequentially
30
-
31
- ### Step 3: Plan
32
-
33
- For each unit of work, identify:
34
-
35
- - What files/areas are affected
36
- - What context the subagent needs
37
- - Whether it depends on another task's output
38
-
39
- Print the plan:
40
-
41
- ```
42
- DSP Plan: N waves, M tasks
43
- Wave 1: [description] -- N tasks
44
- Wave 2: [description] -- N tasks (if multi-wave)
45
- Dispatching Wave 1...
46
- ```
47
-
48
- ### Step 4: Dispatch
49
-
50
- Use the Agent tool with `subagent_type="general-purpose"` and `model="sonnet"`.
51
-
52
- Each agent prompt must include:
53
-
54
- - The specific task to accomplish
55
- - Relevant file paths and context
56
- - Instruction to use backslash paths for file operations on Windows
57
-
58
- ### Step 5: Aggregate Results
59
-
60
- ```
61
- DSP Results: [description]
62
-
63
- Tasks completed: X/Y
64
- Files modified: [list]
65
- Next steps: [if any]
66
- ```
1
+ ---
2
+ name: dsp
3
+ description: Dispatch subagents in parallel for implementation tasks
4
+ ---
5
+
6
+ # DSP -- Dispatch Subagents in Parallel
7
+
8
+ Parallel agent dispatch for implementation tasks. Orchestrate, then delegate to subagents.
9
+
10
+ **Usage:** `/dsp <instructions>`
11
+
12
+ ## Rules
13
+
14
+ 1. **Always dispatch, never self-execute** -- the purpose is to offload work to subagents
15
+ 2. **Parallel within waves** -- all agents in a wave dispatched in a SINGLE message
16
+ 3. **Orient first** -- read `.claude/rules/agent-start-here.md` before planning to understand project structure and task routing
17
+
18
+ ## Process
19
+
20
+ ### Step 1: Understand Context
21
+
22
+ 1. Read `.claude/rules/agent-start-here.md` for project structure, task-class routing, and boundary resolution
23
+ 2. Read relevant architecture/feature docs based on the task domain
24
+ 3. If the task touches code, explore the relevant `src/` directories
25
+
26
+ ### Step 2: Analyze Complexity
27
+
28
+ **Single-Wave** -- all tasks independent, dispatch everything at once
29
+ **Multi-Wave** -- tasks have dependencies, execute waves sequentially
30
+
31
+ ### Step 3: Plan
32
+
33
+ For each unit of work, identify:
34
+
35
+ - What files/areas are affected
36
+ - What context the subagent needs
37
+ - Whether it depends on another task's output
38
+
39
+ Print the plan:
40
+
41
+ ```
42
+ DSP Plan: N waves, M tasks
43
+ Wave 1: [description] -- N tasks
44
+ Wave 2: [description] -- N tasks (if multi-wave)
45
+ Dispatching Wave 1...
46
+ ```
47
+
48
+ ### Step 4: Dispatch
49
+
50
+ Use the Agent tool with `subagent_type="general-purpose"` and `model="sonnet"`.
51
+
52
+ Each agent prompt must include:
53
+
54
+ - The specific task to accomplish
55
+ - Relevant file paths and context
56
+ - Instruction to use backslash paths for file operations on Windows
57
+
58
+ ### Step 5: Aggregate Results
59
+
60
+ ```
61
+ DSP Results: [description]
62
+
63
+ Tasks completed: X/Y
64
+ Files modified: [list]
65
+ Next steps: [if any]
66
+ ```