@orderful/droid 0.26.0 → 0.27.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 (146) hide show
  1. package/.claude-plugin/marketplace.json +7 -7
  2. package/AGENTS.md +36 -32
  3. package/CHANGELOG.md +46 -0
  4. package/dist/bin/droid.js +140 -24
  5. package/dist/index.js +97 -25
  6. package/dist/lib/migrations.d.ts +8 -0
  7. package/dist/lib/migrations.d.ts.map +1 -1
  8. package/dist/lib/skills.d.ts.map +1 -1
  9. package/dist/lib/tools.d.ts.map +1 -1
  10. package/dist/lib/types.d.ts +10 -2
  11. package/dist/lib/types.d.ts.map +1 -1
  12. package/dist/tools/brain/.claude-plugin/plugin.json +1 -1
  13. package/dist/tools/brain/TOOL.yaml +7 -5
  14. package/dist/tools/brain/commands/brain.md +17 -49
  15. package/dist/tools/brain/commands/scratchpad.md +13 -50
  16. package/{src/tools/brain/skills/droid-brain → dist/tools/brain/skills/brain}/SKILL.md +5 -5
  17. package/dist/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/SKILL.md +8 -8
  18. package/dist/tools/coach/.claude-plugin/plugin.json +1 -1
  19. package/dist/tools/coach/TOOL.yaml +4 -3
  20. package/dist/tools/coach/commands/coach.md +14 -54
  21. package/{src/tools/coach/skills/droid-coach → dist/tools/coach/skills/coach}/SKILL.md +4 -3
  22. package/dist/tools/code-review/.claude-plugin/plugin.json +1 -1
  23. package/dist/tools/code-review/TOOL.yaml +4 -3
  24. package/dist/tools/code-review/commands/code-review.md +18 -102
  25. package/dist/tools/code-review/skills/code-review/SKILL.md +154 -0
  26. package/dist/tools/codex/.claude-plugin/plugin.json +1 -1
  27. package/dist/tools/codex/TOOL.yaml +4 -3
  28. package/dist/tools/codex/commands/codex.md +18 -65
  29. package/dist/tools/codex/skills/{droid-codex → codex}/SKILL.md +64 -45
  30. package/{src/tools/codex/skills/droid-codex → dist/tools/codex/skills/codex}/references/loading.md +94 -55
  31. package/dist/tools/codex/skills/codex/scripts/git-finish-write.d.ts.map +1 -0
  32. package/dist/tools/codex/skills/codex/scripts/git-preamble.d.ts.map +1 -0
  33. package/dist/tools/codex/skills/codex/scripts/git-start-write.d.ts.map +1 -0
  34. package/dist/tools/comments/.claude-plugin/plugin.json +1 -1
  35. package/dist/tools/comments/TOOL.yaml +4 -3
  36. package/dist/tools/comments/commands/comments.md +12 -14
  37. package/{src/tools/comments/skills/droid-comments → dist/tools/comments/skills/comments}/SKILL.md +3 -1
  38. package/dist/tools/project/.claude-plugin/plugin.json +1 -1
  39. package/dist/tools/project/TOOL.yaml +4 -3
  40. package/dist/tools/project/commands/project.md +12 -27
  41. package/dist/tools/project/skills/{droid-project → project}/SKILL.md +12 -11
  42. package/dist/tools/tech-design/.claude-plugin/plugin.json +1 -1
  43. package/dist/tools/tech-design/TOOL.yaml +4 -3
  44. package/dist/tools/tech-design/commands/tech-design.md +18 -80
  45. package/{src/tools/tech-design/skills/droid-tech-design → dist/tools/tech-design/skills/tech-design}/SKILL.md +1 -1
  46. package/package.json +1 -1
  47. package/src/commands/tui/components/Badge.test.tsx +10 -4
  48. package/src/commands/tui.tsx +4 -4
  49. package/src/lib/migrations.ts +154 -4
  50. package/src/lib/skills.test.ts +199 -74
  51. package/src/lib/skills.ts +55 -54
  52. package/src/lib/tools.ts +19 -12
  53. package/src/lib/types.ts +20 -5
  54. package/src/tools/brain/.claude-plugin/plugin.json +1 -1
  55. package/src/tools/brain/TOOL.yaml +7 -5
  56. package/src/tools/brain/commands/brain.md +17 -49
  57. package/src/tools/brain/commands/scratchpad.md +13 -50
  58. package/{dist/tools/brain/skills/droid-brain → src/tools/brain/skills/brain}/SKILL.md +5 -5
  59. package/src/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/SKILL.md +8 -8
  60. package/src/tools/coach/.claude-plugin/plugin.json +1 -1
  61. package/src/tools/coach/TOOL.yaml +4 -3
  62. package/src/tools/coach/commands/coach.md +14 -54
  63. package/{dist/tools/coach/skills/droid-coach → src/tools/coach/skills/coach}/SKILL.md +4 -3
  64. package/src/tools/code-review/.claude-plugin/plugin.json +1 -1
  65. package/src/tools/code-review/TOOL.yaml +4 -3
  66. package/src/tools/code-review/commands/code-review.md +18 -102
  67. package/src/tools/code-review/skills/code-review/SKILL.md +154 -0
  68. package/src/tools/codex/.claude-plugin/plugin.json +1 -1
  69. package/src/tools/codex/TOOL.yaml +4 -3
  70. package/src/tools/codex/commands/codex.md +18 -65
  71. package/src/tools/codex/skills/{droid-codex → codex}/SKILL.md +64 -45
  72. package/{dist/tools/codex/skills/droid-codex → src/tools/codex/skills/codex}/references/loading.md +94 -55
  73. package/src/tools/comments/.claude-plugin/plugin.json +1 -1
  74. package/src/tools/comments/TOOL.yaml +4 -3
  75. package/src/tools/comments/commands/comments.md +12 -14
  76. package/{dist/tools/comments/skills/droid-comments → src/tools/comments/skills/comments}/SKILL.md +3 -1
  77. package/src/tools/project/.claude-plugin/plugin.json +1 -1
  78. package/src/tools/project/TOOL.yaml +4 -3
  79. package/src/tools/project/commands/project.md +12 -27
  80. package/src/tools/project/skills/{droid-project → project}/SKILL.md +12 -11
  81. package/src/tools/tech-design/.claude-plugin/plugin.json +1 -1
  82. package/src/tools/tech-design/TOOL.yaml +4 -3
  83. package/src/tools/tech-design/commands/tech-design.md +18 -80
  84. package/{dist/tools/tech-design/skills/droid-tech-design → src/tools/tech-design/skills/tech-design}/SKILL.md +1 -1
  85. package/dist/tools/code-review/skills/droid-code-review/SKILL.md +0 -55
  86. package/dist/tools/codex/skills/droid-codex/scripts/git-finish-write.d.ts.map +0 -1
  87. package/dist/tools/codex/skills/droid-codex/scripts/git-preamble.d.ts.map +0 -1
  88. package/dist/tools/codex/skills/droid-codex/scripts/git-start-write.d.ts.map +0 -1
  89. package/src/tools/code-review/skills/droid-code-review/SKILL.md +0 -55
  90. /package/dist/tools/brain/skills/{droid-brain → brain}/references/metadata.md +0 -0
  91. /package/dist/tools/brain/skills/{droid-brain → brain}/references/naming.md +0 -0
  92. /package/dist/tools/brain/skills/{droid-brain → brain}/references/templates.md +0 -0
  93. /package/dist/tools/brain/skills/{droid-brain → brain}/references/workflows.md +0 -0
  94. /package/dist/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/templates.md +0 -0
  95. /package/dist/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/workflows.md +0 -0
  96. /package/dist/tools/codex/skills/{droid-codex → codex}/references/creating.md +0 -0
  97. /package/dist/tools/codex/skills/{droid-codex → codex}/references/decisions.md +0 -0
  98. /package/dist/tools/codex/skills/{droid-codex → codex}/references/topics.md +0 -0
  99. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-finish-write.d.ts +0 -0
  100. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-finish-write.ts +0 -0
  101. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-preamble.d.ts +0 -0
  102. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-preamble.ts +0 -0
  103. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-scripts.test.ts +0 -0
  104. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-start-write.d.ts +0 -0
  105. /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-start-write.ts +0 -0
  106. /package/dist/tools/project/skills/{droid-project → project}/references/changelog.md +0 -0
  107. /package/dist/tools/project/skills/{droid-project → project}/references/creating.md +0 -0
  108. /package/dist/tools/project/skills/{droid-project → project}/references/loading.md +0 -0
  109. /package/dist/tools/project/skills/{droid-project → project}/references/templates.md +0 -0
  110. /package/dist/tools/project/skills/{droid-project → project}/references/updating.md +0 -0
  111. /package/dist/tools/project/skills/{droid-project → project}/references/versioning.md +0 -0
  112. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/draft.md +0 -0
  113. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/gaps.md +0 -0
  114. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/publish.md +0 -0
  115. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/research-doc-template.md +0 -0
  116. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/rollup-template.md +0 -0
  117. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/start.md +0 -0
  118. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/think.md +0 -0
  119. /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/thought-doc-template.md +0 -0
  120. /package/src/tools/brain/skills/{droid-brain → brain}/references/metadata.md +0 -0
  121. /package/src/tools/brain/skills/{droid-brain → brain}/references/naming.md +0 -0
  122. /package/src/tools/brain/skills/{droid-brain → brain}/references/templates.md +0 -0
  123. /package/src/tools/brain/skills/{droid-brain → brain}/references/workflows.md +0 -0
  124. /package/src/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/templates.md +0 -0
  125. /package/src/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/workflows.md +0 -0
  126. /package/src/tools/codex/skills/{droid-codex → codex}/references/creating.md +0 -0
  127. /package/src/tools/codex/skills/{droid-codex → codex}/references/decisions.md +0 -0
  128. /package/src/tools/codex/skills/{droid-codex → codex}/references/topics.md +0 -0
  129. /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-finish-write.ts +0 -0
  130. /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-preamble.ts +0 -0
  131. /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-scripts.test.ts +0 -0
  132. /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-start-write.ts +0 -0
  133. /package/src/tools/project/skills/{droid-project → project}/references/changelog.md +0 -0
  134. /package/src/tools/project/skills/{droid-project → project}/references/creating.md +0 -0
  135. /package/src/tools/project/skills/{droid-project → project}/references/loading.md +0 -0
  136. /package/src/tools/project/skills/{droid-project → project}/references/templates.md +0 -0
  137. /package/src/tools/project/skills/{droid-project → project}/references/updating.md +0 -0
  138. /package/src/tools/project/skills/{droid-project → project}/references/versioning.md +0 -0
  139. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/draft.md +0 -0
  140. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/gaps.md +0 -0
  141. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/publish.md +0 -0
  142. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/research-doc-template.md +0 -0
  143. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/rollup-template.md +0 -0
  144. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/start.md +0 -0
  145. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/think.md +0 -0
  146. /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/thought-doc-template.md +0 -0
