@orderful/droid 0.32.0 → 0.33.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 (80) hide show
  1. package/.claude-plugin/marketplace.json +21 -8
  2. package/CHANGELOG.md +56 -0
  3. package/README.md +24 -0
  4. package/dist/tools/brain/.claude-plugin/plugin.json +1 -1
  5. package/dist/tools/brain/TOOL.yaml +1 -1
  6. package/dist/tools/brain/skills/brain/SKILL.md +6 -4
  7. package/dist/tools/brain/skills/brain/references/workflows.md +17 -12
  8. package/dist/tools/coach/.claude-plugin/plugin.json +1 -1
  9. package/dist/tools/coach/TOOL.yaml +1 -1
  10. package/dist/tools/coach/skills/coach/SKILL.md +2 -1
  11. package/dist/tools/code-review/.claude-plugin/plugin.json +1 -1
  12. package/dist/tools/code-review/TOOL.yaml +1 -1
  13. package/dist/tools/code-review/skills/code-review/SKILL.md +1 -1
  14. package/dist/tools/codex/.claude-plugin/plugin.json +1 -1
  15. package/dist/tools/codex/TOOL.yaml +1 -1
  16. package/dist/tools/codex/skills/codex/SKILL.md +1 -1
  17. package/dist/tools/codex/skills/codex/references/loading.md +1 -1
  18. package/dist/tools/comments/.claude-plugin/plugin.json +1 -1
  19. package/dist/tools/comments/TOOL.yaml +1 -1
  20. package/dist/tools/comments/skills/comments/SKILL.md +9 -7
  21. package/dist/tools/plan/.claude-plugin/plugin.json +16 -0
  22. package/dist/tools/plan/TOOL.yaml +18 -0
  23. package/dist/tools/plan/commands/plan.md +33 -0
  24. package/dist/tools/plan/skills/plan/SKILL.md +103 -0
  25. package/dist/tools/plan/skills/plan/references/templates.md +176 -0
  26. package/dist/tools/plan/skills/plan/references/workflows.md +299 -0
  27. package/dist/tools/plan/skills/plan/references/xml-conversion.md +123 -0
  28. package/dist/tools/project/.claude-plugin/plugin.json +1 -1
  29. package/dist/tools/project/TOOL.yaml +3 -2
  30. package/dist/tools/project/skills/project/SKILL.md +10 -12
  31. package/dist/tools/project/skills/project/references/creating.md +5 -5
  32. package/dist/tools/project/skills/project/references/loading.md +4 -4
  33. package/dist/tools/tech-design/.claude-plugin/plugin.json +1 -1
  34. package/dist/tools/tech-design/TOOL.yaml +1 -1
  35. package/dist/tools/tech-design/skills/tech-design/SKILL.md +3 -3
  36. package/dist/tools/tech-design/skills/tech-design/references/publish.md +1 -1
  37. package/dist/tools/tech-design/skills/tech-design/references/start.md +2 -2
  38. package/dist/tools/wrapup/.claude-plugin/plugin.json +1 -1
  39. package/dist/tools/wrapup/TOOL.yaml +1 -1
  40. package/dist/tools/wrapup/skills/wrapup/SKILL.md +4 -2
  41. package/dist/tools/wrapup/skills/wrapup/references/subagent-prompts.md +19 -11
  42. package/package.json +1 -1
  43. package/src/tools/brain/.claude-plugin/plugin.json +1 -1
  44. package/src/tools/brain/TOOL.yaml +1 -1
  45. package/src/tools/brain/skills/brain/SKILL.md +6 -4
  46. package/src/tools/brain/skills/brain/references/workflows.md +17 -12
  47. package/src/tools/coach/.claude-plugin/plugin.json +1 -1
  48. package/src/tools/coach/TOOL.yaml +1 -1
  49. package/src/tools/coach/skills/coach/SKILL.md +2 -1
  50. package/src/tools/code-review/.claude-plugin/plugin.json +1 -1
  51. package/src/tools/code-review/TOOL.yaml +1 -1
  52. package/src/tools/code-review/skills/code-review/SKILL.md +1 -1
  53. package/src/tools/codex/.claude-plugin/plugin.json +1 -1
  54. package/src/tools/codex/TOOL.yaml +1 -1
  55. package/src/tools/codex/skills/codex/SKILL.md +1 -1
  56. package/src/tools/codex/skills/codex/references/loading.md +1 -1
  57. package/src/tools/comments/.claude-plugin/plugin.json +1 -1
  58. package/src/tools/comments/TOOL.yaml +1 -1
  59. package/src/tools/comments/skills/comments/SKILL.md +9 -7
  60. package/src/tools/plan/.claude-plugin/plugin.json +16 -0
  61. package/src/tools/plan/TOOL.yaml +18 -0
  62. package/src/tools/plan/commands/plan.md +33 -0
  63. package/src/tools/plan/skills/plan/SKILL.md +103 -0
  64. package/src/tools/plan/skills/plan/references/templates.md +176 -0
  65. package/src/tools/plan/skills/plan/references/workflows.md +299 -0
  66. package/src/tools/plan/skills/plan/references/xml-conversion.md +123 -0
  67. package/src/tools/project/.claude-plugin/plugin.json +1 -1
  68. package/src/tools/project/TOOL.yaml +3 -2
  69. package/src/tools/project/skills/project/SKILL.md +10 -12
  70. package/src/tools/project/skills/project/references/creating.md +5 -5
  71. package/src/tools/project/skills/project/references/loading.md +4 -4
  72. package/src/tools/tech-design/.claude-plugin/plugin.json +1 -1
  73. package/src/tools/tech-design/TOOL.yaml +1 -1
  74. package/src/tools/tech-design/skills/tech-design/SKILL.md +3 -3
  75. package/src/tools/tech-design/skills/tech-design/references/publish.md +1 -1
  76. package/src/tools/tech-design/skills/tech-design/references/start.md +2 -2
  77. package/src/tools/wrapup/.claude-plugin/plugin.json +1 -1
  78. package/src/tools/wrapup/TOOL.yaml +1 -1
  79. package/src/tools/wrapup/skills/wrapup/SKILL.md +4 -2
  80. package/src/tools/wrapup/skills/wrapup/references/subagent-prompts.md +19 -11
