@orderful/droid 0.36.0 → 0.38.0

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 (109) hide show
  1. package/.claude-plugin/marketplace.json +1 -118
  2. package/.claude-plugin/plugin.json +49 -0
  3. package/AGENTS.md +4 -0
  4. package/CHANGELOG.md +59 -0
  5. package/README.md +53 -39
  6. package/dist/bin/droid.js +525 -212
  7. package/dist/commands/setup.d.ts.map +1 -1
  8. package/dist/commands/tui/components/PlatformBadges.d.ts.map +1 -1
  9. package/dist/commands/tui/components/SettingsDetails.d.ts.map +1 -1
  10. package/dist/commands/tui/hooks/useAppUpdate.d.ts.map +1 -1
  11. package/dist/commands/tui/views/SetupScreen.d.ts.map +1 -1
  12. package/dist/commands/update.d.ts.map +1 -1
  13. package/dist/index.js +345 -186
  14. package/dist/lib/agents.d.ts +4 -2
  15. package/dist/lib/agents.d.ts.map +1 -1
  16. package/dist/lib/migrations.d.ts.map +1 -1
  17. package/dist/lib/platform.codex.d.ts +36 -0
  18. package/dist/lib/platform.codex.d.ts.map +1 -0
  19. package/dist/lib/platforms.d.ts +30 -24
  20. package/dist/lib/platforms.d.ts.map +1 -1
  21. package/dist/lib/skills.d.ts +4 -2
  22. package/dist/lib/skills.d.ts.map +1 -1
  23. package/dist/lib/types.d.ts +2 -1
  24. package/dist/lib/types.d.ts.map +1 -1
  25. package/dist/tools/brain/.claude-plugin/plugin.json +8 -1
  26. package/dist/tools/brain/TOOL.yaml +1 -1
  27. package/dist/tools/brain/commands/brain.md +3 -2
  28. package/dist/tools/brain/skills/brain/SKILL.md +41 -10
  29. package/dist/tools/brain/skills/brain/references/templates.md +61 -0
  30. package/dist/tools/brain/skills/brain/references/workflows.md +78 -9
  31. package/dist/tools/brain/skills/brain-obsidian/SKILL.md +2 -0
  32. package/dist/tools/coach/.claude-plugin/plugin.json +6 -0
  33. package/dist/tools/coach/skills/coach/SKILL.md +3 -0
  34. package/dist/tools/code-review/.claude-plugin/plugin.json +12 -0
  35. package/dist/tools/code-review/skills/code-review/SKILL.md +2 -0
  36. package/dist/tools/codex/.claude-plugin/plugin.json +9 -0
  37. package/dist/tools/codex/skills/codex/SKILL.md +3 -0
  38. package/dist/tools/comments/.claude-plugin/plugin.json +7 -1
  39. package/dist/tools/comments/TOOL.yaml +1 -1
  40. package/dist/tools/comments/skills/comments/SKILL.md +11 -4
  41. package/dist/tools/droid/.claude-plugin/plugin.json +8 -1
  42. package/dist/tools/droid/TOOL.yaml +4 -2
  43. package/dist/tools/droid/commands/setup.md +125 -0
  44. package/dist/tools/droid/skills/droid/SKILL.md +117 -2
  45. package/dist/tools/plan/.claude-plugin/plugin.json +7 -1
  46. package/dist/tools/plan/TOOL.yaml +1 -1
  47. package/dist/tools/plan/commands/plan.md +3 -1
  48. package/dist/tools/plan/skills/plan/SKILL.md +23 -9
  49. package/dist/tools/plan/skills/plan/references/workflows.md +57 -20
  50. package/dist/tools/project/.claude-plugin/plugin.json +6 -0
  51. package/dist/tools/project/skills/project/SKILL.md +3 -0
  52. package/dist/tools/tech-design/.claude-plugin/plugin.json +7 -1
  53. package/dist/tools/tech-design/TOOL.yaml +1 -1
  54. package/dist/tools/tech-design/commands/tech-design.md +2 -0
  55. package/dist/tools/tech-design/skills/tech-design/SKILL.md +45 -13
  56. package/dist/tools/tech-design/skills/tech-design/references/publish.md +272 -216
  57. package/dist/tools/tech-design/skills/tech-design/references/start.md +50 -20
  58. package/dist/tools/wrapup/.claude-plugin/plugin.json +6 -0
  59. package/dist/tools/wrapup/skills/wrapup/SKILL.md +2 -0
  60. package/package.json +1 -1
  61. package/scripts/build-plugins.ts +154 -6
  62. package/src/bin/droid.ts +16 -0
  63. package/src/commands/setup.ts +107 -2
  64. package/src/commands/tui/components/PlatformBadges.tsx +1 -0
  65. package/src/commands/tui/components/SettingsDetails.tsx +1 -0
  66. package/src/commands/tui/hooks/useAppUpdate.ts +21 -1
  67. package/src/commands/tui/views/SetupScreen.tsx +10 -1
  68. package/src/commands/update.ts +21 -1
  69. package/src/lib/agents.ts +13 -2
  70. package/src/lib/migrations.ts +81 -9
  71. package/src/lib/platform.codex.ts +131 -0
  72. package/src/lib/platforms.ts +127 -6
  73. package/src/lib/skills.ts +53 -6
  74. package/src/lib/types.ts +1 -0
  75. package/src/tools/brain/.claude-plugin/plugin.json +8 -1
  76. package/src/tools/brain/TOOL.yaml +1 -1
  77. package/src/tools/brain/commands/brain.md +3 -2
  78. package/src/tools/brain/skills/brain/SKILL.md +41 -10
  79. package/src/tools/brain/skills/brain/references/templates.md +61 -0
  80. package/src/tools/brain/skills/brain/references/workflows.md +78 -9
  81. package/src/tools/brain/skills/brain-obsidian/SKILL.md +2 -0
  82. package/src/tools/coach/.claude-plugin/plugin.json +6 -0
  83. package/src/tools/coach/skills/coach/SKILL.md +3 -0
  84. package/src/tools/code-review/.claude-plugin/plugin.json +12 -0
  85. package/src/tools/code-review/skills/code-review/SKILL.md +2 -0
  86. package/src/tools/codex/.claude-plugin/plugin.json +9 -0
  87. package/src/tools/codex/skills/codex/SKILL.md +3 -0
  88. package/src/tools/comments/.claude-plugin/plugin.json +7 -1
  89. package/src/tools/comments/TOOL.yaml +1 -1
  90. package/src/tools/comments/skills/comments/SKILL.md +11 -4
  91. package/src/tools/droid/.claude-plugin/plugin.json +8 -1
  92. package/src/tools/droid/TOOL.yaml +4 -2
  93. package/src/tools/droid/commands/setup.md +125 -0
  94. package/src/tools/droid/skills/droid/SKILL.md +117 -2
  95. package/src/tools/plan/.claude-plugin/plugin.json +7 -1
  96. package/src/tools/plan/TOOL.yaml +1 -1
  97. package/src/tools/plan/commands/plan.md +3 -1
  98. package/src/tools/plan/skills/plan/SKILL.md +23 -9
  99. package/src/tools/plan/skills/plan/references/workflows.md +57 -20
  100. package/src/tools/project/.claude-plugin/plugin.json +6 -0
  101. package/src/tools/project/skills/project/SKILL.md +3 -0
  102. package/src/tools/tech-design/.claude-plugin/plugin.json +7 -1
  103. package/src/tools/tech-design/TOOL.yaml +1 -1
  104. package/src/tools/tech-design/commands/tech-design.md +2 -0
  105. package/src/tools/tech-design/skills/tech-design/SKILL.md +45 -13
  106. package/src/tools/tech-design/skills/tech-design/references/publish.md +272 -216
  107. package/src/tools/tech-design/skills/tech-design/references/start.md +50 -20
  108. package/src/tools/wrapup/.claude-plugin/plugin.json +6 -0
  109. package/src/tools/wrapup/skills/wrapup/SKILL.md +2 -0