@@ -36,6 +36,7 @@ Detailed procedure for loading entries from the codex.
36
36
  - Multiple matches → show list with category, let user pick
37
37
 
38
38
  **Fallback:** If `index.yaml` doesn't exist, fall back to directory scanning:
39
+
39
40
  ```bash
40
41
  ls {codex_repo}/projects/ | grep -i {name}
41
42
  ls {codex_repo}/domains/ | grep -i {name}
@@ -59,11 +60,11 @@ projects/transaction-templates/
59
60
 
60
61
  CONTEXT.md is the **first layer** - a synthesised summary that's enough for most queries. Only load full documents when deeper detail is needed.
61
62
 
62
- | Layer | What | When to use |
63
- |-------|------|-------------|
64
- | 1 | CONTEXT.md (~2KB) | General questions, getting oriented, "what is this project?" |
65
- | 2 | Specific file | Deep dives - "show me the full technical architecture" |
66
- | 3 | All files | Comprehensive review, major updates, onboarding |
63
+ | Layer | What | When to use |
64
+ | ----- | ----------------- | ------------------------------------------------------------ |
65
+ | 1 | CONTEXT.md (~2KB) | General questions, getting oriented, "what is this project?" |
66
+ | 2 | Specific file | Deep dives - "show me the full technical architecture" |
67
+ | 3 | All files | Comprehensive review, major updates, onboarding |
67
68
 
68
69
  ### Procedure
69
70
 
@@ -71,6 +72,7 @@ CONTEXT.md is the **first layer** - a synthesised summary that's enough for most
71
72
  2. **Check for CONTEXT.md:**
72
73
 
73
74
  **If CONTEXT.md exists:**
75
+
74
76
  ```
