@orderful/droid 0.31.2 → 0.33.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.
- package/.claude-plugin/marketplace.json +33 -7
- package/AGENTS.md +15 -0
- package/CHANGELOG.md +69 -0
- package/README.md +24 -0
- package/dist/bin/droid.js +515 -434
- package/dist/commands/setup.d.ts +1 -0
- package/dist/commands/setup.d.ts.map +1 -1
- package/dist/commands/tui/components/PlatformBadges.d.ts +6 -0
- package/dist/commands/tui/components/PlatformBadges.d.ts.map +1 -0
- package/dist/commands/tui/components/SettingsDetails.d.ts +4 -1
- package/dist/commands/tui/components/SettingsDetails.d.ts.map +1 -1
- package/dist/commands/tui/types.d.ts +1 -1
- package/dist/commands/tui/types.d.ts.map +1 -1
- package/dist/commands/tui/views/SetupScreen.d.ts +3 -2
- package/dist/commands/tui/views/SetupScreen.d.ts.map +1 -1
- package/dist/commands/tui.d.ts.map +1 -1
- package/dist/index.js +138 -86
- package/dist/lib/agents.d.ts +7 -2
- package/dist/lib/agents.d.ts.map +1 -1
- package/dist/lib/platforms.d.ts +10 -1
- package/dist/lib/platforms.d.ts.map +1 -1
- package/dist/lib/skills.d.ts.map +1 -1
- package/dist/lib/types.d.ts +5 -0
- 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 +1 -1
- package/dist/tools/brain/skills/brain/SKILL.md +6 -4
- package/dist/tools/brain/skills/brain/references/workflows.md +17 -12
- package/dist/tools/coach/.claude-plugin/plugin.json +1 -1
- package/dist/tools/coach/TOOL.yaml +1 -1
- package/dist/tools/coach/skills/coach/SKILL.md +2 -1
- package/dist/tools/code-review/.claude-plugin/plugin.json +1 -1
- package/dist/tools/code-review/TOOL.yaml +1 -1
- package/dist/tools/code-review/skills/code-review/SKILL.md +1 -1
- package/dist/tools/codex/.claude-plugin/plugin.json +1 -1
- package/dist/tools/codex/TOOL.yaml +1 -1
- package/dist/tools/codex/skills/codex/SKILL.md +1 -1
- package/dist/tools/codex/skills/codex/references/loading.md +1 -1
- package/dist/tools/comments/.claude-plugin/plugin.json +1 -1
- package/dist/tools/comments/TOOL.yaml +1 -1
- package/dist/tools/comments/skills/comments/SKILL.md +9 -7
- package/dist/tools/plan/.claude-plugin/plugin.json +16 -0
- package/dist/tools/plan/TOOL.yaml +18 -0
- package/dist/tools/plan/commands/plan.md +33 -0
- package/dist/tools/plan/skills/plan/SKILL.md +103 -0
- package/dist/tools/plan/skills/plan/references/templates.md +176 -0
- package/dist/tools/plan/skills/plan/references/workflows.md +299 -0
- package/dist/tools/plan/skills/plan/references/xml-conversion.md +123 -0
- package/dist/tools/project/.claude-plugin/plugin.json +1 -1
- package/dist/tools/project/TOOL.yaml +3 -2
- package/dist/tools/project/skills/project/SKILL.md +10 -12
- package/dist/tools/project/skills/project/references/creating.md +5 -5
- package/dist/tools/project/skills/project/references/loading.md +4 -4
- package/dist/tools/tech-design/.claude-plugin/plugin.json +1 -1
- package/dist/tools/tech-design/TOOL.yaml +1 -1
- package/dist/tools/tech-design/skills/tech-design/SKILL.md +3 -3
- package/dist/tools/tech-design/skills/tech-design/references/publish.md +1 -1
- package/dist/tools/tech-design/skills/tech-design/references/start.md +2 -2
- package/dist/tools/wrapup/.claude-plugin/plugin.json +16 -0
- package/dist/tools/wrapup/TOOL.yaml +16 -0
- package/dist/tools/wrapup/commands/wrapup.md +21 -0
- package/dist/tools/wrapup/skills/wrapup/SKILL.md +86 -0
- package/dist/tools/wrapup/skills/wrapup/references/output-schema.md +93 -0
- package/dist/tools/wrapup/skills/wrapup/references/subagent-prompts.md +93 -0
- package/package.json +1 -1
- package/src/commands/setup.ts +67 -61
- package/src/commands/tui/components/PlatformBadges.tsx +36 -0
- package/src/commands/tui/components/SettingsDetails.tsx +16 -4
- package/src/commands/tui/types.ts +1 -1
- package/src/commands/tui/views/SetupScreen.tsx +26 -49
- package/src/commands/tui.tsx +21 -9
- package/src/lib/agents.ts +23 -7
- package/src/lib/platforms.ts +44 -1
- package/src/lib/skills.ts +79 -40
- package/src/lib/types.ts +11 -0
- package/src/tools/brain/.claude-plugin/plugin.json +1 -1
- package/src/tools/brain/TOOL.yaml +1 -1
- package/src/tools/brain/skills/brain/SKILL.md +6 -4
- package/src/tools/brain/skills/brain/references/workflows.md +17 -12
- package/src/tools/coach/.claude-plugin/plugin.json +1 -1
- package/src/tools/coach/TOOL.yaml +1 -1
- package/src/tools/coach/skills/coach/SKILL.md +2 -1
- package/src/tools/code-review/.claude-plugin/plugin.json +1 -1
- package/src/tools/code-review/TOOL.yaml +1 -1
- package/src/tools/code-review/skills/code-review/SKILL.md +1 -1
- package/src/tools/codex/.claude-plugin/plugin.json +1 -1
- package/src/tools/codex/TOOL.yaml +1 -1
- package/src/tools/codex/skills/codex/SKILL.md +1 -1
- package/src/tools/codex/skills/codex/references/loading.md +1 -1
- package/src/tools/comments/.claude-plugin/plugin.json +1 -1
- package/src/tools/comments/TOOL.yaml +1 -1
- package/src/tools/comments/skills/comments/SKILL.md +9 -7
- package/src/tools/plan/.claude-plugin/plugin.json +16 -0
- package/src/tools/plan/TOOL.yaml +18 -0
- package/src/tools/plan/commands/plan.md +33 -0
- package/src/tools/plan/skills/plan/SKILL.md +103 -0
- package/src/tools/plan/skills/plan/references/templates.md +176 -0
- package/src/tools/plan/skills/plan/references/workflows.md +299 -0
- package/src/tools/plan/skills/plan/references/xml-conversion.md +123 -0
- package/src/tools/project/.claude-plugin/plugin.json +1 -1
- package/src/tools/project/TOOL.yaml +3 -2
- package/src/tools/project/skills/project/SKILL.md +10 -12
- package/src/tools/project/skills/project/references/creating.md +5 -5
- package/src/tools/project/skills/project/references/loading.md +4 -4
- package/src/tools/tech-design/.claude-plugin/plugin.json +1 -1
- package/src/tools/tech-design/TOOL.yaml +1 -1
- package/src/tools/tech-design/skills/tech-design/SKILL.md +3 -3
- package/src/tools/tech-design/skills/tech-design/references/publish.md +1 -1
- package/src/tools/tech-design/skills/tech-design/references/start.md +2 -2
- package/src/tools/wrapup/.claude-plugin/plugin.json +16 -0
- package/src/tools/wrapup/TOOL.yaml +16 -0
- package/src/tools/wrapup/commands/wrapup.md +21 -0
- package/src/tools/wrapup/skills/wrapup/SKILL.md +86 -0
- package/src/tools/wrapup/skills/wrapup/references/output-schema.md +93 -0
- package/src/tools/wrapup/skills/wrapup/references/subagent-prompts.md +93 -0
package/dist/lib/skills.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,EAGpB,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}
|
package/dist/lib/types.d.ts
CHANGED
|
@@ -40,6 +40,7 @@ export interface DroidConfig {
|
|
|
40
40
|
git_username: string;
|
|
41
41
|
platforms: Record<string, PlatformConfig>;
|
|
42
42
|
auto_update?: AutoUpdateConfig;
|
|
43
|
+
ignored_platforms?: Platform[];
|
|
43
44
|
migrations?: {
|
|
44
45
|
package?: string;
|
|
45
46
|
tools?: Record<string, string>;
|
|
@@ -61,6 +62,10 @@ export declare function getPlatformTools(config: DroidConfig): Record<string, In
|
|
|
61
62
|
* Set installed tools for the current platform
|
|
62
63
|
*/
|
|
63
64
|
export declare function setPlatformTools(config: DroidConfig, tools: Record<string, InstalledSkill>): void;
|
|
65
|
+
/**
|
|
66
|
+
* Get installed tools for a specific platform
|
|
67
|
+
*/
|
|
68
|
+
export declare function getPlatformToolsFor(config: DroidConfig, platform: Platform): Record<string, InstalledSkill>;
|
|
64
69
|
export interface InstalledSkill {
|
|
65
70
|
version: string;
|
|
66
71
|
installed_at: string;
|
package/dist/lib/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "droid-brain",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.5",
|
|
4
4
|
"description": "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Orderful",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
name: brain
|
|
2
2
|
description: "Your scratchpad (or brain) - a collaborative space for planning and research. Create docs with /brain plan, /brain research, or /brain review. Use @mentions for async discussion. Docs persist across sessions."
|
|
3
|
-
version: 0.3.
|
|
3
|
+
version: 0.3.5
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
@@ -26,7 +26,7 @@ Your **scratchpad** (or **brain**) - a collaborative space for planning, researc
|
|
|
26
26
|
|
|
27
27
|
## Configuration
|
|
28
28
|
|
|
29
|
-
**IMPORTANT:**
|
|
29
|
+
**IMPORTANT:** Run `droid config brain` first and parse the JSON output. If `brain_dir` is not configured, **ask the user** where they want brain docs stored.
|
|
30
30
|
|
|
31
31
|
| Setting | Default | Description |
|
|
32
32
|
| -------------- | ------- | ------------------------------------------ |
|
|
@@ -127,10 +127,12 @@ Full procedure: `references/workflows.md` § Finalizing
|
|
|
127
127
|
|
|
128
128
|
## Comment Conventions
|
|
129
129
|
|
|
130
|
-
In markdown files, use blockquote `>` prefix for @mention comments:
|
|
130
|
+
In markdown files, use blockquote `>` prefix for @mention comments. The @mention is the **target**, not the author:
|
|
131
131
|
|
|
132
|
-
|
|
133
|
-
|
|
132
|
+
| Comment | Author | Target | Meaning |
|
|
133
|
+
| -------------- | ------ | ------ | -------------------------- |
|
|
134
|
+
| `> @droid ...` | User | AI | User asking/telling the AI |
|
|
135
|
+
| `> @user ...` | AI | User | AI asking/telling the user |
|
|
134
136
|
|
|
135
137
|
Get `user_mention` from `droid config brain`. If droid's `comments` skill is installed, use `/comments check` for full support.
|
|
136
138
|
|
|
@@ -9,8 +9,8 @@ Detailed procedures for each brain operation.
|
|
|
9
9
|
**Steps:**
|
|
10
10
|
|
|
11
11
|
1. **Read config first (MANDATORY)**
|
|
12
|
-
-
|
|
13
|
-
-
|
|
12
|
+
- Run `droid config brain` and parse the JSON output
|
|
13
|
+
- Use the `brain_dir` value from the config
|
|
14
14
|
- If `brain_dir` is not configured, **ask the user** where they want brain docs stored
|
|
15
15
|
- **Do NOT skip this step or assume defaults**
|
|
16
16
|
|
|
@@ -48,9 +48,8 @@ Detailed procedures for each brain operation.
|
|
|
48
48
|
**Steps:**
|
|
49
49
|
|
|
50
50
|
1. **Read config first (MANDATORY)**
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
- Also check for `inbox_folder` setting (e.g., `0-Inbox`)
|
|
51
|
+
- Run `droid config brain` and parse the JSON output
|
|
52
|
+
- Use the `brain_dir` and `inbox_folder` values from the config
|
|
54
53
|
- If `brain_dir` is not configured, **ask the user** where they want brain docs stored
|
|
55
54
|
- **Do NOT skip this step or assume defaults**
|
|
56
55
|
|
|
@@ -96,9 +95,8 @@ Detailed procedures for each brain operation.
|
|
|
96
95
|
**Steps:**
|
|
97
96
|
|
|
98
97
|
1. **Read config first (MANDATORY)**
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
- Also check for `inbox_folder` setting (e.g., `0-Inbox`)
|
|
98
|
+
- Run `droid config brain` and parse the JSON output
|
|
99
|
+
- Use the `brain_dir` and `inbox_folder` values from the config
|
|
102
100
|
- If `brain_dir` is not configured, **ask the user** where they want brain docs stored
|
|
103
101
|
- **Do NOT skip this step or assume defaults**
|
|
104
102
|
|
|
@@ -152,6 +150,13 @@ Detailed procedures for each brain operation.
|
|
|
152
150
|
|
|
153
151
|
**Prefer `comments` skill:** If the `comments` skill is installed, use `/comments check` instead - it provides better comment detection, cleanup workflows, and supports the full `@droid`/`@user` convention. The workflow below is a fallback for basic comment handling.
|
|
154
152
|
|
|
153
|
+
**Directionality:** The @mention is the **target**, not the author:
|
|
154
|
+
|
|
155
|
+
| Comment | Author | Target | Meaning |
|
|
156
|
+
| -------------- | ------ | ------ | -------------------------- |
|
|
157
|
+
| `> @droid ...` | User | AI | User asking/telling the AI |
|
|
158
|
+
| `> @user ...` | AI | User | AI asking/telling the user |
|
|
159
|
+
|
|
155
160
|
**Steps:**
|
|
156
161
|
|
|
157
162
|
1. **Check for active doc**
|
|
@@ -160,8 +165,8 @@ Detailed procedures for each brain operation.
|
|
|
160
165
|
2. **Read active doc**
|
|
161
166
|
|
|
162
167
|
3. **Check preserve_comments setting:**
|
|
163
|
-
-
|
|
164
|
-
-
|
|
168
|
+
- Run `droid config comments` and parse the JSON output
|
|
169
|
+
- Use the `preserve_comments` value (default: `true`)
|
|
165
170
|
|
|
166
171
|
4. **Find all `> @droid` comments**
|
|
167
172
|
- Pattern: Lines starting with `> @droid` (blockquote with mention)
|
|
@@ -211,8 +216,8 @@ Detailed procedures for each brain operation.
|
|
|
211
216
|
**Steps:**
|
|
212
217
|
|
|
213
218
|
1. **Read config first (MANDATORY)**
|
|
214
|
-
-
|
|
215
|
-
-
|
|
219
|
+
- Run `droid config brain` and parse the JSON output
|
|
220
|
+
- Use the `brain_dir` value from the config
|
|
216
221
|
- If `brain_dir` is not configured, **ask the user** where they want brain docs stored
|
|
217
222
|
- **Do NOT skip this step or assume defaults**
|
|
218
223
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "droid-coach",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.3",
|
|
4
4
|
"description": "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Orderful",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
name: coach
|
|
2
2
|
description: "Learning-mode AI assistance - AI as coach, not crutch. Use /coach plan for co-authored planning, /coach scaffold for structure with hints, /coach review for Socratic questions."
|
|
3
|
-
version: 0.2.
|
|
3
|
+
version: 0.2.3
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
@@ -53,10 +53,11 @@ plan → AI scaffolds → human implements → AI coaches → iterate → ship
|
|
|
53
53
|
| -------------------- | -------- | ------------------------------------------------------- |
|
|
54
54
|
| `scaffold_verbosity` | `medium` | How detailed hints are: `minimal`, `medium`, `detailed` |
|
|
55
55
|
|
|
56
|
+
<!-- Note: @mention is the target, not author. @fry = AI talking TO user, @droid = user talking TO AI -->
|
|
56
57
|
> @fry Not yet - droid currently shows config as free text input. But we could add an `enum` type to the config schema that presents as a select dropdown in the TUI. Good feature request - want me to create an issue for it?
|
|
57
58
|
> @droid yes lets do that
|
|
58
59
|
|
|
59
|
-
|
|
60
|
+
Run `droid config coach` to get the merged configuration.
|
|
60
61
|
|
|
61
62
|
---
|
|
62
63
|
|
|
@@ -64,7 +64,7 @@ Ask the user: **"Would you like the review results saved to a `/brain review` do
|
|
|
64
64
|
|
|
65
65
|
- If yes: Create a brain review doc at the start using `/brain review {PR title or branch name}`
|
|
66
66
|
- The final report will be written to the brain doc instead of just displayed
|
|
67
|
-
- This allows for async discussion via `@droid`/`@{user}` comments
|
|
67
|
+
- This allows for async discussion via `@droid`/`@{user}` comments (the @mention is the **target**: `@droid` = user asking AI, `@user` = AI asking user)
|
|
68
68
|
|
|
69
69
|
If brain skill is not installed or user declines, proceed with normal terminal output.
|
|
70
70
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "droid-codex",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.10",
|
|
4
4
|
"description": "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Orderful",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
name: codex
|
|
2
2
|
description: "Shared organizational knowledge - PRDs, tech designs, domains, proposals, patterns, and explored topics. Use when loading project context, searching codex, capturing decisions, or creating new entries."
|
|
3
|
-
version: 0.1.
|
|
3
|
+
version: 0.1.10
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
@@ -141,7 +141,7 @@ fi
|
|
|
141
141
|
|
|
142
142
|
## Configuration
|
|
143
143
|
|
|
144
|
-
**ALWAYS
|
|
144
|
+
**ALWAYS run `droid config codex` first and parse the JSON output.**
|
|
145
145
|
|
|
146
146
|
| Setting | Default | Description |
|
|
147
147
|
| ---------------- | --------------------------------- | ----------------------------- |
|
|
@@ -6,7 +6,7 @@ Detailed procedure for loading entries from the codex.
|
|
|
6
6
|
|
|
7
7
|
**IMPORTANT:** Use the index file for fast lookups. This avoids expensive file-by-file searching.
|
|
8
8
|
|
|
9
|
-
1. **Get codex repo path**
|
|
9
|
+
1. **Get codex repo path** by running `droid config codex` and parsing the JSON output
|
|
10
10
|
2. **Read the index file** at `{codex_repo}/index.yaml`:
|
|
11
11
|
```yaml
|
|
12
12
|
# index.yaml structure
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "droid-comments",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.3",
|
|
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,6 +1,6 @@
|
|
|
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.
|
|
3
|
+
version: 0.3.3
|
|
4
4
|
status: beta
|
|
5
5
|
|
|
6
6
|
includes:
|
|
@@ -29,16 +29,18 @@ The AI will respond with `> @{user_mention}` (configured in droid setup, e.g., `
|
|
|
29
29
|
|
|
30
30
|
**CRITICAL: The `@mention` is who you're talking TO, not who is speaking.**
|
|
31
31
|
|
|
32
|
+
The directionality can be confusing. The @mention is the **target**, not the author:
|
|
33
|
+
|
|
34
|
+
| Comment | Author | Target | Meaning |
|
|
35
|
+
| -------------- | ------ | ------ | -------------------------- |
|
|
36
|
+
| `> @droid ...` | User | AI | User asking/telling the AI |
|
|
37
|
+
| `> @user ...` | AI | User | AI asking/telling the user |
|
|
38
|
+
|
|
32
39
|
Think of it like addressing someone in conversation:
|
|
33
40
|
|
|
34
41
|
- "Hey @droid, what do you think?" → User talking TO the AI
|
|
35
42
|
- "Good point @fry, here's my take..." → AI talking TO the user
|
|
36
43
|
|
|
37
|
-
| When you see... | Who wrote it | Who it's addressed to |
|
|
38
|
-
| --------------- | ------------ | --------------------- |
|
|
39
|
-
| `> @droid ...` | User | AI (droid) |
|
|
40
|
-
| `> @fry ...` | AI | User (fry) |
|
|
41
|
-
|
|
42
44
|
**Examples:**
|
|
43
45
|
|
|
44
46
|
```markdown
|
|
@@ -82,7 +84,7 @@ When you find a `@droid` marker:
|
|
|
82
84
|
|
|
83
85
|
#### Pass 1: Read & Analyse
|
|
84
86
|
|
|
85
|
-
1. **Read config first:**
|
|
87
|
+
1. **Read config first:** Run `droid config comments` and check `preserve_comments` setting (default: `true`)
|
|
86
88
|
2. Search for ALL `> @droid` comments (and any configured `ai_mentions`) in the specified scope
|
|
87
89
|
3. If there's a `git diff`, check those files first for relevant context
|
|
88
90
|
4. **Read all comments before responding** - understand the full picture
|
|
@@ -107,7 +109,7 @@ When you find a `@droid` marker:
|
|
|
107
109
|
|
|
108
110
|
## Configuration
|
|
109
111
|
|
|
110
|
-
Configured via
|
|
112
|
+
Configured via `droid config comments` (merges global config with skill overrides):
|
|
111
113
|
|
|
112
114
|
```yaml
|
|
113
115
|
# Override the user mention (default: from global config)
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "droid-plan",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Orderful",
|
|
7
|
+
"url": "https://github.com/orderful"
|
|
8
|
+
},
|
|
9
|
+
"repository": "https://github.com/orderful/droid",
|
|
10
|
+
"license": "MIT",
|
|
11
|
+
"keywords": [
|
|
12
|
+
"droid",
|
|
13
|
+
"ai",
|
|
14
|
+
"plan"
|
|
15
|
+
]
|
|
16
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
name: plan
|
|
2
|
+
description: "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'."
|
|
3
|
+
version: 0.1.0
|
|
4
|
+
status: alpha
|
|
5
|
+
|
|
6
|
+
includes:
|
|
7
|
+
skills:
|
|
8
|
+
- name: plan
|
|
9
|
+
required: true
|
|
10
|
+
commands:
|
|
11
|
+
- name: plan
|
|
12
|
+
is_alias: false
|
|
13
|
+
|
|
14
|
+
dependencies:
|
|
15
|
+
- brain
|
|
16
|
+
- comments
|
|
17
|
+
|
|
18
|
+
config_schema: {}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: plan
|
|
3
|
+
description: "Task-scoped planning with portable, structured plans"
|
|
4
|
+
argument-hint: "new|search|check|ready|implement [topic]"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# /plan
|
|
8
|
+
|
|
9
|
+
**User invoked:** `/plan $ARGUMENTS`
|
|
10
|
+
|
|
11
|
+
**Your task:** Invoke the **plan skill** with these arguments.
|
|
12
|
+
|
|
13
|
+
## Quick Reference
|
|
14
|
+
|
|
15
|
+
| Command | Action |
|
|
16
|
+
|---------|--------|
|
|
17
|
+
| `/plan new {topic}` | Create new plan, offer context loading |
|
|
18
|
+
| `/plan search {topic}` | Find and load existing plan |
|
|
19
|
+
| `/plan check` | Address @droid comments |
|
|
20
|
+
| `/plan ready` | Finalize and validate |
|
|
21
|
+
| `/plan implement` | Execute the plan |
|
|
22
|
+
|
|
23
|
+
## Examples
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
/plan new auth-refactor # Start planning auth refactor
|
|
27
|
+
/plan search rate-limit # Find existing rate limit plan
|
|
28
|
+
/plan check # Address open comments
|
|
29
|
+
/plan ready # Mark plan as ready
|
|
30
|
+
/plan implement # Execute the plan
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
See the **plan skill** for complete documentation.
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: plan
|
|
3
|
+
description: "Task-scoped planning with portable, structured plans. Use when planning implementation for a PR, ticket, or small feature. User prompts like 'let's plan this', 'can we start a plan', 'think through the implementation'."
|
|
4
|
+
allowed-tools: [Read, Edit, Write, Glob, Grep, Bash, Task, AskUserQuestion]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Plan Skill
|
|
8
|
+
|
|
9
|
+
Task-scoped planning for PRs, tickets, and small features. Lighter than `/tech-design` (epic-level), heavier than just doing.
|
|
10
|
+
|
|
11
|
+
## When to Use
|
|
12
|
+
|
|
13
|
+
- Implementation spans multiple files or steps
|
|
14
|
+
- Decisions need documenting before coding
|
|
15
|
+
- Work will span sessions or be handed off
|
|
16
|
+
- User says "let's plan", "think through", "before we start"
|
|
17
|
+
|
|
18
|
+
## When NOT to Use
|
|
19
|
+
|
|
20
|
+
- Quick fixes or single-file changes
|
|
21
|
+
- Epic-level work (use `/tech-design` instead)
|
|
22
|
+
- Pure research (use `/brain research` instead)
|
|
23
|
+
|
|
24
|
+
## Configuration
|
|
25
|
+
|
|
26
|
+
Uses config from dependencies:
|
|
27
|
+
- `droid config brain` → `brain_dir`, `inbox_dir`
|
|
28
|
+
- `droid config comments` → `user_mention`
|
|
29
|
+
|
|
30
|
+
## Commands
|
|
31
|
+
|
|
32
|
+
| Command | Action |
|
|
33
|
+
| ---------------------- | --------------------------------------------------- |
|
|
34
|
+
| `/plan new {topic}` | Create plan doc, offer context loading |
|
|
35
|
+
| `/plan search {topic}` | Find and load existing plan |
|
|
36
|
+
| `/plan check` | Address `@droid` comments, graduate to decisions |
|
|
37
|
+
| `/plan ready` | Finalize: validate and update status |
|
|
38
|
+
| `/plan implement` | Execute tasks, optionally convert to XML |
|
|
39
|
+
|
|
40
|
+
## `/plan new {topic}`
|
|
41
|
+
|
|
42
|
+
1. Read config (`brain_dir`, `inbox_dir`, `user_mention`)
|
|
43
|
+
2. Determine location:
|
|
44
|
+
- If `/project` active → offer: `{projects_dir}/{project}/plans/`
|
|
45
|
+
- Otherwise → `{brain_dir}/{inbox_dir}/plans/`
|
|
46
|
+
3. Offer context loading (`/project`, `/codex` search)
|
|
47
|
+
4. Ask clarifying questions (goal, scope, constraints)
|
|
48
|
+
5. Generate plan from template (see `references/templates.md`)
|
|
49
|
+
6. Set as active plan
|
|
50
|
+
|
|
51
|
+
## `/plan search {topic}`
|
|
52
|
+
|
|
53
|
+
1. Search `{brain_dir}/**/plan-*.md` for topic (fuzzy match)
|
|
54
|
+
2. If multiple: prompt user to select
|
|
55
|
+
3. Display summary (status, tasks, open discussions)
|
|
56
|
+
4. Set as active plan
|
|
57
|
+
|
|
58
|
+
## `/plan check`
|
|
59
|
+
|
|
60
|
+
1. Find `> @droid` comments in active plan
|
|
61
|
+
2. Address each, respond with `> @{user_mention}`
|
|
62
|
+
3. Ask if resolved → graduate to Locked-In Decisions table
|
|
63
|
+
4. Update the doc
|
|
64
|
+
|
|
65
|
+
See `references/workflows.md` for graduation pattern.
|
|
66
|
+
|
|
67
|
+
## `/plan ready`
|
|
68
|
+
|
|
69
|
+
1. Check for unresolved discussions (warn if any)
|
|
70
|
+
2. Validate required sections (Context, at least one Task)
|
|
71
|
+
3. Update status to `ready`
|
|
72
|
+
4. Offer: stay in brain, copy to PR description, link in project
|
|
73
|
+
|
|
74
|
+
## `/plan implement`
|
|
75
|
+
|
|
76
|
+
1. Parse tasks from `### Task N:` sections
|
|
77
|
+
2. Optionally convert to XML (see `references/xml-conversion.md`)
|
|
78
|
+
3. For each task:
|
|
79
|
+
- Execute per `**Files:**` section
|
|
80
|
+
- Run `**Verify:**` command
|
|
81
|
+
- Check `**Done:**` criteria
|
|
82
|
+
- Mark complete in plan doc
|
|
83
|
+
4. Update status to `done`
|
|
84
|
+
|
|
85
|
+
## Comment Conventions
|
|
86
|
+
|
|
87
|
+
| Comment | Written by | Addressed to |
|
|
88
|
+
| ---------------- | ---------- | ------------ |
|
|
89
|
+
| `> @droid ...` | User | AI |
|
|
90
|
+
| `> @{user} ...` | AI | User |
|
|
91
|
+
|
|
92
|
+
## Natural Language Triggers
|
|
93
|
+
|
|
94
|
+
Recognise planning intent and offer `/plan new`:
|
|
95
|
+
- "Can we plan this out?"
|
|
96
|
+
- "Let's think through the implementation"
|
|
97
|
+
- "Before we start coding..."
|
|
98
|
+
|
|
99
|
+
## References
|
|
100
|
+
|
|
101
|
+
- `references/templates.md` - Plan doc template with examples
|
|
102
|
+
- `references/workflows.md` - Detailed command flows
|
|
103
|
+
- `references/xml-conversion.md` - XML conversion for `/plan implement`
|