@@ -50,14 +50,40 @@ The codex skill will:
50
50
  - UI/UX considerations (from DESIGN.md if present)
51
51
  - Key constraints or requirements
52
52
 
53
- ### 3. Create Research Doc via Brain Skill
54
-
55
- Use the brain skill to create a research document:
53
+ ### 3. Create Unified Tech Design Folder
54
+
55
+ Create a single folder to hold all tech design artifacts:
56
+
57
+ ```bash
58
+ # Get brain config
59
+ brain_config=$(droid config --get tools.brain)
60
+ brain_dir=$(echo "$brain_config" | grep -o '"brain_dir": *"[^"]*"' | cut -d'"' -f4)
61
+ inbox_folder=$(echo "$brain_config" | grep -o '"inbox_folder": *"[^"]*"' | cut -d'"' -f4)
62
+
63
+ # Determine base path
64
+ if [ -n "$inbox_folder" ]; then
65
+ base_path="$inbox_folder"
66
+ else
67
+ base_path="$brain_dir"
68
+ fi
69
+
70
+ # Create folder structure
71
+ design_folder="$base_path/tech-designs/{project}"
72
+ mkdir -p "$design_folder"
73
+ ```
56
74
 
75
+ **Folder structure:**
57
76
  ```
58
- /brain research tech-design-{project}-research
77
+ {brain_dir}/{inbox?}/tech-designs/{project}/
78
+ ├── research.md
79
+ ├── thought-doc.md
80
+ └── [diagrams, artifacts as needed]
59
81
  ```
