@builderos/create-agent-os 0.0.2

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 (194) hide show
  1. package/README.md +39 -0
  2. package/bin/cli.js +133 -0
  3. package/package.json +40 -0
  4. package/src/template/App.tsx +68 -0
  5. package/src/template/agent-os/commands/create-tasks/1-get-spec-requirements.md +19 -0
  6. package/src/template/agent-os/commands/create-tasks/2-create-tasks-list.md +234 -0
  7. package/src/template/agent-os/commands/create-tasks/create-tasks.md +254 -0
  8. package/src/template/agent-os/commands/design-screen/design-screen.md +32 -0
  9. package/src/template/agent-os/commands/design-shell/design-shell.md +34 -0
  10. package/src/template/agent-os/commands/design-tokens/design-tokens.md +36 -0
  11. package/src/template/agent-os/commands/export-product/export-product.md +44 -0
  12. package/src/template/agent-os/commands/implement-tasks/1-determine-tasks.md +13 -0
  13. package/src/template/agent-os/commands/implement-tasks/2-implement-tasks.md +63 -0
  14. package/src/template/agent-os/commands/implement-tasks/3-verify-implementation.md +113 -0
  15. package/src/template/agent-os/commands/implement-tasks/implement-tasks.md +207 -0
  16. package/src/template/agent-os/commands/initialize-design/initialize-design.md +54 -0
  17. package/src/template/agent-os/commands/orchestrate-tasks/orchestrate-tasks.md +180 -0
  18. package/src/template/agent-os/commands/plan-product/1-product-concept.md +53 -0
  19. package/src/template/agent-os/commands/plan-product/2-create-mission.md +78 -0
  20. package/src/template/agent-os/commands/plan-product/3-create-roadmap.md +73 -0
  21. package/src/template/agent-os/commands/plan-product/4-create-tech-stack.md +46 -0
  22. package/src/template/agent-os/commands/plan-product/plan-product.md +241 -0
  23. package/src/template/agent-os/commands/sample-data/sample-data.md +51 -0
  24. package/src/template/agent-os/commands/scaffold-implementation/scaffold-implementation.md +36 -0
  25. package/src/template/agent-os/commands/screenshot-design/screenshot-design.md +21 -0
  26. package/src/template/agent-os/commands/shape-spec/1-initialize-spec.md +95 -0
  27. package/src/template/agent-os/commands/shape-spec/2-shape-spec.md +300 -0
  28. package/src/template/agent-os/commands/shape-spec/shape-spec.md +40 -0
  29. package/src/template/agent-os/commands/write-spec/write-spec.md +134 -0
  30. package/src/template/agent-os/config.yml +13 -0
  31. package/src/template/agent-os/product/mission.md +29 -0
  32. package/src/template/agent-os/product/roadmap.md +9 -0
  33. package/src/template/agent-os/product/tech-stack.md +14 -0
  34. package/src/template/agent-os/specs/README.md +1 -0
  35. package/src/template/agent-os/standards/backend/api.md +10 -0
  36. package/src/template/agent-os/standards/backend/migrations.md +9 -0
  37. package/src/template/agent-os/standards/backend/models.md +10 -0
  38. package/src/template/agent-os/standards/backend/queries.md +9 -0
  39. package/src/template/agent-os/standards/frontend/accessibility.md +10 -0
  40. package/src/template/agent-os/standards/frontend/components.md +11 -0
  41. package/src/template/agent-os/standards/frontend/css.md +7 -0
  42. package/src/template/agent-os/standards/frontend/responsive.md +11 -0
  43. package/src/template/agent-os/standards/global/coding-style.md +10 -0
  44. package/src/template/agent-os/standards/global/commenting.md +5 -0
  45. package/src/template/agent-os/standards/global/conventions.md +11 -0
  46. package/src/template/agent-os/standards/global/error-handling.md +9 -0
  47. package/src/template/agent-os/standards/global/tech-stack.md +31 -0
  48. package/src/template/agent-os/standards/global/validation.md +11 -0
  49. package/src/template/agent-os/standards/testing/test-writing.md +9 -0
  50. package/src/template/agent-os-ui/README.md +73 -0
  51. package/src/template/agent-os-ui/package-lock.json +5028 -0
  52. package/src/template/agent-os-ui/package.json +52 -0
  53. package/src/template/agent-os-ui/postcss.config.js +6 -0
  54. package/src/template/agent-os-ui/src/components/AgentShell.tsx +31 -0
  55. package/src/template/agent-os-ui/src/components/AgentSidebar.tsx +65 -0
  56. package/src/template/agent-os-ui/src/components/GuidanceCard.tsx +75 -0
  57. package/src/template/agent-os-ui/src/components/MarkdownViewer.tsx +25 -0
  58. package/src/template/agent-os-ui/src/components/PromptButton.tsx +28 -0
  59. package/src/template/agent-os-ui/src/components/StatusItem.tsx +45 -0
  60. package/src/template/agent-os-ui/src/components/ThemeToggle.tsx +72 -0
  61. package/src/template/agent-os-ui/src/index.ts +11 -0
  62. package/src/template/agent-os-ui/src/style.css +3 -0
  63. package/src/template/agent-os-ui/tailwind.config.js +50 -0
  64. package/src/template/agent-os-ui/tsconfig.json +33 -0
  65. package/src/template/agent-os-ui/vite.config.ts +32 -0
  66. package/src/template/control-center/backend/backend.log +2 -0
  67. package/src/template/control-center/backend/index.js +228 -0
  68. package/src/template/control-center/backend/package-lock.json +951 -0
  69. package/src/template/control-center/backend/package.json +19 -0
  70. package/src/template/control-center/frontend/README.md +73 -0
  71. package/src/template/control-center/frontend/eslint.config.js +23 -0
  72. package/src/template/control-center/frontend/index.html +21 -0
  73. package/src/template/control-center/frontend/package-lock.json +5752 -0
  74. package/src/template/control-center/frontend/package.json +42 -0
  75. package/src/template/control-center/frontend/public/runtime-config.json +11 -0
  76. package/src/template/control-center/frontend/public/vite.svg +1 -0
  77. package/src/template/control-center/frontend/src/App.css +42 -0
  78. package/src/template/control-center/frontend/src/App.tsx +738 -0
  79. package/src/template/control-center/frontend/src/assets/react.svg +1 -0
  80. package/src/template/control-center/frontend/src/components/ThemeToggle.tsx +64 -0
  81. package/src/template/control-center/frontend/src/components/ui/ToastContext.tsx +81 -0
  82. package/src/template/control-center/frontend/src/index.css +194 -0
  83. package/src/template/control-center/frontend/src/main.tsx +14 -0
  84. package/src/template/control-center/frontend/src/vite-env.d.ts +1 -0
  85. package/src/template/control-center/frontend/tsconfig.app.json +28 -0
  86. package/src/template/control-center/frontend/tsconfig.json +7 -0
  87. package/src/template/control-center/frontend/tsconfig.node.json +26 -0
  88. package/src/template/control-center/frontend/vite.config.ts +22 -0
  89. package/src/template/design/.claude/commands/design-os/data-model.md +122 -0
  90. package/src/template/design/.claude/commands/design-os/design-screen.md +309 -0
  91. package/src/template/design/.claude/commands/design-os/design-shell.md +238 -0
  92. package/src/template/design/.claude/commands/design-os/design-tokens.md +166 -0
  93. package/src/template/design/.claude/commands/design-os/export-product.md +1105 -0
  94. package/src/template/design/.claude/commands/design-os/product-roadmap.md +121 -0
  95. package/src/template/design/.claude/commands/design-os/product-vision.md +99 -0
  96. package/src/template/design/.claude/commands/design-os/sample-data.md +263 -0
  97. package/src/template/design/.claude/commands/design-os/screenshot-design.md +112 -0
  98. package/src/template/design/.claude/commands/design-os/shape-section.md +138 -0
  99. package/src/template/design/.claude/skills/frontend-design/SKILL.md +42 -0
  100. package/src/template/design/.github/CODE_OF_CONDUCT.md +5 -0
  101. package/src/template/design/.github/CONTRIBUTING.md +51 -0
  102. package/src/template/design/.github/ISSUE_TEMPLATE/config.yml +22 -0
  103. package/src/template/design/.github/PULL_REQUEST_TEMPLATE.md +20 -0
  104. package/src/template/design/.github/SECURITY.yml +5 -0
  105. package/src/template/design/.github/SUPPORT.md +19 -0
  106. package/src/template/design/.github/workflows/pr-decline.yml +135 -0
  107. package/src/template/design/.github/workflows/stale.yml +25 -0
  108. package/src/template/design/CHANGELOG.md +13 -0
  109. package/src/template/design/LICENSE +21 -0
  110. package/src/template/design/README.md +54 -0
  111. package/src/template/design/agents.md +218 -0
  112. package/src/template/design/claude.md +1 -0
  113. package/src/template/design/components.json +22 -0
  114. package/src/template/design/docs/codebase-implementation.md +153 -0
  115. package/src/template/design/docs/design-section.md +135 -0
  116. package/src/template/design/docs/export.md +149 -0
  117. package/src/template/design/docs/getting-started.md +59 -0
  118. package/src/template/design/docs/index.md +56 -0
  119. package/src/template/design/docs/product-planning.md +113 -0
  120. package/src/template/design/docs/requirements.md +22 -0
  121. package/src/template/design/docs/usage.md +62 -0
  122. package/src/template/design/eslint.config.js +23 -0
  123. package/src/template/design/index.html +21 -0
  124. package/src/template/design/package-lock.json +5473 -0
  125. package/src/template/design/package.json +47 -0
  126. package/src/template/design/product-plan.zip +0 -0
  127. package/src/template/design/public/vite.svg +1 -0
  128. package/src/template/design/src/assets/react.svg +1 -0
  129. package/src/template/design/src/components/AppLayout.tsx +95 -0
  130. package/src/template/design/src/components/DataCard.tsx +139 -0
  131. package/src/template/design/src/components/DataModelPage.tsx +120 -0
  132. package/src/template/design/src/components/DesignPage.tsx +284 -0
  133. package/src/template/design/src/components/EmptyState.tsx +155 -0
  134. package/src/template/design/src/components/ExportPage.tsx +344 -0
  135. package/src/template/design/src/components/NextPhaseButton.tsx +33 -0
  136. package/src/template/design/src/components/PhaseNav.tsx +152 -0
  137. package/src/template/design/src/components/PhaseWarningBanner.tsx +81 -0
  138. package/src/template/design/src/components/ProductOverviewCard.tsx +102 -0
  139. package/src/template/design/src/components/ProductPage.tsx +97 -0
  140. package/src/template/design/src/components/ScreenDesignPage.tsx +370 -0
  141. package/src/template/design/src/components/ScreenDesignsCard.tsx +49 -0
  142. package/src/template/design/src/components/SectionPage.tsx +256 -0
  143. package/src/template/design/src/components/SectionsCard.tsx +47 -0
  144. package/src/template/design/src/components/SectionsPage.tsx +181 -0
  145. package/src/template/design/src/components/ShellCard.tsx +85 -0
  146. package/src/template/design/src/components/ShellDesignPage.tsx +242 -0
  147. package/src/template/design/src/components/SpecCard.tsx +121 -0
  148. package/src/template/design/src/components/StepIndicator.tsx +75 -0
  149. package/src/template/design/src/components/ThemeToggle.tsx +86 -0
  150. package/src/template/design/src/components/ui/ToastContext.tsx +81 -0
  151. package/src/template/design/src/components/ui/avatar.tsx +53 -0
  152. package/src/template/design/src/components/ui/badge.tsx +46 -0
  153. package/src/template/design/src/components/ui/button.tsx +60 -0
  154. package/src/template/design/src/components/ui/card.tsx +92 -0
  155. package/src/template/design/src/components/ui/collapsible.tsx +48 -0
  156. package/src/template/design/src/components/ui/dialog.tsx +143 -0
  157. package/src/template/design/src/components/ui/dropdown-menu.tsx +255 -0
  158. package/src/template/design/src/components/ui/input.tsx +21 -0
  159. package/src/template/design/src/components/ui/label.tsx +22 -0
  160. package/src/template/design/src/components/ui/progress.tsx +24 -0
  161. package/src/template/design/src/components/ui/scroll-area.tsx +18 -0
  162. package/src/template/design/src/components/ui/select.tsx +67 -0
  163. package/src/template/design/src/components/ui/separator.tsx +28 -0
  164. package/src/template/design/src/components/ui/sheet.tsx +137 -0
  165. package/src/template/design/src/components/ui/skeleton.tsx +13 -0
  166. package/src/template/design/src/components/ui/switch.tsx +46 -0
  167. package/src/template/design/src/components/ui/table.tsx +116 -0
  168. package/src/template/design/src/components/ui/tabs.tsx +64 -0
  169. package/src/template/design/src/index.css +284 -0
  170. package/src/template/design/src/lib/data-model-loader.ts +91 -0
  171. package/src/template/design/src/lib/design-system-loader.ts +101 -0
  172. package/src/template/design/src/lib/product-loader.ts +221 -0
  173. package/src/template/design/src/lib/router.tsx +52 -0
  174. package/src/template/design/src/lib/section-loader.ts +272 -0
  175. package/src/template/design/src/lib/shell-loader.ts +175 -0
  176. package/src/template/design/src/lib/utils.ts +6 -0
  177. package/src/template/design/src/main.tsx +15 -0
  178. package/src/template/design/src/sections/.gitkeep +0 -0
  179. package/src/template/design/src/sections/ai-orchestration-engine-oai/OrchestrationEngine.tsx +348 -0
  180. package/src/template/design/src/sections/core-platform-shell/AppShell.tsx +403 -0
  181. package/src/template/design/src/sections/gemini-live-integration/GeminiIntegration.tsx +332 -0
  182. package/src/template/design/src/sections/interactive-2d-canvas/WhiteboardCanvas.tsx +334 -0
  183. package/src/template/design/src/sections/participation-equity-tracker/EquityTracker.tsx +383 -0
  184. package/src/template/design/src/sections/persistent-memory-system/PersistentMemory.tsx +308 -0
  185. package/src/template/design/src/sections/real-time-communication-layer/VideoSession.tsx +342 -0
  186. package/src/template/design/src/sections/visual-intelligence-agents/VisualAgents.tsx +311 -0
  187. package/src/template/design/src/types/product.ts +97 -0
  188. package/src/template/design/src/types/section.ts +33 -0
  189. package/src/template/design/tsconfig.app.json +34 -0
  190. package/src/template/design/tsconfig.json +13 -0
  191. package/src/template/design/tsconfig.node.json +26 -0
  192. package/src/template/design/vite.config.ts +18 -0
  193. package/src/template/package.json +27 -0
  194. package/src/template/vite.config.ts +16 -0