75
77
  📂 Loading transaction-templates
76
78
 
@@ -85,6 +87,7 @@ CONTEXT.md is the **first layer** - a synthesised summary that's enough for most
85
87
  - TECH-DESIGN.md - Architecture and implementation
86
88
  - DECISIONS.md - Decision log
87
89
  ```
90
+
88
91
  Load CONTEXT.md automatically. Only load additional files if user asks.
89
92
 
90
93
  **If no CONTEXT.md:**
@@ -125,83 +128,116 @@ topics/organization-hierarchy.md
125
128
 
126
129
  ## Auto-Generating CONTEXT.md
127
130
 
128
- If loading a project and no CONTEXT.md exists, generate it **asynchronously** so the user isn't blocked.
131
+ If loading a project and no CONTEXT.md exists, generate it immediately.
129
132
 
130
133
  **User sees:**
134
+
131
135
  ```
132
136
  📂 Loading transaction-templates
133
137
 
134
- No CONTEXT.md found - I'll generate one in the background.
135
- Meanwhile, which file do you want to load?
138
+ No CONTEXT.md found - generating summary from available artifacts...
136
139
 
137
- Available files:
138
- - PRD.md - Full requirements and goals
139
- - TECH-DESIGN.md - Architecture and implementation
140
- - DECISIONS.md - Decision log
140
+ Reading PRD.md...
141
+ Extracting problem statement, goals, success metrics
142
+ Reading TECH-DESIGN.md...
143
+ Extracting architecture overview, key decisions
144
+ Reading DECISIONS.md...
145
+ → Extracting decision log summary
146
+
147
+ Synthesising unified context...
141
148
  ```
142
149
 
143
150
  **Procedure:**
144
151
 
152
+ Generate CONTEXT.md either synchronously or asynchronously:
153
+
154
+ ### Option A: Synchronous (works everywhere)
155
+
156
+ 1. **Inform user:** "No CONTEXT.md found - generating summary from available artifacts"
157
+ 2. **Read all available files:** PRD.md, TECH-DESIGN.md, DECISIONS.md
158
+ 3. **Generate unified summary** (see template below)
159
+ 4. **Create PR** (see git workflow below)
160
+ 5. **Output the new CONTEXT.md** with "need more detail?" options
161
+
162
+ ### Option B: Asynchronous (Claude Code only, optional)
163
+
145
164
  1. **Spawn background agent** to synthesize CONTEXT.md (non-blocking):
146
165
  ```
147
- Use Task tool with subagent_type: "general-purpose" and run_in_background: true
166
+ Use Task tool with subagent_type: "general" and run_in_background: true
148
167
  Prompt: "Generate CONTEXT.md for {project} from PRD.md, TECH-DESIGN.md, DECISIONS.md. Create branch, commit, open PR."
149
168
  ```
150
169
  2. **Immediately ask user** which file to load (don't wait for synthesis)
151
170
  3. **Load selected file** and continue working
152
171
  4. **When background agent completes**, inform user: "CONTEXT.md ready - PR #{number}"
153
172
 
154
- ### Background Agent Task
173
+ **Choose whichever approach works best.** Synchronous is simpler and works everywhere. Asynchronous avoids blocking but requires background agent support.
155
174
 
156
- The background agent should:
175
+ ### CONTEXT.md Template
157
176
 
158
- 1. **Read all available files:** PRD.md, TECH-DESIGN.md, DECISIONS.md
159
- 2. **Generate unified summary:**
160
- ```markdown
161
- ---
162
- title: {Project Name}
163
- type: context
164
- created: {today}
165
- updated: {today}
166
- confidence: high
167
- source: implementation
168
- ---
177
+ Generate a unified summary from the project files:
169
178
 
170
- # {Project Name} - Context
179
+ ```markdown
180
+ ---
181
+ title: { Project Name }
182
+ type: context
183
+ created: { today }
184
+ updated: { today }
185
+ confidence: high
186
+ source: implementation
187
+ ---
171
188
 
172
- ## Overview
173
- {Synthesised from PRD problem statement + goals}
189
+ # {Project Name} - Context
174
190
 
175
- ## Technical Approach
176
- {Synthesised from TECH-DESIGN architecture + key decisions}
191
+ ## Overview
177
192
 
178
- ## Key Decisions
179
- {Summarised from DECISIONS.md}
193
+ {Synthesised from PRD problem statement + goals}
180
194
 
181
- ## Current Status
182
- {Inferred from most recent updates}
195
+ ## Technical Approach
183
196
 
184
- ---
185
- *Auto-generated from PRD.md, TECH-DESIGN.md, and DECISIONS.md*
186
- ```
187
- 4. **Create PR:**
188
- ```bash
189
- cd {codex_repo}
190
- git checkout -b auto/context-{project-name}
191
- # Write CONTEXT.md
192
- git add projects/{project}/CONTEXT.md
193
- git commit -F - <<EOF
194
- feat: auto-generate CONTEXT.md for {project}
195
- EOF
196
- git push -u origin auto/context-{project-name}
197
- gh pr create --title "Auto-generated CONTEXT.md for {project}" --body "Synthesised from PRD, TECH-DESIGN, and DECISIONS."
198
- ```
199
- 5. **Return result** (background agent outputs to task output file):
200
- ```
201
- ✅ CONTEXT.md synthesised and PR #{number} created for {project}
202
- ```
197
+ {Synthesised from TECH-DESIGN architecture + key decisions}
198
+
199
+ ## Key Decisions
200
+
201
+ {Summarised from DECISIONS.md}
203
202
 
204
- The main conversation will be notified when the background task completes.
203
+ ## Current Status
204
+
205
+ {Inferred from most recent updates}
206
+
207
+ ---
208
+
209
+ _Auto-generated from PRD.md, TECH-DESIGN.md, and DECISIONS.md_
210
+ ```
211
+
212
+ ### Git Workflow for CONTEXT.md
213
+
214
+ After generating the CONTEXT.md content:
215
+
216
+ ```bash
217
+ cd {codex_repo}
218
+ git checkout -b auto/context-{project-name}
219
+ # Write CONTEXT.md to projects/{project}/CONTEXT.md
220
+ git add projects/{project}/CONTEXT.md
221
+ git commit -F - <<EOF
222
+ feat: auto-generate CONTEXT.md for {project}
223
+ EOF
224
+ git push -u origin auto/context-{project-name}
225
+ gh pr create --title "Auto-generated CONTEXT.md for {project}" --body "Synthesised from PRD, TECH-DESIGN, and DECISIONS."
226
+ ```
227
+
228
+ Then inform the user:
229
+
230
+ ```
231
+ ✅ CONTEXT.md created and PR #{number} opened
232
+
233
+ [Show CONTEXT.md content]
234
+
235
+ ---
236
+ Need more detail? Available files:
237
+ - PRD.md - Full requirements and goals
238
+ - TECH-DESIGN.md - Architecture and implementation
239
+ - DECISIONS.md - Decision log
240
+ ```
205
241
 
206
242
  ## Freshness Checking
207
243
 
@@ -219,16 +255,19 @@ After loading any file:
219
255
  Want me to verify it's still accurate?
220
256
  ```
221
257
  4. **Check codebase changes** (if `codebase_paths` present):
258
+
222
259
  ```bash
223
260
  cd {workspace}
224
261
  git log --oneline --since="{updated}" -- {codebase_paths}
225
262
  ```
263
+
226
264
  - If commits found:
227
265
  ```
228
266
  ⚠️ Files in {paths} have changed since this doc was updated.
229
267
  Recent commits: {list}
230
268
  Want me to review for needed updates?
231
269
  ```
270
+
232
271
  5. **Note confidence** (if `confidence: low`):
233
272
  ```
234
273
  ℹ️ This was a quick exploration and may be incomplete.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "droid-comments",
3
- "version": "0.2.6",
3
+ "version": "0.3.0",
4
4
  "description": "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration.",
5
5
  "author": {
6
6
  "name": "Orderful",
@@ -1,14 +1,15 @@
1
1
  name: comments
2
2
  description: "Enable inline conversations using @droid/@user markers. Tag @droid to ask the AI, AI responds with @{your-name}. Use /comments check to address markers, /comments cleanup to remove resolved threads. Ideal for code review notes and async collaboration."
3
- version: 0.2.6
3
+ version: 0.3.0
4
4
  status: beta
5
5
 
6
6
  includes:
7
7
  skills:
8
- - name: droid-comments
8
+ - name: comments
9
9
  required: true
10
10
  commands:
11
- - comments
11
+ - name: comments
12
+ is_alias: false
12
13
  agents: []
13
14
 
14
15
  dependencies: []
@@ -1,29 +1,27 @@
1
1
  ---
2
- description: Check and respond to inline @droid comments in code and docs
2
+ name: comments
3
+ description: "Check and respond to inline @droid comments in code and docs"
3
4
  argument-hint: "[check [{path}] | cleanup]"
4
- allowed-tools: [Read, Edit, Grep, Glob, Bash(git diff:*), Bash(git status:*)]
5
5
  ---
6
6
 
7
- # /comments - Check and respond to inline comments
7
+ # /comments
8
8
 
9
- Entry point for inline comment workflows. See the **comments skill** for full behavior.
9
+ **User invoked:** `/comments $ARGUMENTS`
10
10
 
11
- ## Arguments
11
+ **Your task:** Invoke the **comments skill** with these arguments.
12
12
 
13
- $ARGUMENTS
13
+ ## Examples
14
14
 
15
- ## Usage
15
+ - `/comments` → Check all files in current directory for @droid markers
16
+ - `/comments check src/lib` → Check specific directory for @droid markers
17
+ - `/comments cleanup` → Remove resolved comment threads
18
+
19
+ ## Quick Reference
16
20
 
17
21
  ```
18
22
  /comments # Check all files in cwd
19
- /comments check # Same as above
20
23
  /comments check {path} # Check specific file or directory
21
24
  /comments cleanup # Remove resolved comment threads
22
25
  ```
23
26
 
24
- ## Behavior
25
-
26
- Refer to the comments skill for:
27
- - **Check**: How to find markers, determine intent (action vs question), respond appropriately
28
- - **Cleanup**: How to identify resolved threads and summarize decisions
29
- - **Configuration**: `user_mention`, `ai_mentions`, `preserve_comments` settings
27
+ See the **comments skill** for complete documentation and procedures.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: droid-comments
2
+ name: comments
3
3
  description: "Inline conversations using @droid/@user markers in any file. Use when leaving async questions in code or having discussion that should stay near the code. User prompts like 'check for comments', 'address the @droid markers', 'clean up resolved comments'."
4
4
  globs:
5
5
  - "**/*"
@@ -83,6 +83,7 @@ When you find a `@droid` marker:
83
83
  **Use a two-pass approach for coherent responses:**
84
84
 
85
85
  #### Pass 1: Read & Analyse
86
+
86
87
  1. **Read config first:** Check `~/.droid/skills/comments/overrides.yaml` for `preserve_comments` setting (default: `true`)
87
88
  2. Search for ALL `> @droid` comments (and any configured `ai_mentions`) in the specified scope
88
89
  3. If there's a `git diff`, check those files first for relevant context
@@ -91,6 +92,7 @@ When you find a `@droid` marker:
91
92
  6. Note any contradictions or tensions to address
92
93
 
93
94
  #### Pass 2: Respond & Write
95
+
94
96
  1. For each comment, determine intent:
95
97
  - **Action request** ("do X", "add Y", "fix Z") → Execute the action
96
98
  - **Question** ("what do you think", "should we") → Respond with `> @{user_mention}`
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "droid-project",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "description": "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features.",
5
5
  "author": {
6
6
  "name": "Orderful",
@@ -1,14 +1,15 @@
1
1
  name: project
2
2
  description: "Manage project context files for persistent AI memory across sessions. Load, update, or create project context before working on multi-session features."
3
- version: 0.2.0
3
+ version: 0.3.0
4
4
  status: beta
5
5
 
6
6
  includes:
7
7
  skills:
8
- - name: droid-project
8
+ - name: project
9
9
  required: true
10
10
  commands:
11
- - project
11
+ - name: project
12
+ is_alias: false
12
13
  agents: []
13
14
 
14
15
  dependencies: []
@@ -1,45 +1,30 @@
1
1
  ---
2
- description: Manage project context files for persistent AI memory across sessions
2
+ name: project
3
+ description: "Manage project context files for persistent AI memory across sessions"
3
4
  argument-hint: "[{keywords} | update | create {name}]"
4
- allowed-tools: [Read, Write, Edit, Glob, Bash(mkdir:*), Bash(ls:*)]
5
5
  ---
6
6
 
7
7
  # /project
8
8
 
9
- Entry point for project context management. See the **project skill** for full behavior.
9
+ **User invoked:** `/project $ARGUMENTS`
10
10
 
11
- ## Arguments
11
+ **Your task:** Invoke the **project skill** with these arguments.
12
12
 
13
- $ARGUMENTS
13
+ ## Example
14
14
 
15
- ## Default Behavior
15
+ If user typed `/project droid`, you should interpret this as: "Search for and load a project matching 'droid'"
16
16
 
17
- **IMPORTANT:** When given keywords (e.g., `/project audit-log`), the default action is to **SEARCH** for existing projects, NOT create. Only create a project when the `create` keyword is explicitly used.
17
+ If user typed `/project create new-feature`, interpret as: "Create a new project named 'new-feature'"
18
18
 
19
- ## Usage
19
+ ## Quick Reference
20
20
 
21
21
  ```
22
22
  /project # List and select a project
23
- /project {keywords} # SEARCH: Fuzzy-match and load existing project
23
+ /project {keywords} # SEARCH for existing project (default action)
24
24
  /project update # Update from conversation context