60
82
 
83
+ ### 4. Create Research Doc
84
+
85
+ Create `research.md` in the design folder:
86
+
61
87
  **Research doc template:**
62
88
 
63
89
  ```markdown
@@ -81,7 +107,7 @@ Research for tech design: {brief description from PRD}
81
107
 
82
108
  ## Codebase Discoveries
83
109
 
84
- {This section populated in step 4}
110
+ {This section populated in step 5}
85
111
 
86
112
  ## Key Findings
87
113
 
@@ -174,13 +200,9 @@ Update the "Codebase Discoveries" section with specific discoveries:
174
200
  - Testing: {e.g., unit test setup, integration test patterns}
175
201
  ```
176
202
 
177
- ### 5. Create Thought Doc via Brain Skill
178
-
179
- Use the brain skill to create the planning document:
203
+ ### 5. Create Thought Doc
180
204
 
181
- ```
182
- /brain plan tech-design-{project}
183
- ```
205
+ Create `thought-doc.md` in the same folder:
184
206
 
185
207
  **Thought doc template:**
186
208
 
@@ -191,7 +213,7 @@ Use the brain skill to create the planning document:
191
213
  **Status:** exploring
192
214
  **Created:** {current date}
193
215
  **PRD:** [[codex:projects/{project}/PRD]]
194
- **Research:** [[tech-design-{project}-research]]
216
+ **Research:** [[research|Research doc in same folder]]
195
217
 
196
218
  Tech design for {project}.
197
219
 
@@ -203,7 +225,7 @@ Tech design for {project}.
203
225
  - Who it's for and why it matters
204
226
  - Key constraints or requirements
205
227
 
206
- See research doc for codebase context and discovered patterns.
228
+ See research.md for codebase context and discovered patterns.
207
229
 
208
230
  ## Proposal
209
231
 
