@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.
- package/.claude-plugin/marketplace.json +7 -7
- package/AGENTS.md +36 -32
- package/CHANGELOG.md +46 -0
- package/dist/bin/droid.js +140 -24
- package/dist/index.js +97 -25
- package/dist/lib/migrations.d.ts +8 -0
- package/dist/lib/migrations.d.ts.map +1 -1
- package/dist/lib/skills.d.ts.map +1 -1
- package/dist/lib/tools.d.ts.map +1 -1
- package/dist/lib/types.d.ts +10 -2
- package/dist/lib/types.d.ts.map +1 -1
- package/dist/tools/brain/.claude-plugin/plugin.json +1 -1
- package/dist/tools/brain/TOOL.yaml +7 -5
- package/dist/tools/brain/commands/brain.md +17 -49
- package/dist/tools/brain/commands/scratchpad.md +13 -50
- package/{src/tools/brain/skills/droid-brain → dist/tools/brain/skills/brain}/SKILL.md +5 -5
- package/dist/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/SKILL.md +8 -8
- package/dist/tools/coach/.claude-plugin/plugin.json +1 -1
- package/dist/tools/coach/TOOL.yaml +4 -3
- package/dist/tools/coach/commands/coach.md +14 -54
- package/{src/tools/coach/skills/droid-coach → dist/tools/coach/skills/coach}/SKILL.md +4 -3
- package/dist/tools/code-review/.claude-plugin/plugin.json +1 -1
- package/dist/tools/code-review/TOOL.yaml +4 -3
- package/dist/tools/code-review/commands/code-review.md +18 -102
- package/dist/tools/code-review/skills/code-review/SKILL.md +154 -0
- package/dist/tools/codex/.claude-plugin/plugin.json +1 -1
- package/dist/tools/codex/TOOL.yaml +4 -3
- package/dist/tools/codex/commands/codex.md +18 -65
- package/dist/tools/codex/skills/{droid-codex → codex}/SKILL.md +64 -45
- package/{src/tools/codex/skills/droid-codex → dist/tools/codex/skills/codex}/references/loading.md +94 -55
- package/dist/tools/codex/skills/codex/scripts/git-finish-write.d.ts.map +1 -0
- package/dist/tools/codex/skills/codex/scripts/git-preamble.d.ts.map +1 -0
- package/dist/tools/codex/skills/codex/scripts/git-start-write.d.ts.map +1 -0
- package/dist/tools/comments/.claude-plugin/plugin.json +1 -1
- package/dist/tools/comments/TOOL.yaml +4 -3
- package/dist/tools/comments/commands/comments.md +12 -14
- package/{src/tools/comments/skills/droid-comments → dist/tools/comments/skills/comments}/SKILL.md +3 -1
- package/dist/tools/project/.claude-plugin/plugin.json +1 -1
- package/dist/tools/project/TOOL.yaml +4 -3
- package/dist/tools/project/commands/project.md +12 -27
- package/dist/tools/project/skills/{droid-project → project}/SKILL.md +12 -11
- package/dist/tools/tech-design/.claude-plugin/plugin.json +1 -1
- package/dist/tools/tech-design/TOOL.yaml +4 -3
- package/dist/tools/tech-design/commands/tech-design.md +18 -80
- package/{src/tools/tech-design/skills/droid-tech-design → dist/tools/tech-design/skills/tech-design}/SKILL.md +1 -1
- package/package.json +1 -1
- package/src/commands/tui/components/Badge.test.tsx +10 -4
- package/src/commands/tui.tsx +4 -4
- package/src/lib/migrations.ts +154 -4
- package/src/lib/skills.test.ts +199 -74
- package/src/lib/skills.ts +55 -54
- package/src/lib/tools.ts +19 -12
- package/src/lib/types.ts +20 -5
- package/src/tools/brain/.claude-plugin/plugin.json +1 -1
- package/src/tools/brain/TOOL.yaml +7 -5
- package/src/tools/brain/commands/brain.md +17 -49
- package/src/tools/brain/commands/scratchpad.md +13 -50
- package/{dist/tools/brain/skills/droid-brain → src/tools/brain/skills/brain}/SKILL.md +5 -5
- package/src/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/SKILL.md +8 -8
- package/src/tools/coach/.claude-plugin/plugin.json +1 -1
- package/src/tools/coach/TOOL.yaml +4 -3
- package/src/tools/coach/commands/coach.md +14 -54
- package/{dist/tools/coach/skills/droid-coach → src/tools/coach/skills/coach}/SKILL.md +4 -3
- package/src/tools/code-review/.claude-plugin/plugin.json +1 -1
- package/src/tools/code-review/TOOL.yaml +4 -3
- package/src/tools/code-review/commands/code-review.md +18 -102
- package/src/tools/code-review/skills/code-review/SKILL.md +154 -0
- package/src/tools/codex/.claude-plugin/plugin.json +1 -1
- package/src/tools/codex/TOOL.yaml +4 -3
- package/src/tools/codex/commands/codex.md +18 -65
- package/src/tools/codex/skills/{droid-codex → codex}/SKILL.md +64 -45
- package/{dist/tools/codex/skills/droid-codex → src/tools/codex/skills/codex}/references/loading.md +94 -55
- package/src/tools/comments/.claude-plugin/plugin.json +1 -1
- package/src/tools/comments/TOOL.yaml +4 -3
- package/src/tools/comments/commands/comments.md +12 -14
- package/{dist/tools/comments/skills/droid-comments → src/tools/comments/skills/comments}/SKILL.md +3 -1
- package/src/tools/project/.claude-plugin/plugin.json +1 -1
- package/src/tools/project/TOOL.yaml +4 -3
- package/src/tools/project/commands/project.md +12 -27
- package/src/tools/project/skills/{droid-project → project}/SKILL.md +12 -11
- package/src/tools/tech-design/.claude-plugin/plugin.json +1 -1
- package/src/tools/tech-design/TOOL.yaml +4 -3
- package/src/tools/tech-design/commands/tech-design.md +18 -80
- package/{dist/tools/tech-design/skills/droid-tech-design → src/tools/tech-design/skills/tech-design}/SKILL.md +1 -1
- package/dist/tools/code-review/skills/droid-code-review/SKILL.md +0 -55
- package/dist/tools/codex/skills/droid-codex/scripts/git-finish-write.d.ts.map +0 -1
- package/dist/tools/codex/skills/droid-codex/scripts/git-preamble.d.ts.map +0 -1
- package/dist/tools/codex/skills/droid-codex/scripts/git-start-write.d.ts.map +0 -1
- package/src/tools/code-review/skills/droid-code-review/SKILL.md +0 -55
- /package/dist/tools/brain/skills/{droid-brain → brain}/references/metadata.md +0 -0
- /package/dist/tools/brain/skills/{droid-brain → brain}/references/naming.md +0 -0
- /package/dist/tools/brain/skills/{droid-brain → brain}/references/templates.md +0 -0
- /package/dist/tools/brain/skills/{droid-brain → brain}/references/workflows.md +0 -0
- /package/dist/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/templates.md +0 -0
- /package/dist/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/workflows.md +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/references/creating.md +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/references/decisions.md +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/references/topics.md +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-finish-write.d.ts +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-finish-write.ts +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-preamble.d.ts +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-preamble.ts +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-scripts.test.ts +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-start-write.d.ts +0 -0
- /package/dist/tools/codex/skills/{droid-codex → codex}/scripts/git-start-write.ts +0 -0
- /package/dist/tools/project/skills/{droid-project → project}/references/changelog.md +0 -0
- /package/dist/tools/project/skills/{droid-project → project}/references/creating.md +0 -0
- /package/dist/tools/project/skills/{droid-project → project}/references/loading.md +0 -0
- /package/dist/tools/project/skills/{droid-project → project}/references/templates.md +0 -0
- /package/dist/tools/project/skills/{droid-project → project}/references/updating.md +0 -0
- /package/dist/tools/project/skills/{droid-project → project}/references/versioning.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/draft.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/gaps.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/publish.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/research-doc-template.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/rollup-template.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/start.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/think.md +0 -0
- /package/dist/tools/tech-design/skills/{droid-tech-design → tech-design}/references/thought-doc-template.md +0 -0
- /package/src/tools/brain/skills/{droid-brain → brain}/references/metadata.md +0 -0
- /package/src/tools/brain/skills/{droid-brain → brain}/references/naming.md +0 -0
- /package/src/tools/brain/skills/{droid-brain → brain}/references/templates.md +0 -0
- /package/src/tools/brain/skills/{droid-brain → brain}/references/workflows.md +0 -0
- /package/src/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/templates.md +0 -0
- /package/src/tools/brain/skills/{droid-brain-obsidian → brain-obsidian}/references/workflows.md +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/references/creating.md +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/references/decisions.md +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/references/topics.md +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-finish-write.ts +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-preamble.ts +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-scripts.test.ts +0 -0
- /package/src/tools/codex/skills/{droid-codex → codex}/scripts/git-start-write.ts +0 -0
- /package/src/tools/project/skills/{droid-project → project}/references/changelog.md +0 -0
- /package/src/tools/project/skills/{droid-project → project}/references/creating.md +0 -0
- /package/src/tools/project/skills/{droid-project → project}/references/loading.md +0 -0
- /package/src/tools/project/skills/{droid-project → project}/references/templates.md +0 -0
- /package/src/tools/project/skills/{droid-project → project}/references/updating.md +0 -0
- /package/src/tools/project/skills/{droid-project → project}/references/versioning.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/draft.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/gaps.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/publish.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/research-doc-template.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/rollup-template.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/start.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/think.md +0 -0
- /package/src/tools/tech-design/skills/{droid-tech-design → tech-design}/references/thought-doc-template.md +0 -0
package/{dist/tools/codex/skills/droid-codex → src/tools/codex/skills/codex}/references/loading.md
RENAMED
|
@@ -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
|
|
63
|
-
|
|
64
|
-
| 1
|
|
65
|
-
| 2
|
|
66
|
-
| 3
|
|
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
|
|
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 -
|
|
135
|
-
Meanwhile, which file do you want to load?
|
|
138
|
+
No CONTEXT.md found - generating summary from available artifacts...
|
|
136
139
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
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
|
|
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
|
-
|
|
173
|
+
**Choose whichever approach works best.** Synchronous is simpler and works everywhere. Asynchronous avoids blocking but requires background agent support.
|
|
155
174
|
|
|
156
|
-
|
|
175
|
+
### CONTEXT.md Template
|
|
157
176
|
|
|
158
|
-
|
|
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
|
-
|
|
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
|
-
|
|
173
|
-
{Synthesised from PRD problem statement + goals}
|
|
189
|
+
# {Project Name} - Context
|
|
174
190
|
|
|
175
|
-
|
|
176
|
-
{Synthesised from TECH-DESIGN architecture + key decisions}
|
|
191
|
+
## Overview
|
|
177
192
|
|
|
178
|
-
|
|
179
|
-
{Summarised from DECISIONS.md}
|
|
193
|
+
{Synthesised from PRD problem statement + goals}
|
|
180
194
|
|
|
181
|
-
|
|
182
|
-
{Inferred from most recent updates}
|
|
195
|
+
## Technical Approach
|
|
183
196
|
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
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
|
-
|
|
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.
|
|
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.
|
|
3
|
+
version: 0.3.0
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
7
7
|
skills:
|
|
8
|
-
- name:
|
|
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
|
-
|
|
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
|
|
7
|
+
# /comments
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
**User invoked:** `/comments $ARGUMENTS`
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
**Your task:** Invoke the **comments skill** with these arguments.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## Examples
|
|
14
14
|
|
|
15
|
-
|
|
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
|
-
|
|
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.
|
package/{dist/tools/comments/skills/droid-comments → src/tools/comments/skills/comments}/SKILL.md
RENAMED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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.
|
|
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.
|
|
3
|
+
version: 0.3.0
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
7
7
|
skills:
|
|
8
|
-
- name:
|
|
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
|
-
|
|
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
|
-
|
|
9
|
+
**User invoked:** `/project $ARGUMENTS`
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
**Your task:** Invoke the **project skill** with these arguments.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## Example
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
If user typed `/project droid`, you should interpret this as: "Search for and load a project matching 'droid'"
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
If user typed `/project create new-feature`, interpret as: "Create a new project named 'new-feature'"
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## Quick Reference
|
|
20
20
|
|
|
21
21
|
```
|
|
22
22
|
/project # List and select a project
|
|
23
|
-
/project {keywords} # SEARCH
|
|
23
|
+
/project {keywords} # SEARCH for existing project (default action)
|
|
24
24
|
/project update # Update from conversation context
|
|
25
|
-
/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
|
-
|
|
28
|
+
**Default behavior:** When given keywords, SEARCH first (don't create unless "create" keyword is present).
|
|
31
29
|
|
|
32
|
-
**
|
|
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:
|
|
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
|
|
37
|
-
|
|
36
|
+
| Setting | Default | Description |
|
|
37
|
+
| -------------- | ----------- | ------------------------------------------------- |
|
|
38
38
|
| `projects_dir` | (see below) | Where projects are stored (use ONE location only) |
|
|
39
|
-
| `preset`
|
|
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
|
|
48
|
-
|
|
49
|
-
| `/project`
|
|
50
|
-
| `/project {keywords}`
|
|
51
|
-
| `/project create {name}`
|
|
52
|
-
| `/project create --from codex:{name}` | Create project seeded with codex context
|
|
53
|
-
| `/project update`
|
|
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.
|
|
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.
|
|
3
|
+
version: 0.2.0
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
7
7
|
skills:
|
|
8
|
-
- name:
|
|
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
|
-
|
|
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
|
-
|
|
9
|
+
**User invoked:** `/tech-design $ARGUMENTS`
|
|
10
10
|
|
|
11
|
-
|
|
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
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
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
|
-
|
|
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:
|
|
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"}
|