25
- /project update {name} # Update specific project
26
- /project create # Create new project interactively
27
- /project create {name} # Create with name (requires "create" keyword)
25
+ /project create {name} # CREATE new project
28
26
  ```
29
27
 
30
- ## Configuration
28
+ **Default behavior:** When given keywords, SEARCH first (don't create unless "create" keyword is present).
31
29
 
32
- **ALWAYS read `~/.droid/skills/project/overrides.yaml` first.**
33
-
34
- - If `projects_dir` is set → use **ONLY** that path (do NOT also search defaults)
35
- - If not configured → use the default for current AI tool
36
- - `preset` - Template format: `markdown` or `obsidian`
37
-
38
- ## Behavior
39
-
40
- Refer to the project skill for:
41
- - **Loading**: How to fuzzy-match, handle multiple matches, summarize after load
42
- - **Updating**: What to extract from conversation, versioning rules, changelog format
43
- - **Creating**: Template structure by preset, required files
44
-
45
- The skill's `references/` folder contains detailed specs for versioning, changelog formatting, and templates.
30
+ See the **project skill** for complete documentation and procedures.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: droid-project
2
+ name: project
3
3
  description: "Persistent project context for AI memory across sessions. Use when working on multi-session features, refactors, or any work that benefits from accumulated context. User prompts like 'load the project', 'update project context', 'what's the current project?'."
4
4
  globs:
5
5
  - "**/PROJECT.md"
@@ -33,24 +33,25 @@ Chat history disappears. Projects persist.
33
33
  - If `projects_dir` is configured → use **ONLY** that path (do NOT also search defaults)
34
34
  - If not configured → use the default for current AI tool
35
35
 
36
- | Setting | Default | Description |
37
- |---------|---------|-------------|
36
+ | Setting | Default | Description |
37
+ | -------------- | ----------- | ------------------------------------------------- |
38
38
  | `projects_dir` | (see below) | Where projects are stored (use ONE location only) |
39
- | `preset` | `markdown` | Output format: `markdown` or `obsidian` |
39
+ | `preset` | `markdown` | Output format: `markdown` or `obsidian` |
40
40
 
41
41
  Default `projects_dir` by AI tool (only if overrides.yaml is missing or lacks `projects_dir`):
42
+
42
43
  - **claude-code**: `~/.claude/projects`
43
44
  - **opencode**: `~/.config/opencode/projects`
44
45
 
45
46
  ## Commands
46
47
 
47
- | Command | Action |
48
- |---------|--------|
49
- | `/project` | List and select a project |
50
- | `/project {keywords}` | **Search** for existing project (fuzzy-match and load) |
51
- | `/project create {name}` | Create new project (requires `create` keyword) |
52
- | `/project create --from codex:{name}` | Create project seeded with codex context |
53
- | `/project update` | Update from conversation context |
48
+ | Command | Action |
49
+ | ------------------------------------- | ------------------------------------------------------ |
50
+ | `/project` | List and select a project |
51
+ | `/project {keywords}` | **Search** for existing project (fuzzy-match and load) |
52
+ | `/project create {name}` | Create new project (requires `create` keyword) |
53
+ | `/project create --from codex:{name}` | Create project seeded with codex context |
54
+ | `/project update` | Update from conversation context |
54
55
 
55
56
  **IMPORTANT:** The default action for `/project {keywords}` is to **SEARCH** for existing projects, NOT create. Only use `/project create {name}` when the user explicitly wants to create a new project.
56
57
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "droid-tech-design",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Technical design authoring tool for engineers. Create structured tech design docs with /tech-design start, iterate in brain, publish to codex. Three-document approach: research doc (codebase discoveries) + thought doc (design workspace) + roll-up (clean summary for review).",
5
5
  "author": {
6
6
  "name": "Orderful",
@@ -1,14 +1,15 @@
1
1
  name: tech-design
2
2
  description: "Technical design authoring tool for engineers. Create structured tech design docs with /tech-design start, iterate in brain, publish to codex. Three-document approach: research doc (codebase discoveries) + thought doc (design workspace) + roll-up (clean summary for review)."
3
- version: 0.1.0
3
+ version: 0.2.0
4
4
  status: beta
5
5
 
6
6
  includes:
7
7
  skills:
8
- - name: droid-tech-design
8
+ - name: tech-design
9
9
  required: true
10
10
  commands:
11
- - tech-design
11
+ - name: tech-design
12
+ is_alias: false
12
13
  agents: []
13
14
 
14
15
  dependencies:
@@ -1,93 +1,31 @@
1
1
  ---
2
- description: Write, iterate, and publish technical design documents using a two-document approach - messy thought docs in brain, clean roll-ups in codex
2
+ name: tech-design
3
+ description: "Write, iterate, and publish technical design documents using a three-document approach - research doc, thought doc, and roll-up"
3
4
  argument-hint: "[start --from codex:{project} | draft [section] | think [topic] | gaps | publish]"
4
- allowed-tools: [Read, Write, Edit, Glob, Grep, Bash(gh:*), Bash(git:*), Bash(mkdir:*), Task]
5
5
  ---
6
6
 
7
7
  # /tech-design
8
8
 
9
- Entry point for technical design authoring. See the **tech-design skill** for full behavior.
9
+ **User invoked:** `/tech-design $ARGUMENTS`
10
10
 
11
- > Tech designs are where architectural decisions get made. Make them AI-friendly.
12
-
13
- ## Arguments
14
-
15
- $ARGUMENTS
16
-
17
- ## Why `/tech-design` not `/design`?
18
-
19
- Leaves `/design` open for actual design tooling (Figma workflows, design system docs, UI/UX review).
20
-
21
- ## Prerequisites
22
-
23
- Before first use, verify:
24
-
25
- 1. **Brain configured** - For thought doc drafting
26
- 2. **Codex configured** - For PRD context and publishing
27
- 3. **gh CLI** - For creating PRs
28
-
29
- ## Usage
30
-
31
- ```bash
32
- # Core Authoring (v1)
33
- /tech-design start --from codex:{project} # Create thought doc, pull PRD/DESIGN context
34
- /tech-design draft [section] # Auto-generate from PRD + codebase research
35
- /tech-design think [topic] # Guided exploration, stress-test ideas
36
- /tech-design gaps # Checklist of missing/empty sections
37
- /tech-design publish # Generate roll-up + thought doc, open PR to codex
38
-
39
- # Self-Review & Interaction (v2 - not yet implemented)
40
- # /tech-design critic [persona] # Multi-persona review with severity scoring
41
- # /tech-design respond {question} # Author tool: search thought doc to draft reply
42
- # /tech-design ask {question} # Reviewer tool: search both docs to answer questions
43
- ```
44
-
45
- ## Configuration
46
-
47
- Tech-design has no configuration of its own. It delegates to:
48
-
49
- - **Brain skill** - Thought doc location (`brain_dir`, `inbox_folder`)
50
- - **Codex skill** - Repository location (`codex_repo`)
51
-
52
- ## Behavior
53
-
54
- Refer to the tech-design skill for:
55
-
56
- - **Starting**: How to create thought doc from codex context
57
- - **Drafting**: Research-first, structure-second content generation
58
- - **Thinking**: Guided exploration to stress-test ideas
59
- - **Gap Analysis**: What sections are missing or empty
60
- - **Publishing**: Generate clean roll-up and create PR
61
-
62
- The skill's `references/` folder contains detailed procedures for each workflow.
63
-
64
- ## Two-Document Approach
65
-
66
- | Document | Purpose | Location |
67
- | --------------- | --------------------------------------- | ------------- |
68
- | **Thought doc** | Messy iteration, @mentions, exploration | Brain |
69
- | **Roll-up** | Clean, reviewable, decision-focused | Codex project |
70
-
71
- Both documents published to codex on `/tech-design publish` for full transparency.
11
+ **Your task:** Invoke the **tech-design skill** with these arguments.
72
12
 
73
13
  ## Examples
74
14
 
75
- ```bash
76
- # Start a new tech design from codex project context
77
- /tech-design start --from codex:transaction-templates
78
-
79
- # Draft the entire doc from PRD and codebase research
80
- /tech-design draft
81
-
82
- # Explore a specific idea before committing to it
83
- /tech-design think "Should we use events or polling for status updates?"
15
+ - `/tech-design start --from codex:billing-v2` → Create research + thought docs from codex project
16
+ - `/tech-design draft rollout` Auto-generate the rollout section
17
+ - `/tech-design think API design` → Guided exploration of API design, update research doc
18
+ - `/tech-design gaps` → Show checklist of missing/empty sections
19
+ - `/tech-design publish` Generate roll-up and publish to codex
84
20
 
85
- # Draft just the rollout section
86
- /tech-design draft rollout
21
+ ## Quick Reference
87
22
 
88
- # See what's missing
89
- /tech-design gaps
90
-
91
- # Publish to codex when ready for review
92
- /tech-design publish
93
23
  ```
24
+ /tech-design start --from codex:{project} # Create research + thought docs
25
+ /tech-design draft [section] # Auto-generate section
26
+ /tech-design think [topic] # Guided exploration
27
+ /tech-design gaps # Missing sections checklist
28
+ /tech-design publish # Publish to codex
29
+ ```
30
+
31
+ See the **tech-design skill** for complete documentation and procedures.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: droid-tech-design
2
+ name: tech-design
3
3
  description: "Technical design authoring with three-document approach - research doc (codebase discoveries), thought doc (design iteration), and roll-up (clean summary). Use when writing tech designs, drafting sections, exploring architectural ideas, or publishing to codex. User prompts like 'start tech design for X', 'draft the rollout section', 'let's think through the API design', 'publish this to codex'."
4
4
  globs: []
5
5
  alwaysApply: false
@@ -1,55 +0,0 @@
1
- ---
2
- name: droid-code-review
3
- description: "Comprehensive code review using specialized agents. Use when reviewing PRs, checking staged changes, or analysing code quality. User prompts like 'review this PR', 'check my changes', 'review before I commit'."
4
- globs:
5
- - "**/*"
6
- alwaysApply: false
7
- allowed-tools: [Read, Grep, Glob, Bash, Task]
8
- ---
9
-
10
- # Code Review Skill
11
-
12
- Run comprehensive code reviews using specialized agents, each focused on a specific concern.
13
-
14
- ## How It Works
15
-
16
- The `/code-review` command orchestrates multiple specialized agents in parallel:
17
-
18
- 1. **edi-standards-reviewer** - EDI patterns, partnership handling, billing concerns
19
- 2. **test-coverage-analyzer** - Test completeness and edge cases
20
- 3. **error-handling-reviewer** - Silent failures, missing error handling
21
- 4. **type-reviewer** - TypeScript type design, interface contracts
22
-
23
- Each agent returns issues with confidence scores (0-100). Issues below 80% confidence are filtered out to reduce noise.
24
-
25
- ## Usage
26
-
27
- ```bash
28
- /code-review #123 # Review PR #123
29
- /code-review staged # Review staged changes
30
- /code-review branch # Review current branch vs main
31
- /code-review path/to/file # Review specific file
32
- ```
33
-
34
- ## Output Format
35
-
36
- Reviews are presented in prioritized categories:
37
-
38
- 🔴 **Critical** - Security, data loss, billing errors
39
- 🟠 **Important** - Bugs, missing tests, type issues
40
- 🟡 **Suggestions** - Style, readability improvements
41
-
42
- ## Post-Review Actions
43
-
44
- After presenting findings, you can:
45
- - Post the review as a PR comment
46
- - Get suggested fixes for specific issues
47
- - Check out the branch and fix critical issues
48
-
49
- ## Domain-Aware Reviews
50
-
51
- The EDI Standards Reviewer discovers project conventions by reading:
52
- - `.claude/CLAUDE.md` or `CLAUDE.md` for team conventions
53
- - `AGENTS.md` or `docs/` for architecture guidance
54
-
55
- This lets it apply your project's specific patterns rather than generic rules.
@@ -1 +0,0 @@
1
- {"version":3,"file":"git-finish-write.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/codex/skills/droid-codex/scripts/git-finish-write.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"git-preamble.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/codex/skills/droid-codex/scripts/git-preamble.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}