@@ -214,15 +236,18 @@ See research doc for codebase context and discovered patterns.
214
236
  {What we don't know yet - to be explored}
215
237
  ```
216
238
 
217
- Set thought doc as active in brain's session tracking.
239
+ Set thought-doc.md path for session tracking (active design).
218
240
 
219
241
  ### 6. Provide Links to User
220
242
 
221
- After creating both docs, give the user the file paths:
243
+ After creating both docs, give the user the folder path:
222
244
 
223
245
  ```
224
- Research doc created: {full_path_to_research_doc}
225
- ✓ Tech design created: {full_path_to_thought_doc}
246
+ Tech design folder created: {design_folder}/
247
+
248
+ Files:
249
+ • research.md - Codex context and codebase discoveries
250
+ • thought-doc.md - Design iteration workspace (active)
226
251
 
227
252
  Research doc includes:
228
253
  • Codex project context from {project}
@@ -230,6 +255,7 @@ Research doc includes:
230
255
  • Technical stack notes
231
256
 
232
257
  You can continue working on this with:
258
+ • /tech-design search {project} - Resume this design later
233
259
  • /tech-design draft - Auto-generate sections from research
234
260
  • /tech-design think {topic} - Explore specific ideas
235
261
  • /brain add {text} - Quick additions to active doc
@@ -243,7 +269,7 @@ What would you like to do next?
243
269
  - **Brain not configured:** "Brain skill not configured. Please run `/brain` to set up your brain directory first."
244
270
  - **Codex not configured:** "Codex skill not configured. Please run `/codex` to set up your codex repository first."
245
271
  - **PRD missing:** Offer to create via `/codex new {project}` or continue without context
246
- - **Docs already exist:** "Tech design docs for '{project}' already exist. Open existing or create new?"
272
+ - **Folder already exists:** "Tech design for '{project}' already exists at {path}. Resume with `/tech-design search {project}` or create with different name?"
247
273
  - **Codebase exploration fails:** Gracefully note what couldn't be found, continue with what's available
248
274
 
249
275
  ## Example Output
@@ -257,8 +283,11 @@ Research findings:
257
283
  🔗 Identified 5 integration points (validation, storage, API)
258
284
  📦 Dependencies: 2 already available, 1 to add
259
285
 
260
- Research doc created: {brain_dir}/0-Inbox/research/tech-design-transaction-templates-research.md
261
- ✓ Tech design created: {brain_dir}/0-Inbox/plans/tech-design-transaction-templates.md
286
+ Tech design folder created: {brain_dir}/0-Inbox/tech-designs/transaction-templates/
287
+
288
+ Files:
289
+ • research.md - Codex context and codebase discoveries
290
+ • thought-doc.md - Design iteration workspace (active)
262
291
 
263
292
  Research doc includes:
264
293
  • Codex project context from transaction-templates
@@ -266,6 +295,7 @@ Research doc includes:
266
295
  • Technical stack notes
267
296
 
268
297
  You can continue working on this with:
298
+ • /tech-design search transaction-templates - Resume this design later
269
299
  • /tech-design draft - Auto-generate sections from research
270
300
  • /tech-design think {topic} - Explore specific ideas
271
301
  • /brain add {text} - Quick additions to active doc
@@ -12,5 +12,11 @@
12
12
  "droid",
13
13
  "ai",
14
14
  "wrapup"
15
+ ],
16
+ "skills": [
17
+ "./skills/wrapup/SKILL.md"
18
+ ],
19
+ "commands": [
20
+ "./commands/wrapup.md"
15
21
  ]
16
22
  }
@@ -18,6 +18,8 @@ Wrapup has no configuration of its own. It reads config from other installed too
18
18
 
19
19
  If these tools aren't configured, wrapup skips those artifacts and focuses on git state and conversation summary.
20
20
 
21
+ **Overrides:** This skill supports user-defined overrides. See `/droid` skill § Skill Overrides.
22
+
21
23
  ## Context Lifeboat Pattern
22
24
 
23
25
  This skill runs at the END of sessions when context pressure is highest.