@@ -6,10 +6,10 @@
6
6
 
7
7
  ## Procedure
8
8
 
9
- 1. **Determine projects directory (pick ONE)**
10
- - Read `~/.droid/skills/project/overrides.yaml`
11
- - If `projects_dir` is set → use ONLY that path, do NOT search defaults
12
- - If not configured → use default for current AI tool (`~/.claude/projects` or `~/.config/opencode/projects`)
9
+ 1. **Determine projects directory**
10
+ - Run `droid config project` and parse the JSON output
11
+ - Use the `projects_dir` value
12
+ - If not configured → inform user to create `~/.droid/skills/project/overrides.yaml` with `projects_dir: /path/to/projects`
13
13
 
14
14
  2. **List projects** in the single configured directory
15
15
  - Each subfolder with a `PROJECT.md` is a project
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "droid-tech-design",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
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,6 +1,6 @@
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.2.1
3
+ version: 0.2.3
4
4
  status: beta
5
5
 
6
6
  includes:
@@ -28,8 +28,8 @@ The `/tech-design` skill brings tech design authoring into the same AI-augmented
28
28
 
29
29
  Before using tech-design, verify:
30
30
 
31
- 1. **Brain skill configured:** Check if `~/.droid/skills/brain/overrides.yaml` exists
32
- 2. **Codex skill configured:** Check if `~/.droid/skills/codex/overrides.yaml` exists
31
+ 1. **Brain skill configured:** Run `droid config brain` and check if `brain_dir` is set
32
+ 2. **Codex skill configured:** Run `droid config codex` and check if `codex_repo` is set
33
33
  3. **gh CLI:** Required for PR workflows
34
34
 
35
35
  If prerequisites fail, guide user to configure:
@@ -65,7 +65,7 @@ Tech-design has no configuration of its own. It delegates to:
65
65
  2. **Thought doc** = Design workspace
66
66
  - References research doc for context
67
67
  - Focuses on architectural decisions
68
- - Iterates with `@droid`/`@user` comments
68
+ - Iterates with `@droid`/`@user` comments (the @mention is the **target**: `@droid` = user asking AI, `@user` = AI asking user)
69
69
  - Captures the "why" behind choices
70
70
 
71
71
  3. **Roll-up** = Reviewer artifact
@@ -25,7 +25,7 @@ if [ ! -f "$research_doc_path" ]; then
25
25
  fi
26
26
 
27
27
  # Codex repo must be configured (read from codex skill config)
28
- codex_repo=$(grep '^codex_repo:' ~/.droid/skills/codex/overrides.yaml | cut -d' ' -f2-)
28
+ codex_repo=$(droid config codex | grep -o '"codex_repo": *"[^"]*"' | cut -d'"' -f4)
29
29
  if [ -z "$codex_repo" ]; then
30
30
  echo "Error: Codex not configured."
31
31
  echo "Set up with: /codex"
@@ -12,8 +12,8 @@
12
12
 
13
13
  Check that required tools are configured:
14
14
 
15
- - **Brain skill:** Check if `~/.droid/skills/brain/overrides.yaml` exists
16
- - **Codex skill:** Check if `~/.droid/skills/codex/overrides.yaml` exists
15
+ - **Brain skill:** Run `droid config brain` and check if `brain_dir` is set
16
+ - **Codex skill:** Run `droid config codex` and check if `codex_repo` is set
17
17
 