@@ -0,0 +1,207 @@
1
+ Now that we have a spec and tasks list ready for implementation, we will proceed with implementation of this spec by following this multi-phase process:
2
+
3
+ PHASE 1: Determine which task group(s) from tasks.md should be implemented
4
+ PHASE 2: Implement the given task(s)
5
+ PHASE 3: After ALL task groups have been implemented, produce the final verification report.
6
+
7
+ Carefully read and execute the instructions in the following files IN SEQUENCE, following their numbered file names. Only proceed to the next numbered instruction file once the previous numbered instruction has been executed.
8
+
9
+ Instructions to follow in sequence:
10
+
11
+ # PHASE 1: Determine Tasks
12
+
13
+ First, check if the user has already provided instructions about which task group(s) to implement.
14
+
15
+ **If the user HAS provided instructions:** Proceed to PHASE 2 to delegate implementation of those specified task group(s) to the **implementer** subagent.
16
+
17
+ **If the user has NOT provided instructions:**
18
+
19
+ Read `agent-os/specs/[this-spec]/tasks.md` to review the available task groups, then output the following message to the user and WAIT for their response:
20
+
21
+ ```
22
+ Should we proceed with implementation of all task groups in tasks.md?
23
+
24
+ If not, then please specify which task(s) to implement.
25
+ ```
26
+
27
+ # PHASE 2: Implement Tasks
28
+
29
+ Now that you have the task group(s) to be implemented, proceed with implementation by following these instructions:
30
+
31
+ Implement all tasks assigned to you and ONLY those task(s) that have been assigned to you.
32
+
33
+ ## Implementation process:
34
+
35
+ 1. Analyze the provided spec.md, requirements.md, and visuals (if any)
36
+ 2. Analyze patterns in the codebase according to its built-in workflow
37
+ 3. Implement the assigned task group according to requirements and standards
38
+ 4. Update `agent-os/specs/[this-spec]/tasks.md` to update the tasks you've implemented to mark that as done by updating their checkbox to checked state: `- [x]`
39
+
40
+ ## Guide your implementation using:
41
+ - **The existing patterns** that you've found and analyzed in the codebase.
42
+ - **Specific notes provided in requirements.md, spec.md AND/OR tasks.md**
43
+ - **Visuals provided (if any)** which would be located in `agent-os/specs/[this-spec]/planning/visuals/`
44
+ - **User Standards & Preferences** which are defined below.
45
+
46
+ ## Self-verify and test your work by:
47
+ - Running ONLY the tests you've written (if any) and ensuring those tests pass.
48
+ - IF your task involves user-facing UI, and IF you have access to browser testing tools, open a browser and use the feature you've implemented as if you are a user to ensure a user can use the feature in the intended way.
49
+ - Take screenshots of the views and UI elements you've tested and store those in `agent-os/specs/[this-spec]/verification/screenshots/`. Do not store screenshots anywhere else in the codebase other than this location.
50
+ - Analyze the screenshot(s) you've taken to check them against your current requirements.
51
+
52
+
53
+ ## Display confirmation and next step
54
+
55
+ Display a summary of what was implemented.
56
+
57
+ IF all tasks are now marked as done (with `- [x]`) in tasks.md, display this message to user:
58
+
59
+ ```
60
+ All tasks have been implemented: `agent-os/specs/[this-spec]/tasks.md`.
61
+
62
+ NEXT STEP 👉 Run `3-verify-implementation.md` to verify the implementation.
63
+ ```
64
+
65
+ IF there are still tasks in tasks.md that have yet to be implemented (marked unfinished with `- [ ]`) then display this message to user:
66
+
67
+ ```
68
+ Would you like to proceed with implementation of the remaining tasks in tasks.md?
69
+
70
+ If not, please specify which task group(s) to implement next.
71
+ ```
72
+
73
+ ## User Standards & Preferences Compliance
74
+
75
+ IMPORTANT: Ensure that the tasks list is ALIGNED and DOES NOT CONFLICT with the user's preferences and standards as detailed in the following files:
76
+
77
+ @agent-os/standards/backend/api.md
78
+ @agent-os/standards/backend/migrations.md
79
+ @agent-os/standards/backend/models.md
80
+ @agent-os/standards/backend/queries.md
81
+ @agent-os/standards/frontend/accessibility.md
82
+ @agent-os/standards/frontend/components.md
83
+ @agent-os/standards/frontend/css.md
84
+ @agent-os/standards/frontend/responsive.md
85
+ @agent-os/standards/global/coding-style.md
86
+ @agent-os/standards/global/commenting.md
87
+ @agent-os/standards/global/conventions.md
88
+ @agent-os/standards/global/error-handling.md
89
+ @agent-os/standards/global/tech-stack.md
90
+ @agent-os/standards/global/validation.md
91
+ @agent-os/standards/testing/test-writing.md
92
+
93
+ # PHASE 3: Verify Implementation
94
+
95
+ Now that we've implemented all tasks in tasks.md, we must run final verifications and produce a verification report using the following MULTI-PHASE workflow:
96
+
97
+ ## Workflow
98
+
99
+ ### Step 1: Ensure tasks.md has been updated
100
+
101
+ Check `agent-os/specs/[this-spec]/tasks.md` and ensure that all tasks and their sub-tasks are marked as completed with `- [x]`.
102
+
103
+ If a task is still marked incomplete, then verify that it has in fact been completed by checking the following:
104
+ - Run a brief spot check in the code to find evidence that this task's details have been implemented
105
+ - Check for existence of an implementation report titled using this task's title in `agent-os/spec/[this-spec]/implementation/` folder.
106
+
107
+ IF you have concluded that this task has been completed, then mark it's checkbox and its' sub-tasks checkboxes as completed with `- [x]`.
108
+
109
+ IF you have concluded that this task has NOT been completed, then mark this checkbox with ⚠️ and note it's incompleteness in your verification report.
110
+
111
+
112
+ ### Step 2: Update roadmap (if applicable)
113
+
114
+ Open `agent-os/product/roadmap.md` and check to see whether any item(s) match the description of the current spec that has just been implemented. If so, then ensure that these item(s) are marked as completed by updating their checkbox(s) to `- [x]`.
115
+
116
+
117
+ ### Step 3: Run entire tests suite
118
+
119
+ Run the entire tests suite for the application so that ALL tests run. Verify how many tests are passing and how many have failed or produced errors.
120
+
121
+ Include these counts and the list of failed tests in your final verification report.
122
+
123
+ DO NOT attempt to fix any failing tests. Just note their failures in your final verification report.
124
+
125
+
126
+ ### Step 4: Create final verification report
127
+
128
+ Create your final verification report in `agent-os/specs/[this-spec]/verifications/final-verification.md`.
129
+
130
+ The content of this report should follow this structure:
131
+
132
+ ```markdown
133
+ # Verification Report: [Spec Title]
134
+
135
+ **Spec:** `[spec-name]`
136
+ **Date:** [Current Date]
137
+ **Verifier:** implementation-verifier
138
+ **Status:** ✅ Passed | ⚠️ Passed with Issues | ❌ Failed
139
+
140
+ ---
141
+
142
+ ## Executive Summary
143
+
144
+ [Brief 2-3 sentence overview of the verification results and overall implementation quality]
145
+
146
+ ---
147
+
148
+ ## 1. Tasks Verification
149
+
150
+ **Status:** ✅ All Complete | ⚠️ Issues Found
151
+
152
+ ### Completed Tasks
153
+ - [x] Task Group 1: [Title]
154
+ - [x] Subtask 1.1
155
+ - [x] Subtask 1.2
156
+ - [x] Task Group 2: [Title]
157
+ - [x] Subtask 2.1
158
+
159
+ ### Incomplete or Issues
160
+ [List any tasks that were found incomplete or have issues, or note "None" if all complete]
161
+
162
+ ---
163
+
164
+ ## 2. Documentation Verification
165
+
166
+ **Status:** ✅ Complete | ⚠️ Issues Found
167
+
168
+ ### Implementation Documentation
169
+ - [x] Task Group 1 Implementation: `implementations/1-[task-name]-implementation.md`
170
+ - [x] Task Group 2 Implementation: `implementations/2-[task-name]-implementation.md`
171
+
172
+ ### Verification Documentation
173
+ [List verification documents from area verifiers if applicable]
174
+
175
+ ### Missing Documentation
176
+ [List any missing documentation, or note "None"]
177
+
178
+ ---
179
+
180
+ ## 3. Roadmap Updates
181
+
182
+ **Status:** ✅ Updated | ⚠️ No Updates Needed | ❌ Issues Found
183
+
184
+ ### Updated Roadmap Items
185
+ - [x] [Roadmap item that was marked complete]
186
+
187
+ ### Notes
188
+ [Any relevant notes about roadmap updates, or note if no updates were needed]
189
+
190
+ ---
191
+
192
+ ## 4. Test Suite Results
193
+
194
+ **Status:** ✅ All Passing | ⚠️ Some Failures | ❌ Critical Failures
195
+
196
+ ### Test Summary
197
+ - **Total Tests:** [count]
198
+ - **Passing:** [count]
199
+ - **Failing:** [count]
200
+ - **Errors:** [count]
201
+
202
+ ### Failed Tests
203
+ [List any failing tests with their descriptions, or note "None - all tests passing"]
204
+
205
+ ### Notes
206
+ [Any additional context about test results, known issues, or regressions]
207
+ ```
@@ -0,0 +1,54 @@
1
+ # COMMAND: Initialize Design OS
2
+
3
+ ## Goal
4
+ Populate the Design OS workspace with the product strategy defined in Agent OS, enabling the user to start designing immediately without manual data entry.
5
+
6
+ ## Prerequisites
7
+ - `agent-os/product/mission.md` must exist.
8
+ - `agent-os/product/roadmap.md` must exist.
9
+ - `design/` directory must be a valid Design OS clone.
10
+
11
+ ## Instructions
12
+
13
+ ### Step 1: Read Product Data
14
+ Read the content of:
15
+ - `agent-os/product/mission.md`
16
+ - `agent-os/product/roadmap.md`
17
+
18
+ ### Step 2: Generate Design OS Files
19
+ You will create/overwrite files in `design/product/`.
20
+
21
+ #### 2.1 Create `design/product/product-overview.md`
22
+ Extract the following from `mission.md` and format it as markdown:
23
+ - **Title**: The product name.
24
+ - **Description**: The core pitch/mission.
25
+ - **Problems & Solutions**: Map the "Problem" section to "Problem X: ... Solution: ...".
26
+ - **Key Features**: List the core features.
27
+
28
+ #### 2.2 Create `design/product/product-roadmap.md`
29
+ Extract the numbered feature list from `roadmap.md` and format it as:
30
+ ```markdown
31
+ # Product Roadmap
32
+ ## Sections
33
+ ### 1. [Feature Name]
34
+ [Brief description]
35
+ ...
36
+ ```
37
+
38
+ #### 2.3 Create `design/product/data-model/data-model.md` (Draft)
39
+ Based on the `mission.md` and `roadmap.md`, infer the core Entities and Relationships.
40
+ Create a draft data model file:
41
+ ```markdown
42
+ # Data Model
43
+ ## Entities
44
+ ### [Entity Name]
45
+ [Description]
46
+ ## Relationships
47
+ - [Entity] has many [Entity]
48
+ ```
49
+ *Note: Verify this draft with the user if the inference seems ambiguous.*
50
+
51
+ ### Step 3: Verification
52
+ - Check that `design/product/product-overview.md` exists.
53
+ - Check that `design/product/product-roadmap.md` exists.
54
+ - Output a confirmation message: "Design OS initialized! You can now open http://localhost:3000 to begin designing."
@@ -0,0 +1,180 @@
1
+ # Process for Orchestrating a Spec's Implementation
2
+
3
+ Now that we have a spec and tasks list ready for implementation, we will proceed with orchestrating implementation of each task group by a dedicated agent using the following MULTI-PHASE process.
4
+
5
+ Follow each of these phases and their individual workflows IN SEQUENCE:
6
+
7
+ ## Multi-Phase Process
8
+
9
+ ### FIRST: Get tasks.md for this spec
10
+
11
+ IF you already know which spec we're working on and IF that spec folder has a `tasks.md` file, then use that and skip to the NEXT phase.
12
+
13
+ IF you don't already know which spec we're working on and IF that spec folder doesn't yet have a `tasks.md` THEN output the following request to the user:
14
+
15
+ ```
16
+ Please point me to a spec's `tasks.md` that you want to orchestrate implementation for.
17
+
18
+ If you don't have one yet, then run any of these commands first:
19
+ /shape-spec
20
+ /write-spec
21
+ /create-tasks
22
+ ```
23
+
24
+ ### NEXT: Create orchestration.yml to serve as a roadmap for orchestration of task groups
25
+
26
+ In this spec's folder, create this file: `agent-os/specs/[this-spec]/orchestration.yml`.
27
+
28
+ Populate this file with with the names of each task group found in this spec's `tasks.md` and use this EXACT structure for the content of `orchestration.yml`:
29
+
30
+ ```yaml
31
+ task_groups:
32
+ - name: [task-group-name]
33
+ - name: [task-group-name]
34
+ - name: [task-group-name]
35
+ # Repeat for each task group found in tasks.md
36
+ ```
37
+
38
+ ### NEXT: Ask user to assign subagents to each task group
39
+
40
+ Next we must determine which subagents should be assigned to which task groups. Ask the user to provide this info using the following request to user and WAIT for user's response:
41
+
42
+ ```
43
+ Please specify the name of each subagent to be assigned to each task group:
44
+
45
+ 1. [task-group-name]
46
+ 2. [task-group-name]
47
+ 3. [task-group-name]
48
+ [repeat for each task-group you've added to orchestration.yml]
49
+
50
+ Simply respond with the subagent names and corresponding task group number and I'll update orchestration.yml accordingly.
51
+ ```
52
+
53
+ Using the user's responses, update `orchestration.yml` to specify those subagent names. `orchestration.yml` should end up looking like this:
54
+
55
+ ```yaml
56
+ task_groups:
57
+ - name: [task-group-name]
58
+ claude_code_subagent: [subagent-name]
59
+ - name: [task-group-name]
60
+ claude_code_subagent: [subagent-name]
61
+ - name: [task-group-name]
62
+ claude_code_subagent: [subagent-name]
63
+ # Repeat for each task group found in tasks.md
64
+ ```
65
+
66
+ For example, after this step, the `orchestration.yml` file might look like this (exact names will vary):
67
+
68
+ ```yaml
69
+ task_groups:
70
+ - name: authentication-system
71
+ claude_code_subagent: backend-specialist
72
+ - name: user-dashboard
73
+ claude_code_subagent: frontend-specialist
74
+ - name: api-endpoints
75
+ claude_code_subagent: backend-specialist
76
+ ```
77
+
78
+ ### NEXT: Ask user to assign standards to each task group
79
+
80
+ Next we must determine which standards should guide the implementation of each task group. Ask the user to provide this info using the following request to user and WAIT for user's response:
81
+
82
+ ```
83
+ Please specify the standard(s) that should be used to guide the implementation of each task group:
84
+
85
+ 1. [task-group-name]
86
+ 2. [task-group-name]
87
+ 3. [task-group-name]
88
+ [repeat for each task-group you've added to orchestration.yml]
89
+
90
+ For each task group number, you can specify any combination of the following:
91
+
92
+ "all" to include all of your standards
93
+ "global/*" to include all of the files inside of standards/global
94
+ "frontend/css.md" to include the css.md standard file
95
+ "none" to include no standards for this task group.
96
+ ```
97
+
98
+ Using the user's responses, update `orchestration.yml` to specify those standards for each task group. `orchestration.yml` should end up having AT LEAST the following information added to it:
99
+
100
+ ```yaml
101
+ task_groups:
102
+ - name: [task-group-name]
103
+ standards:
104
+ - [users' 1st response for this task group]
105
+ - [users' 2nd response for this task group]
106
+ - [users' 3rd response for this task group]
107
+ # Repeat for all standards that the user specified for this task group
108
+ - name: [task-group-name]
109
+ standards:
110
+ - [users' 1st response for this task group]
111
+ - [users' 2nd response for this task group]
112
+ # Repeat for all standards that the user specified for this task group
113
+ # Repeat for each task group found in tasks.md
114
+ ```
115
+
116
+ For example, after this step, the `orchestration.yml` file might look like this (exact names will vary):
117
+
118
+ ```yaml
119
+ task_groups:
120
+ - name: authentication-system
121
+ standards:
122
+ - all
123
+ - name: user-dashboard
124
+ standards:
125
+ - global/*
126
+ - frontend/components.md
127
+ - frontend/css.md
128
+ - name: task-group-with-no-standards
129
+ - name: api-endpoints
130
+ standards:
131
+ - backend/*
132
+ - global/error-handling.md
133
+ ```
134
+
135
+ Note: If the `use_claude_code_subagents` flag is enabled, the final `orchestration.yml` would include BOTH `claude_code_subagent` assignments AND `standards` for each task group.
136
+
137
+ ### NEXT: Delegate task groups implementations to assigned subagents
138
+
139
+ Loop through each task group in `agent-os/specs/[this-spec]/tasks.md` and delegate its implementation to the assigned subagent specified in `orchestration.yml`.
140
+
141
+ For each delegation, provide the subagent with:
142
+ - The task group (including the parent task and all sub-tasks)
143
+ - The spec file: `agent-os/specs/[this-spec]/spec.md`
144
+ - Instruct subagent to:
145
+ - Perform their implementation
146
+ - Check off the task and sub-task(s) in `agent-os/specs/[this-spec]/tasks.md`
147
+
148
+ In addition to the above items, also instruct the subagent to closely adhere to the user's standards & preferences as specified in the following files. To build the list of file references to give to the subagent, follow these instructions:
149
+
150
+ #### Compile Implementation Standards
151
+
152
+ Use the following logic to compile a list of file references to standards that should guide implementation:
153
+
154
+ ##### Steps to Compile Standards List
155
+
156
+ 1. Find the current task group in `orchestration.yml`
157
+ 2. Check the list of `standards` specified for this task group in `orchestration.yml`
158
+ 3. Compile the list of file references to those standards, one file reference per line, using this logic for determining which files to include:
159
+ a. If the value for `standards` is simply `all`, then include every single file, folder, sub-folder and files within sub-folders in your list of files.
160
+ b. If the item under standards ends with "*" then it means that all files within this folder or sub-folder should be included. For example, `frontend/*` means include all files and sub-folders and their files located inside of `agent-os/standards/frontend/`.
161
+ c. If a file ends in `.md` then it means this is one specific file you must include in your list of files. For example `backend/api.md` means you must include the file located at `agent-os/standards/backend/api.md`.
162
+ d. De-duplicate files in your list of file references.
163
+
164
+ ##### Output Format
165
+
166
+ The compiled list of standards should look something like this, where each file reference is on its own line and begins with `@`. The exact list of files will vary:
167
+
168
+ ```
169
+ @agent-os/standards/global/coding-style.md
170
+ @agent-os/standards/global/conventions.md
171
+ @agent-os/standards/global/tech-stack.md
172
+ @agent-os/standards/backend/api/authentication.md
173
+ @agent-os/standards/backend/api/endpoints.md
174
+ @agent-os/standards/backend/api/responses.md
175
+ @agent-os/standards/frontend/css.md
176
+ @agent-os/standards/frontend/responsive.md
177
+ ```
178
+
179
+
180
+ Provide all of the above to the subagent when delegating tasks for it to implement.
@@ -0,0 +1,53 @@
1
+ This begins a multi-step process for planning and documenting the mission and roadmap for the current product.
2
+
3
+ The FIRST STEP is to confirm the product details by following these instructions:
4
+
5
+ Collect comprehensive product information from the user:
6
+
7
+ ```bash
8
+ # Check if product folder already exists
9
+ if [ -d "agent-os/product" ]; then
10
+ echo "Product documentation already exists. Review existing files or start fresh?"
11
+ # List existing product files
12
+ ls -la agent-os/product/
13
+ fi
14
+ ```
15
+
16
+ Gather from user the following required information:
17
+ - **Product Idea**: Core concept and purpose (required)
18
+ - **Key Features**: Minimum 3 features with descriptions
19
+ - **Target Users**: At least 1 user segment with use cases
20
+ - **Tech stack**: Confirmation or info regarding the product's tech stack choices
21
+
22
+ If any required information is missing, prompt user:
23
+ ```
24
+ Please provide the following to create your product plan:
25
+ 1. Main idea for the product
26
+ 2. List of key features (minimum 3)
27
+ 3. Target users and use cases (minimum 1)
28
+ 4. Will this product use your usual tech stack choices or deviate in any way?
29
+ ```
30
+
31
+
32
+ Then WAIT for me to give you specific instructions on how to use the information you've gathered to create the mission and roadmap.
33
+
34
+ ## Display confirmation and next step
35
+
36
+ Once you've gathered all of the necessary information, output the following message:
37
+
38
+ ```
39
+ I have all the info I need to help you plan this product.
40
+
41
+ NEXT STEP 👉 Run the command, `2-create-mission.md`
42
+ ```
43
+
44
+ ## User Standards & Preferences Compliance
45
+
46
+ When planning the product's tech stack, mission statement and roadmap, use the user's standards and preferences for context and baseline assumptions, as documented in these files:
47
+
48
+ @agent-os/standards/global/coding-style.md
49
+ @agent-os/standards/global/commenting.md
50
+ @agent-os/standards/global/conventions.md
51
+ @agent-os/standards/global/error-handling.md
52
+ @agent-os/standards/global/tech-stack.md
53
+ @agent-os/standards/global/validation.md
@@ -0,0 +1,78 @@
1
+ Now that you've gathered information about this product, use that info to create the mission document in `agent-os/product/mission.md` by following these instructions:
2
+
3
+ Create `agent-os/product/mission.md` with comprehensive product definition following this structure for its' content:
4
+
5
+ #### Mission Structure:
6
+ ```markdown
7
+ # Product Mission
8
+
9
+ ## Pitch
10
+ [PRODUCT_NAME] is a [PRODUCT_TYPE] that helps [TARGET_USERS] [SOLVE_PROBLEM]
11
+ by providing [KEY_VALUE_PROPOSITION].
12
+
13
+ ## Users
14
+
15
+ ### Primary Customers
16
+ - [CUSTOMER_SEGMENT_1]: [DESCRIPTION]
17
+ - [CUSTOMER_SEGMENT_2]: [DESCRIPTION]
18
+
19
+ ### User Personas
20
+ **[USER_TYPE]** ([AGE_RANGE])
21
+ - **Role:** [JOB_TITLE/CONTEXT]
22
+ - **Context:** [BUSINESS/PERSONAL_CONTEXT]
23
+ - **Pain Points:** [SPECIFIC_PROBLEMS]
24
+ - **Goals:** [DESIRED_OUTCOMES]
25
+
26
+ ## The Problem
27
+
28
+ ### [PROBLEM_TITLE]
29
+ [PROBLEM_DESCRIPTION]. [QUANTIFIABLE_IMPACT].
30
+
31
+ **Our Solution:** [SOLUTION_APPROACH]
32
+
33
+ ## Differentiators
34
+
35
+ ### [DIFFERENTIATOR_TITLE]
36
+ Unlike [COMPETITOR/ALTERNATIVE], we provide [SPECIFIC_ADVANTAGE].
37
+ This results in [MEASURABLE_BENEFIT].
38
+
39
+ ## Key Features
40
+
41
+ ### Core Features
42
+ - **[FEATURE_NAME]:** [USER_BENEFIT_DESCRIPTION]
43
+
44
+ ### Collaboration Features
45
+ - **[FEATURE_NAME]:** [USER_BENEFIT_DESCRIPTION]
46
+
47
+ ### Advanced Features
48
+ - **[FEATURE_NAME]:** [USER_BENEFIT_DESCRIPTION]
49
+ ```
50
+
51
+ #### Important Constraints
52
+
53
+ - **Focus on user benefits** in feature descriptions, not technical details
54
+ - **Keep it concise** and easy for users to scan and get the more important concepts quickly
55
+
56
+
57
+ ## Display confirmation and next step
58
+
59
+ Once you've created mission.md, output the following message:
60
+
61
+ ```
62
+ ✅ I have documented the product mission at `agent-os/product/mission.md`.
63
+
64
+ Review it to ensure it matches your vision and strategic goals for this product.
65
+
66
+ NEXT STEP 👉 Run the command, `3-create-roadmap.md`
67
+ ```
68
+
69
+ ## User Standards & Preferences Compliance
70
+
71
+ IMPORTANT: Ensure the product mission is ALIGNED and DOES NOT CONFLICT with the user's preferences and standards as detailed in the following files:
72
+
73
+ @agent-os/standards/global/coding-style.md
74
+ @agent-os/standards/global/commenting.md
75
+ @agent-os/standards/global/conventions.md
76
+ @agent-os/standards/global/error-handling.md
77
+ @agent-os/standards/global/tech-stack.md
78
+ @agent-os/standards/global/validation.md
@@ -0,0 +1,73 @@
1
+ Now that you've created this product's mission.md, use that to guide your creation of the roadmap in `agent-os/product/roadmap.md` by following these instructions:
2
+
3
+ Generate `agent-os/product/roadmap.md` with an ordered feature checklist:
4
+
5
+ Do not include any tasks for initializing a new codebase or bootstrapping a new application. Assume the user is already inside the project's codebase and has a bare-bones application initialized.
6
+
7
+ #### Creating the Roadmap:
8
+
9
+ 1. **Review the Mission** - Read `agent-os/product/mission.md` to understand the product's goals, target users, and success criteria.
10
+
11
+ 2. **Identify Features** - Based on the mission, determine the list of concrete features needed to achieve the product vision.
12
+
13
+ 3. **Strategic Ordering** - Order features based on:
14
+ - Technical dependencies (foundational features first)
15
+ - Most direct path to achieving the mission
16
+ - Building incrementally from MVP to full product
17
+
18
+ 4. **Create the Roadmap** - Use the structure below as your template. Replace all bracketed placeholders (e.g., `[FEATURE_NAME]`, `[DESCRIPTION]`, `[EFFORT]`) with real content that you create based on the mission.
19
+
20
+ #### Roadmap Structure:
21
+ ```markdown
22
+ # Product Roadmap
23
+
24
+ 1. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
25
+ 2. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
26
+ 3. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
27
+ 4. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
28
+ 5. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
29
+ 6. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
30
+ 7. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
31
+ 8. [ ] [FEATURE_NAME] — [1-2 SENTENCE DESCRIPTION OF COMPLETE, TESTABLE FEATURE] `[EFFORT]`
32
+
33
+ > Notes
34
+ > - Order items by technical dependencies and product architecture
35
+ > - Each item should represent an end-to-end (frontend + backend) functional and testable feature
36
+ ```
37
+
38
+ Effort scale:
39
+ - `XS`: 1 day
40
+ - `S`: 2-3 days
41
+ - `M`: 1 week
42
+ - `L`: 2 weeks
43
+ - `XL`: 3+ weeks
44
+
45
+ #### Important Constraints
46
+
47
+ - **Make roadmap actionable** - include effort estimates and dependencies
48
+ - **Priorities guided by mission** - When deciding on order, aim for the most direct path to achieving the mission as documented in mission.md
49
+ - **Ensure phases are achievable** - start with MVP, build incrementally
50
+
51
+
52
+ ## Display confirmation and next step
53
+
54
+ Once you've created roadmap.md, output the following message:
55
+
56
+ ```
57
+ ✅ I have documented the product roadmap at `agent-os/product/roadmap.md`.
58
+
59
+ Review it to ensure it aligns with how you see this product roadmap going forward.
60
+
61
+ NEXT STEP 👉 Run the command, `4-create-tech-stack.md`
62
+ ```
63
+
64
+ ## User Standards & Preferences Compliance
65
+
66
+ IMPORTANT: Ensure the product roadmap is ALIGNED and DOES NOT CONFLICT with the user's preferences and standards as detailed in the following files:
67
+
68
+ @agent-os/standards/global/coding-style.md
69
+ @agent-os/standards/global/commenting.md
70
+ @agent-os/standards/global/conventions.md
71
+ @agent-os/standards/global/error-handling.md
72
+ @agent-os/standards/global/tech-stack.md
73
+ @agent-os/standards/global/validation.md