18
18
  If prerequisites fail, guide user to configure:
19
19
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "droid-wrapup",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Session wrap-up that captures decisions, learnings, and open items to persistent docs.",
5
5
  "author": {
6
6
  "name": "Orderful",
@@ -1,6 +1,6 @@
1
1
  name: wrapup
2
2
  description: "Session wrap-up that captures decisions, learnings, and open items to persistent docs."
3
- version: 0.1.0
3
+ version: 0.1.2
4
4
  status: alpha
5
5
 
6
6
  includes:
@@ -15,7 +15,7 @@ To avoid triggering compaction mid-wrapup, offload heavy lifting to fresh-contex
15
15
 
16
16
  ## Phase 1: Quick Context Extraction
17
17
 
18
- You have the conversation history. Quickly extract and write to `/tmp/wrapup-session-brief.md`:
18
+ You have the conversation history. Generate a unique session ID (e.g., timestamp like `20260118-153042`) and write to `/tmp/wrapup-{session-id}.md`:
19
19
 
20
20
  ```markdown
21
21
  # Session Brief
@@ -41,9 +41,11 @@ You have the conversation history. Quickly extract and write to `/tmp/wrapup-ses
41
41
 
42
42
  Do this IMMEDIATELY. Don't analyse deeply—just dump what you know.
43
43
 
44
+ **Important:** Remember your session brief path for Phase 2 subagents.
45
+
44
46
  ## Phase 2: Artifact Analysis
45
47
 
46
- Spawn subagents **in parallel** to analyse artifacts. Each reads your session brief and analyses one area.
48
+ Spawn subagents **in parallel** to analyse artifacts. Pass your session brief path to each subagent.
47
49
 
48
50
  | Subagent | Type | Analyses |
49
51
  |----------|------|----------|
@@ -2,6 +2,8 @@
2
2
 
3
3
  Detailed prompts for Phase 2 artifact analysis. Spawn these in parallel using the Task tool.
4
4
 
5
+ **Note:** Replace `{session_brief_path}` with the actual path from Phase 1 (e.g., `/tmp/wrapup-20260118-153042.md`).
6
+
5
7
  ## Git State Analysis
6
8
 
7
9
  **Subagent type:** Bash
@@ -24,21 +26,27 @@ Output format:
24
26
 
25
27
  ## Project File Check
26
28
 
27
- **Subagent type:** Explore
29
+ **Subagent type:** Bash
28
30
 
29
31
  ```
30
- Read /tmp/wrapup-session-brief.md for session context.
32
+ Read {session_brief_path} for session context.
31
33
 
32
- Check if ~/.droid/project.md exists. If it does:
33
- 1. Read the current project file
34
- 2. Compare against session brief
35
- 3. Identify:
34
+ First, run `droid config project` to get the project skill configuration.
35
+ Parse the JSON output to find the `projects_dir` value.
36
+
37
+ If `projects_dir` is not set, skip project file analysis.
38
+
39
+ If configured:
40
+ 1. Search the projects directory for recently modified PROJECT.md files (last 7 days)
41
+ 2. Read the most recently modified project file
42
+ 3. Compare against session brief
43
+ 4. Identify:
36
44
  - Stale entries that should be updated or removed
37
45
  - New items from the session to add (decisions, blockers, next steps)
38
46
  - Status changes (completed items, new blockers)
39
47
 
40
48
  Output specific proposed updates with exact text to add/change.
41
- If no project file exists, note that and skip.
49
+ If no active project found, note that and skip.
42
50
  ```
43
51
 
44
52
  ## Brain Doc Check
@@ -46,9 +54,9 @@ If no project file exists, note that and skip.
46
54
  **Subagent type:** Explore
47
55
 
48
56
  ```
49
- Read /tmp/wrapup-session-brief.md for session context.
57
+ Read {session_brief_path} for session context.
50
58
 
51
- First, check ~/.droid/skills/brain/overrides.yaml for the brain_dir setting.
59
+ First, run `droid config brain` and parse the JSON output for the `brain_dir` setting.
52
60
  If not configured, skip brain doc analysis.
53
61
 
54
62
  If configured:
@@ -68,9 +76,9 @@ Output:
68
76
  **Subagent type:** Explore
69
77
 
70
78
  ```
71
- Read /tmp/wrapup-session-brief.md for session context.
79
+ Read {session_brief_path} for session context.
72
80
 
73
- Check if the codex skill is installed (~/.droid/skills/codex/overrides.yaml).
81
+ Run `droid config codex` and check if `codex_repo` is set.
74
82
  If not configured, skip codex analysis.
75
83
 
76
84
  If the session involved: