maestro-flow 0.5.3 → 0.5.31

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 (259) hide show
  1. package/.agents/skills/learn-follow/SKILL.md +114 -114
  2. package/.agents/skills/learn-investigate/SKILL.md +138 -139
  3. package/.agents/skills/learn-second-opinion/SKILL.md +105 -109
  4. package/.agents/skills/maestro/SKILL.md +2 -10
  5. package/.agents/skills/maestro-amend/SKILL.md +152 -152
  6. package/.agents/skills/maestro-analyze/SKILL.md +201 -252
  7. package/.agents/skills/maestro-blueprint/SKILL.md +175 -190
  8. package/.agents/skills/maestro-brainstorm/SKILL.md +196 -200
  9. package/.agents/skills/maestro-collab/SKILL.md +159 -159
  10. package/.agents/skills/maestro-companion/SKILL.md +517 -517
  11. package/.agents/skills/maestro-composer/SKILL.md +173 -164
  12. package/.agents/skills/maestro-execute/SKILL.md +169 -170
  13. package/.agents/skills/maestro-fork/SKILL.md +97 -96
  14. package/.agents/skills/maestro-grill/SKILL.md +161 -162
  15. package/.agents/skills/maestro-guard/SKILL.md +93 -92
  16. package/.agents/skills/maestro-impeccable/SKILL.md +296 -253
  17. package/.agents/skills/maestro-init/SKILL.md +117 -118
  18. package/.agents/skills/maestro-merge/SKILL.md +73 -66
  19. package/.agents/skills/maestro-milestone-audit/SKILL.md +4 -10
  20. package/.agents/skills/maestro-milestone-complete/SKILL.md +6 -7
  21. package/.agents/skills/maestro-milestone-release/SKILL.md +122 -131
  22. package/.agents/skills/maestro-next/SKILL.md +241 -245
  23. package/.agents/skills/maestro-overlay/SKILL.md +176 -166
  24. package/.agents/skills/maestro-plan/SKILL.md +211 -197
  25. package/.agents/skills/maestro-player/SKILL.md +167 -167
  26. package/.agents/skills/maestro-quick/SKILL.md +69 -63
  27. package/.agents/skills/maestro-ralph/SKILL.md +2 -36
  28. package/.agents/skills/maestro-ralph-beta/SKILL.md +861 -872
  29. package/.agents/skills/maestro-ralph-execute/SKILL.md +234 -234
  30. package/.agents/skills/maestro-roadmap/SKILL.md +159 -172
  31. package/.agents/skills/maestro-swarm-workflow/SKILL.md +229 -250
  32. package/.agents/skills/maestro-tools-execute/SKILL.md +108 -103
  33. package/.agents/skills/maestro-tools-register/SKILL.md +148 -143
  34. package/.agents/skills/maestro-ui-codify/SKILL.md +103 -86
  35. package/.agents/skills/maestro-universal-workflow/SKILL.md +534 -547
  36. package/.agents/skills/maestro-update/SKILL.md +109 -106
  37. package/.agents/skills/manage-codebase-rebuild/SKILL.md +73 -71
  38. package/.agents/skills/manage-harvest/SKILL.md +83 -81
  39. package/.agents/skills/manage-issue/SKILL.md +59 -60
  40. package/.agents/skills/manage-issue-discover/SKILL.md +70 -68
  41. package/.agents/skills/manage-kg-extractors/SKILL.md +130 -0
  42. package/.agents/skills/manage-knowhow/SKILL.md +70 -66
  43. package/.agents/skills/manage-knowhow-capture/SKILL.md +79 -69
  44. package/.agents/skills/manage-knowledge-audit/SKILL.md +91 -74
  45. package/.agents/skills/manage-status/SKILL.md +52 -42
  46. package/.agents/skills/manage-wiki/SKILL.md +69 -58
  47. package/.agents/skills/odyssey-debug/SKILL.md +445 -459
  48. package/.agents/skills/odyssey-improve/SKILL.md +477 -491
  49. package/.agents/skills/odyssey-planex/SKILL.md +576 -587
  50. package/.agents/skills/odyssey-review-test-fix/SKILL.md +400 -413
  51. package/.agents/skills/odyssey-ui/SKILL.md +431 -448
  52. package/.agents/skills/quality-auto-test/SKILL.md +140 -123
  53. package/.agents/skills/quality-debug/SKILL.md +145 -106
  54. package/.agents/skills/quality-refactor/SKILL.md +91 -53
  55. package/.agents/skills/quality-retrospective/SKILL.md +109 -63
  56. package/.agents/skills/quality-review/SKILL.md +141 -114
  57. package/.agents/skills/quality-sync/SKILL.md +74 -38
  58. package/.agents/skills/quality-test/SKILL.md +133 -103
  59. package/.agents/skills/security-audit/SKILL.md +217 -166
  60. package/.agents/skills/spec-add/SKILL.md +66 -59
  61. package/.agents/skills/spec-load/SKILL.md +68 -68
  62. package/.agents/skills/spec-remove/SKILL.md +42 -42
  63. package/.agents/skills/spec-setup/SKILL.md +38 -41
  64. package/.agy/skills/learn-follow/SKILL.md +114 -114
  65. package/.agy/skills/learn-investigate/SKILL.md +138 -139
  66. package/.agy/skills/learn-second-opinion/SKILL.md +105 -109
  67. package/.agy/skills/maestro/SKILL.md +2 -10
  68. package/.agy/skills/maestro-amend/SKILL.md +152 -152
  69. package/.agy/skills/maestro-analyze/SKILL.md +201 -252
  70. package/.agy/skills/maestro-blueprint/SKILL.md +175 -190
  71. package/.agy/skills/maestro-brainstorm/SKILL.md +196 -200
  72. package/.agy/skills/maestro-collab/SKILL.md +159 -159
  73. package/.agy/skills/maestro-companion/SKILL.md +517 -517
  74. package/.agy/skills/maestro-composer/SKILL.md +173 -164
  75. package/.agy/skills/maestro-execute/SKILL.md +169 -170
  76. package/.agy/skills/maestro-fork/SKILL.md +97 -96
  77. package/.agy/skills/maestro-grill/SKILL.md +161 -162
  78. package/.agy/skills/maestro-guard/SKILL.md +93 -92
  79. package/.agy/skills/maestro-impeccable/SKILL.md +296 -253
  80. package/.agy/skills/maestro-init/SKILL.md +117 -118
  81. package/.agy/skills/maestro-merge/SKILL.md +73 -66
  82. package/.agy/skills/maestro-milestone-audit/SKILL.md +4 -10
  83. package/.agy/skills/maestro-milestone-complete/SKILL.md +6 -7
  84. package/.agy/skills/maestro-milestone-release/SKILL.md +122 -131
  85. package/.agy/skills/maestro-next/SKILL.md +241 -245
  86. package/.agy/skills/maestro-overlay/SKILL.md +176 -166
  87. package/.agy/skills/maestro-plan/SKILL.md +211 -197
  88. package/.agy/skills/maestro-player/SKILL.md +167 -167
  89. package/.agy/skills/maestro-quick/SKILL.md +69 -63
  90. package/.agy/skills/maestro-ralph/SKILL.md +2 -36
  91. package/.agy/skills/maestro-ralph-beta/SKILL.md +861 -872
  92. package/.agy/skills/maestro-ralph-execute/SKILL.md +234 -234
  93. package/.agy/skills/maestro-roadmap/SKILL.md +159 -172
  94. package/.agy/skills/maestro-swarm-workflow/SKILL.md +229 -250
  95. package/.agy/skills/maestro-tools-execute/SKILL.md +108 -103
  96. package/.agy/skills/maestro-tools-register/SKILL.md +148 -143
  97. package/.agy/skills/maestro-ui-codify/SKILL.md +103 -86
  98. package/.agy/skills/maestro-universal-workflow/SKILL.md +534 -547
  99. package/.agy/skills/maestro-update/SKILL.md +109 -106
  100. package/.agy/skills/manage-codebase-rebuild/SKILL.md +73 -71
  101. package/.agy/skills/manage-harvest/SKILL.md +83 -81
  102. package/.agy/skills/manage-issue/SKILL.md +59 -60
  103. package/.agy/skills/manage-issue-discover/SKILL.md +70 -68
  104. package/.agy/skills/manage-kg-extractors/SKILL.md +130 -0
  105. package/.agy/skills/manage-knowhow/SKILL.md +70 -66
  106. package/.agy/skills/manage-knowhow-capture/SKILL.md +79 -69
  107. package/.agy/skills/manage-knowledge-audit/SKILL.md +91 -74
  108. package/.agy/skills/manage-status/SKILL.md +52 -42
  109. package/.agy/skills/manage-wiki/SKILL.md +69 -58
  110. package/.agy/skills/odyssey-debug/SKILL.md +445 -459
  111. package/.agy/skills/odyssey-improve/SKILL.md +477 -491
  112. package/.agy/skills/odyssey-planex/SKILL.md +576 -587
  113. package/.agy/skills/odyssey-review-test-fix/SKILL.md +400 -413
  114. package/.agy/skills/odyssey-ui/SKILL.md +431 -448
  115. package/.agy/skills/quality-auto-test/SKILL.md +140 -123
  116. package/.agy/skills/quality-debug/SKILL.md +145 -106
  117. package/.agy/skills/quality-refactor/SKILL.md +91 -53
  118. package/.agy/skills/quality-retrospective/SKILL.md +109 -63
  119. package/.agy/skills/quality-review/SKILL.md +141 -114
  120. package/.agy/skills/quality-sync/SKILL.md +74 -38
  121. package/.agy/skills/quality-test/SKILL.md +133 -103
  122. package/.agy/skills/security-audit/SKILL.md +217 -166
  123. package/.agy/skills/spec-add/SKILL.md +66 -59
  124. package/.agy/skills/spec-load/SKILL.md +68 -68
  125. package/.agy/skills/spec-remove/SKILL.md +42 -42
  126. package/.agy/skills/spec-setup/SKILL.md +38 -41
  127. package/.claude/commands/learn-follow.md +127 -127
  128. package/.claude/commands/learn-investigate.md +151 -152
  129. package/.claude/commands/learn-second-opinion.md +118 -122
  130. package/.claude/commands/maestro-amend.md +164 -164
  131. package/.claude/commands/maestro-analyze.md +215 -266
  132. package/.claude/commands/maestro-blueprint.md +189 -204
  133. package/.claude/commands/maestro-brainstorm.md +209 -213
  134. package/.claude/commands/maestro-collab.md +172 -172
  135. package/.claude/commands/maestro-companion.md +531 -531
  136. package/.claude/commands/maestro-composer.md +188 -179
  137. package/.claude/commands/maestro-execute.md +183 -184
  138. package/.claude/commands/maestro-fork.md +111 -110
  139. package/.claude/commands/maestro-grill.md +175 -176
  140. package/.claude/commands/maestro-guard.md +103 -102
  141. package/.claude/commands/maestro-impeccable.md +311 -268
  142. package/.claude/commands/maestro-init.md +130 -131
  143. package/.claude/commands/maestro-merge.md +87 -80
  144. package/.claude/commands/maestro-milestone-audit.md +4 -10
  145. package/.claude/commands/maestro-milestone-complete.md +6 -7
  146. package/.claude/commands/maestro-milestone-release.md +136 -145
  147. package/.claude/commands/maestro-next.md +253 -257
  148. package/.claude/commands/maestro-overlay.md +188 -178
  149. package/.claude/commands/maestro-plan.md +225 -211
  150. package/.claude/commands/maestro-player.md +182 -182
  151. package/.claude/commands/maestro-quick.md +83 -77
  152. package/.claude/commands/maestro-ralph-beta.md +875 -886
  153. package/.claude/commands/maestro-ralph-execute.md +247 -247
  154. package/.claude/commands/maestro-ralph.md +2 -36
  155. package/.claude/commands/maestro-roadmap.md +173 -186
  156. package/.claude/commands/maestro-swarm-workflow.md +243 -264
  157. package/.claude/commands/maestro-tools-execute.md +122 -117
  158. package/.claude/commands/maestro-tools-register.md +162 -157
  159. package/.claude/commands/maestro-ui-codify.md +117 -100
  160. package/.claude/commands/maestro-universal-workflow.md +548 -561
  161. package/.claude/commands/maestro-update.md +122 -119
  162. package/.claude/commands/maestro.md +2 -10
  163. package/.claude/commands/manage-codebase-rebuild.md +87 -85
  164. package/.claude/commands/manage-harvest.md +97 -95
  165. package/.claude/commands/manage-issue-discover.md +83 -81
  166. package/.claude/commands/manage-issue.md +72 -73
  167. package/.claude/commands/manage-kg-extractors.md +128 -0
  168. package/.claude/commands/manage-knowhow-capture.md +92 -82
  169. package/.claude/commands/manage-knowhow.md +83 -79
  170. package/.claude/commands/manage-knowledge-audit.md +105 -88
  171. package/.claude/commands/manage-status.md +62 -52
  172. package/.claude/commands/manage-wiki.md +82 -71
  173. package/.claude/commands/odyssey-debug.md +459 -473
  174. package/.claude/commands/odyssey-improve.md +491 -505
  175. package/.claude/commands/odyssey-planex.md +590 -601
  176. package/.claude/commands/odyssey-review-test-fix.md +414 -427
  177. package/.claude/commands/odyssey-ui.md +445 -462
  178. package/.claude/commands/quality-auto-test.md +153 -136
  179. package/.claude/commands/quality-debug.md +159 -120
  180. package/.claude/commands/quality-refactor.md +105 -67
  181. package/.claude/commands/quality-retrospective.md +123 -77
  182. package/.claude/commands/quality-review.md +155 -128
  183. package/.claude/commands/quality-sync.md +88 -52
  184. package/.claude/commands/quality-test.md +147 -117
  185. package/.claude/commands/security-audit.md +230 -179
  186. package/.claude/commands/spec-add.md +77 -70
  187. package/.claude/commands/spec-load.md +78 -78
  188. package/.claude/commands/spec-remove.md +55 -55
  189. package/.claude/commands/spec-setup.md +49 -52
  190. package/dist/src/cli.js +1 -1
  191. package/dist/src/cli.js.map +1 -1
  192. package/dist/src/commands/kg.d.ts.map +1 -1
  193. package/dist/src/commands/kg.js +11 -5
  194. package/dist/src/commands/kg.js.map +1 -1
  195. package/dist/src/graph/kg/extraction/code/code-extractor.d.ts +2 -0
  196. package/dist/src/graph/kg/extraction/code/code-extractor.d.ts.map +1 -1
  197. package/dist/src/graph/kg/extraction/code/code-extractor.js +32 -3
  198. package/dist/src/graph/kg/extraction/code/code-extractor.js.map +1 -1
  199. package/dist/src/graph/kg/extraction/code/plugin-engine.d.ts +35 -0
  200. package/dist/src/graph/kg/extraction/code/plugin-engine.d.ts.map +1 -0
  201. package/dist/src/graph/kg/extraction/code/plugin-engine.js +573 -0
  202. package/dist/src/graph/kg/extraction/code/plugin-engine.js.map +1 -0
  203. package/dist/src/graph/kg/extraction/code/plugin-types.d.ts +95 -0
  204. package/dist/src/graph/kg/extraction/code/plugin-types.d.ts.map +1 -0
  205. package/dist/src/graph/kg/extraction/code/plugin-types.js +5 -0
  206. package/dist/src/graph/kg/extraction/code/plugin-types.js.map +1 -0
  207. package/dist/src/graph/kg/extraction/orchestrator.d.ts.map +1 -1
  208. package/dist/src/graph/kg/extraction/orchestrator.js +17 -5
  209. package/dist/src/graph/kg/extraction/orchestrator.js.map +1 -1
  210. package/dist/src/graph/kg/schema.sql +16 -11
  211. package/dist/src/graph/kg/surface/cli.d.ts.map +1 -1
  212. package/dist/src/graph/kg/surface/cli.js +153 -56
  213. package/dist/src/graph/kg/surface/cli.js.map +1 -1
  214. package/dist/src/hooks/workspace.d.ts +4 -2
  215. package/dist/src/hooks/workspace.d.ts.map +1 -1
  216. package/dist/src/hooks/workspace.js +6 -2
  217. package/dist/src/hooks/workspace.js.map +1 -1
  218. package/package.json +91 -91
  219. package/workflows/analyze.md +25 -49
  220. package/workflows/auto-test.md +699 -699
  221. package/workflows/blueprint.md +403 -431
  222. package/workflows/brainstorm.md +54 -195
  223. package/workflows/business-test.md +570 -570
  224. package/workflows/claude-instructions.md +23 -51
  225. package/workflows/codex-instructions.md +27 -77
  226. package/workflows/coding-philosophy.md +69 -69
  227. package/workflows/command-authoring.md +823 -823
  228. package/workflows/debug.md +43 -98
  229. package/workflows/delegate-usage.md +39 -241
  230. package/workflows/execute.md +4 -53
  231. package/workflows/grill.md +12 -56
  232. package/workflows/harvest.md +22 -68
  233. package/workflows/init.md +148 -148
  234. package/workflows/instruction-authoring-guide.md +97 -0
  235. package/workflows/issue-execute.md +110 -110
  236. package/workflows/issue-gaps-analyze.codex.md +260 -260
  237. package/workflows/issue-gaps-analyze.md +216 -216
  238. package/workflows/issue-plan.md +110 -110
  239. package/workflows/issue.md +338 -346
  240. package/workflows/knowhow.md +0 -32
  241. package/workflows/learn.md +277 -277
  242. package/workflows/maestro-chain-execute.md +20 -20
  243. package/workflows/refactor.md +22 -44
  244. package/workflows/retrospective.md +16 -65
  245. package/workflows/review.md +446 -486
  246. package/workflows/roadmap.md +35 -132
  247. package/workflows/skill-authoring.md +265 -265
  248. package/workflows/spec-generate.md +470 -470
  249. package/workflows/specs-remove.md +104 -104
  250. package/workflows/sync.md +11 -41
  251. package/workflows/test-gen.md +226 -226
  252. package/workflows/test.md +385 -475
  253. package/workflows/ui-design.md +391 -391
  254. package/workflows/ui-style.md +199 -199
  255. package/workflows/wiki-connect.md +151 -151
  256. package/workflows/wiki-digest.md +178 -178
  257. package/workflows/wiki-manage.md +109 -109
  258. package/workflows/cli-tools-usage.md +0 -252
  259. package/workflows/delegate-protocol.codex.md +0 -65
@@ -13,63 +13,62 @@ allowed-tools:
13
13
  ---
14
14
  <!-- Open-standard mirror generated by scripts/build-agents-standard.mjs — do not edit; re-run after editing .claude/ source. -->
15
15
 
16
- <purpose>
17
- Issue lifecycle management for the project issue tracker. Supports create, list, status, update, close, and link (bidirectional issue-task cross-reference). All issues stored in `.workflow/issues/issues.jsonl` using the issue.json schema.
18
-
19
- For automated issue discovery, use `/manage-issue-discover`.
20
-
21
- **Closed-loop workflow**: After creating an issue, use `/maestro-analyze --gaps <ISS-ID>` for root cause analysis, `/maestro-plan --gaps` for solution planning, and `/maestro-execute` for execution.
22
- </purpose>
23
-
24
- <required_reading>
25
- @~/.maestro/workflows/issue.md
26
- </required_reading>
27
-
28
- <deferred_reading>
29
- - [issue.json template](~/.maestro/templates/issue.json) read when creating or updating issue records (create, update, close)
30
- </deferred_reading>
31
-
32
- <context>
33
- $ARGUMENTS -- subcommand + options. Parse first token as subcommand.
34
-
35
- **Valid subcommands:**
36
- - `create` -- create a new issue (--title, --severity, --source, --phase, --description)
37
- - `list` -- list issues with optional filters (--status, --phase, --severity, --source)
38
- - `status` -- show full detail for a specific issue (ISS-XXXXXXXX-NNN)
39
- - `update` -- update issue fields (ISS-XXXXXXXX-NNN --status, --priority, --severity, --tags, ...)
40
- - `close` -- close an issue with resolution (ISS-XXXXXXXX-NNN --resolution)
41
- - `link` -- link issue to a task (ISS-XXXXXXXX-NNN --task TASK-NNN)
42
-
43
- **State files:**
44
- - `.workflow/issues/issues.jsonl` -- active issues (one JSON per line)
45
- - `.workflow/issues/issue-history.jsonl` -- archived/closed issues
46
- </context>
47
-
48
- <execution>
49
- Parse subcommand from first token of $ARGUMENTS.
50
- Follow '~/.maestro/workflows/issue.md' completely.
51
-
52
- **Next-step routing on completion:**
53
- - create `/maestro-analyze --gaps <ISS-ID>` or `/maestro-plan --gaps`
54
- - list → `/maestro-analyze --gaps <ISS-ID>` for any open issue
55
- - close `/manage-status`
56
- </execution>
57
-
58
- <error_codes>
59
- | Code | Severity | Condition | Recovery |
60
- |------|----------|-----------|----------|
61
- | E_NO_SUBCOMMAND | error | No subcommand provided in $ARGUMENTS | Display valid subcommands, prompt user to select |
62
- | E_INVALID_SUBCOMMAND | error | Unrecognized subcommand | Display valid subcommands with usage hints |
63
- | E_ISSUES_DIR_MISSING | warning | `.workflow/issues/` directory does not exist | Auto-create directory and empty issues.jsonl |
64
- </error_codes>
65
-
66
- <success_criteria>
67
- - [ ] Subcommand parsed and routed to correct handler
68
- - [ ] Issue data read/written to correct JSONL file
69
- - [ ] Output displayed in appropriate format (table for list, detail for status)
70
- - [ ] Cross-references maintained (link creates bidirectional references)
71
- - [ ] Next step routing by subcommand:
72
- - create `/maestro-analyze --gaps <ISS-ID>` or `/maestro-plan --gaps`
73
- - list `/maestro-analyze --gaps <ISS-ID>` for any open issue
74
- - close → `/manage-status`
75
- </success_criteria>
16
+ <purpose>
17
+ Issue lifecycle management: create, list, status, update, close, link. Stored in `.workflow/issues/issues.jsonl`. For automated discovery, use `/manage-issue-discover`.
18
+ </purpose>
19
+
20
+ <required_reading>
21
+ @~/.maestro/workflows/issue.md
22
+ </required_reading>
23
+
24
+ <deferred_reading>
25
+ - [issue.json template](~/.maestro/templates/issue.json) — read when creating or updating issue records (create, update, close)
26
+ </deferred_reading>
27
+
28
+ <context>
29
+ $ARGUMENTS -- subcommand + options. Parse first token as subcommand.
30
+
31
+ **Valid subcommands:**
32
+ - `create` -- create a new issue (--title, --severity, --source, --phase, --description)
33
+ - `list` -- list issues with optional filters (--status, --phase, --severity, --source)
34
+ - `status` -- show full detail for a specific issue (ISS-XXXXXXXX-NNN)
35
+ - `update` -- update issue fields (ISS-XXXXXXXX-NNN --status, --priority, --severity, --tags, ...)
36
+ - `close` -- close an issue with resolution (ISS-XXXXXXXX-NNN --resolution)
37
+ - `link` -- link issue to a task (ISS-XXXXXXXX-NNN --task TASK-NNN)
38
+
39
+ **State files:**
40
+ - `.workflow/issues/issues.jsonl` -- active issues (one JSON per line)
41
+ - `.workflow/issues/issue-history.jsonl` -- archived/closed issues
42
+ </context>
43
+
44
+ <execution>
45
+ Parse subcommand from first token of $ARGUMENTS.
46
+ Follow '~/.maestro/workflows/issue.md' completely.
47
+
48
+ </execution>
49
+
50
+ <completion>
51
+ ### Next-step routing
52
+
53
+ | Subcommand | Suggestion |
54
+ |-----------|-----------|
55
+ | create | `/maestro-analyze --gaps <ISS-ID>` or `/maestro-plan --gaps` |
56
+ | list | `/maestro-analyze --gaps <ISS-ID>` for open issues |
57
+ | close | `/manage-status` |
58
+ </completion>
59
+
60
+ <error_codes>
61
+ | Code | Severity | Condition | Recovery |
62
+ |------|----------|-----------|----------|
63
+ | E_NO_SUBCOMMAND | error | No subcommand provided in $ARGUMENTS | Display valid subcommands, prompt user to select |
64
+ | E_INVALID_SUBCOMMAND | error | Unrecognized subcommand | Display valid subcommands with usage hints |
65
+ | E_ISSUES_DIR_MISSING | warning | `.workflow/issues/` directory does not exist | Auto-create directory and empty issues.jsonl |
66
+ </error_codes>
67
+
68
+ <success_criteria>
69
+ - [ ] Subcommand parsed and routed to correct handler
70
+ - [ ] Issue data read/written to correct JSONL file
71
+ - [ ] Output displayed in appropriate format (table for list, detail for status)
72
+ - [ ] Cross-references maintained (link creates bidirectional references)
73
+ - [ ] Next step routed by subcommand
74
+ </success_criteria>
@@ -13,71 +13,73 @@ allowed-tools:
13
13
  ---
14
14
  <!-- Open-standard mirror generated by scripts/build-agents-standard.mjs — do not edit; re-run after editing .claude/ source. -->
15
15
 
16
- <purpose>
17
- Automated issue discovery via multi-perspective codebase analysis (8 perspectives) or prompt-driven exploration. Discovers issues, deduplicates findings, and records them in `.workflow/issues/issues.jsonl`.
18
-
19
- - **Default (no args)**: Interactive mode selection — choose multi-perspective or prompt-driven.
20
- - **`multi-perspective`**: 8-perspective parallel agent scan — security, performance, reliability, maintainability, scalability, UX, accessibility, compliance.
21
- - **`by-prompt "..."`**: Prompt-driven — CLI delegate plans exploration strategy, agents explore iteratively with cross-dimension analysis.
22
-
23
- For CRUD operations (create, list, update, close, link), use `/manage-issue`.
24
-
25
- After discovery, use `/maestro-analyze --gaps <ISS-ID>` to perform root cause analysis on individual findings.
26
- </purpose>
27
-
28
- <required_reading>
29
- @~/.maestro/workflows/issue-discover.md
30
- </required_reading>
31
-
32
- <deferred_reading>
33
- - [issue.json template](~/.maestro/templates/issue.json) read when creating issue records from findings (Step 6/11)
34
- - [search-tools](~/.maestro/templates/search-tools.md) search tool priority, passed to agents via workflow
35
- </deferred_reading>
36
-
37
- <context>
38
- $ARGUMENTS -- optional. Parse first token to determine mode.
39
-
40
- **Modes:**
41
- - _(empty)_ -- interactive mode selection (ask_user)
42
- - `multi-perspective` -- 8-perspective parallel agent scan
43
- - `by-prompt "..."` -- prompt-driven iterative agent exploration (CLI-planned)
44
-
45
- **Flags:**
46
- - `-y` / `--yes` -- auto mode, skip confirmations
47
- - `--scope=<pattern>` -- file scope (default: `**/*`)
48
- - `--depth=standard|deep` -- exploration depth (by-prompt only, default: `standard`)
49
-
50
- **State files:**
51
- - `.workflow/issues/issues.jsonl` -- issues appended here (set `source: "discover"` on each row so concurrent writers like `manage-harvest` with `source: "harvest"` can be distinguished and deduplicated)
52
- - `.workflow/issues/discoveries/{SESSION_ID}/` -- session artifacts
53
-
54
- ### Pre-load specs
55
- 1. **Debug specs**: Run `maestro spec load --category debug` to load known antipatterns, root causes, and gotchas. Informs discovery perspectives with prior findings.
56
- 2. Optional — proceed without if unavailable.
57
- </context>
58
-
59
- <execution>
60
- Determine mode from $ARGUMENTS:
61
- - No arguments or empty interactive selection via ask_user
62
- - First token is `multi-perspective` → multi-perspective mode
63
- - First token is `by-prompt` prompt-driven mode, remaining tokens are the user prompt
64
-
65
- Follow '~/.maestro/workflows/issue-discover.md' completely.
66
- </execution>
67
-
68
- <error_codes>
69
- | Code | Severity | Condition | Recovery |
70
- |------|----------|-----------|----------|
71
- | E_NO_PROJECT | error | `.workflow/` does not exist | Prompt user to run `/maestro-init` first |
72
- | E_DISCOVERY_FAILED | error | CLI analysis returned no results | Retry with different tool or report partial findings |
73
- | E_EMPTY_PROMPT | warning | `by-prompt` used without prompt text | Interactive prompt with suggested options |
74
- </error_codes>
75
-
76
- <success_criteria>
77
- - [ ] Discovery mode correctly determined from arguments
78
- - [ ] All perspectives analyzed (multi-perspective) or dimensions explored (by-prompt)
79
- - [ ] Findings deduplicated before issue creation
80
- - [ ] Issues appended to issues.jsonl with correct schema
81
- - [ ] Discovery session fully traceable via session directory
82
- - [ ] Next step routing: `/maestro-analyze --gaps <ISS-ID>` for root cause analysis, or `/manage-issue list` to review all issues
83
- </success_criteria>
16
+ <purpose>
17
+ Automated issue discovery: multi-perspective (8 perspectives) or prompt-driven. Deduplicates and records to `issues.jsonl`. For CRUD operations, use `/manage-issue`.
18
+ </purpose>
19
+
20
+ <required_reading>
21
+ @~/.maestro/workflows/issue-discover.md
22
+ </required_reading>
23
+
24
+ <deferred_reading>
25
+ - [issue.json template](~/.maestro/templates/issue.json) read when creating issue records from findings (Step 6/11)
26
+ - [search-tools](~/.maestro/templates/search-tools.md) — search tool priority, passed to agents via workflow
27
+ </deferred_reading>
28
+
29
+ <context>
30
+ $ARGUMENTS -- optional. Parse first token to determine mode.
31
+
32
+ **Modes:**
33
+ - _(empty)_ -- interactive mode selection (ask_user)
34
+ - `multi-perspective` -- 8-perspective parallel agent scan
35
+ - `by-prompt "..."` -- prompt-driven iterative agent exploration (CLI-planned)
36
+
37
+ **Flags:**
38
+ - `-y` / `--yes` -- auto mode, skip confirmations
39
+ - `--scope=<pattern>` -- file scope (default: `**/*`)
40
+ - `--depth=standard|deep` -- exploration depth (by-prompt only, default: `standard`)
41
+
42
+ **State files:**
43
+ - `.workflow/issues/issues.jsonl` -- issues appended here (set `source: "discover"` on each row so concurrent writers like `manage-harvest` with `source: "harvest"` can be distinguished and deduplicated)
44
+ - `.workflow/issues/discoveries/{SESSION_ID}/` -- session artifacts
45
+
46
+ ### Pre-load specs
47
+ 1. **Debug specs**: Run `maestro spec load --category debug` to load known antipatterns, root causes, and gotchas. Informs discovery perspectives with prior findings.
48
+ 2. Optional proceed without if unavailable.
49
+ </context>
50
+
51
+ <execution>
52
+ Determine mode from $ARGUMENTS:
53
+ - No arguments or empty → interactive selection via ask_user
54
+ - First token is `multi-perspective` → multi-perspective mode
55
+ - First token is `by-prompt` prompt-driven mode, remaining tokens are the user prompt
56
+
57
+ Follow '~/.maestro/workflows/issue-discover.md' completely.
58
+ </execution>
59
+
60
+ <error_codes>
61
+ | Code | Severity | Condition | Recovery |
62
+ |------|----------|-----------|----------|
63
+ | E_NO_PROJECT | error | `.workflow/` does not exist | Prompt user to run `/maestro-init` first |
64
+ | E_DISCOVERY_FAILED | error | CLI analysis returned no results | Retry with different tool or report partial findings |
65
+ | E_EMPTY_PROMPT | warning | `by-prompt` used without prompt text | Interactive prompt with suggested options |
66
+ </error_codes>
67
+
68
+ <success_criteria>
69
+ - [ ] Discovery mode correctly determined from arguments
70
+ - [ ] All perspectives analyzed (multi-perspective) or dimensions explored (by-prompt)
71
+ - [ ] Findings deduplicated before issue creation
72
+ - [ ] Issues appended to issues.jsonl with correct schema
73
+ - [ ] Discovery session fully traceable via session directory
74
+ - [ ] Next step routed
75
+ </success_criteria>
76
+
77
+ <completion>
78
+ ### Next-step routing
79
+
80
+ | Condition | Suggestion |
81
+ |-----------|-----------|
82
+ | Issues discovered | `/manage-issue list` to review |
83
+ | Need root cause analysis | `/maestro-analyze --gaps <ISS-ID>` |
84
+ | Want to plan fixes | `/maestro-plan --gaps` |
85
+ </completion>
@@ -0,0 +1,130 @@
1
+ ---
2
+ name: manage-kg-extractors
3
+ description: Analyze codebase patterns and generate .workflow/kg/extractors.yaml for custom symbol extraction
4
+ argument-hint: "[--scan-only] [--append] [--language <lang>]"
5
+ allowed-tools:
6
+ - read_file
7
+ - write_file
8
+ - edit_file
9
+ - shell
10
+ - find_files
11
+ - search
12
+ - delegate_subagent
13
+ - ask_user
14
+ ---
15
+ <!-- Open-standard mirror generated by scripts/build-agents-standard.mjs — do not edit; re-run after editing .claude/ source. -->
16
+
17
+
18
+ <purpose>
19
+ Analyze current repository's code patterns to auto-generate `.workflow/kg/extractors.yaml` — a declarative config that teaches MaestroGraph's codegraph extractor to recognize project-specific symbols beyond standard function/class/method declarations.
20
+
21
+ Detects: builder/factory API registrations, domain constant patterns, custom decorator conventions, framework-specific patterns, module-level constants.
22
+ </purpose>
23
+
24
+ <context>
25
+ $ARGUMENTS -- optional flags.
26
+
27
+ **Flags:**
28
+ - `--scan-only` — Only report detected patterns, don't write extractors.yaml
29
+ - `--append` — Append new rules to existing extractors.yaml (default: overwrite)
30
+ - `--language <lang>` — Limit analysis to specific language (python, typescript, java, etc.)
31
+
32
+ **Analysis targets (per language):**
33
+
34
+ | Language | Pattern Types |
35
+ |----------|--------------|
36
+ | Python | `define_*()` builder APIs, ALL_CAPS constants, `Final[...]` annotations, dataclass/pydantic fields |
37
+ | TypeScript | const enum, namespace exports, decorator factories, config objects |
38
+ | Java | static final constants, @Bean/@Component annotations, builder patterns |
39
+ | Go | exported constants (const blocks), interface registrations |
40
+ | All | Custom factory/builder call patterns with string-literal first args |
41
+
42
+ **Output:** `.workflow/kg/extractors.yaml` — declarative rules for PluginEngine.
43
+
44
+ **Rule format:**
45
+ ```yaml
46
+ version: 1
47
+ defaults:
48
+ onError: warn
49
+ conflictPolicy: merge-metadata
50
+ plugins:
51
+ - id: <project>.<pattern>
52
+ languages: [<lang>]
53
+ mode: declarative
54
+ declarative:
55
+ rules:
56
+ - id: <rule-id>
57
+ match:
58
+ type: call | assignment | regex
59
+ pattern: "<pattern>"
60
+ nameRegex: "<optional filter>"
61
+ scope: module | class | any
62
+ extract:
63
+ kind: constant | variable | property | field
64
+ decorators: ["<semantic_tag>"]
65
+ metadata:
66
+ semanticKind: "<domain_kind>"
67
+ ```
68
+ </context>
69
+
70
+ <execution>
71
+
72
+ ### Phase 1: Discover patterns
73
+
74
+ Spawn **3 parallel agents** to scan the codebase:
75
+
76
+ | Agent | Focus | Method |
77
+ |-------|-------|--------|
78
+ | Agent 1 | **Builder/factory calls** | Grep for patterns like `define_*("`, `register_*("`, `add_*("` where first arg is a string literal |
79
+ | Agent 2 | **Constants & annotations** | Grep for ALL_CAPS assignments, Final[], static final, const enum, exported const |
80
+ | Agent 3 | **Framework patterns** | Detect framework (from package.json/setup.py/go.mod) → grep framework-specific registration patterns |
81
+
82
+ Each agent returns: `[{pattern_type, regex_evidence, file_count, sample_matches: [{file, line, code}]}]`
83
+
84
+ ### Phase 2: Generate rules
85
+
86
+ For each discovered pattern with ≥3 occurrences:
87
+ 1. Determine match type (call/assignment/regex)
88
+ 2. Build pattern string and optional nameRegex
89
+ 3. Assign appropriate kind and semanticKind
90
+ 4. Generate rule entry
91
+
92
+ ### Phase 3: Validate & write
93
+
94
+ 1. Show discovered patterns summary to user
95
+ 2. ask_user: confirm/edit/skip each pattern group
96
+ 3. Write `.workflow/kg/extractors.yaml`
97
+ 4. Run `maestro kg index` to verify new symbols are extracted
98
+
99
+ If `--scan-only`: stop after Phase 2 summary.
100
+
101
+ </execution>
102
+
103
+ <completion>
104
+ ### Next-step routing
105
+
106
+ | Condition | Suggestion |
107
+ |-----------|-----------|
108
+ | Verify new symbols | `maestro kg search "<pattern_name>"` |
109
+ | Re-index after changes | `maestro kg index` |
110
+ | View KG stats | `maestro kg stats` |
111
+ | Edit rules manually | Edit `.workflow/kg/extractors.yaml` |
112
+ | Add script plugin | Create `.workflow/kg/extractors/<name>.mjs` |
113
+ </completion>
114
+
115
+ <error_codes>
116
+ | Code | Severity | Condition | Recovery |
117
+ |------|----------|-----------|----------|
118
+ | E001 | error | .workflow/ not initialized | Run maestro-init first |
119
+ | W001 | warning | No patterns detected for language | Try broader scan or different language |
120
+ | W002 | warning | Pattern has < 3 occurrences | Skipped by default, include with --min-count 1 |
121
+ | W003 | warning | Existing extractors.yaml will be overwritten | Use --append to preserve |
122
+ </error_codes>
123
+
124
+ <success_criteria>
125
+ - [ ] At least 1 pattern detected in the codebase
126
+ - [ ] extractors.yaml generated with valid rules
127
+ - [ ] Each rule has match.type, match.pattern, extract.kind
128
+ - [ ] Re-index succeeds with new extractors.yaml active
129
+ - [ ] New symbols searchable via `maestro kg search`
130
+ </success_criteria>
@@ -13,69 +13,73 @@ allowed-tools:
13
13
  ---
14
14
  <!-- Open-standard mirror generated by scripts/build-agents-standard.mjs — do not edit; re-run after editing .claude/ source. -->
15
15
 
16
- <purpose>
17
- Unified memory management across two stores:
18
- 1. **Workflow knowhow** (`.workflow/knowhow/`) — Session compacts, tips, insights, and all reusable knowledge, created by `manage-knowhow-capture`
19
- 2. **System memory** (`~/.claude/projects/{project}/memory/`) — Claude Code auto-memory (MEMORY.md + topic files), persists across conversations
20
-
21
- Also scans `.workflow/specs/learnings.md` for legacy insight entries (backward compat with former `manage-learn`).
22
-
23
- Provides list/search/view/edit/delete/prune operations. Default store is `all` (show both).
24
- </purpose>
25
-
26
- <required_reading>
27
- @~/.maestro/workflows/knowhow.md
28
- </required_reading>
29
-
30
- <context>
31
- Arguments: $ARGUMENTS
32
-
33
- Dual store architecture (paths, formats, index) defined in workflow knowhow.md.
34
-
35
- **Subcommands:**
36
- - `list` — List entries from both stores (default if no arguments)
37
- - `search <query>` — Full-text search across both stores
38
- - `view <id|file>` — Display a workflow entry by ID or system file by name
39
- - `edit <file>` — Edit a system memory file (MEMORY.md or topic file)
40
- - `delete <id|file>` — Remove an entry/file (with confirmation)
41
- - `prune`Bulk cleanup by criteria
42
-
43
- **Flags:**
44
- - `--store <workflow|system|all>` Target store (default: `all` for list/search, inferred for other ops)
45
- - `--tag <tag>` — Filter by tag (workflow store)
46
- - `--type <compact|tip>` — Filter by entry type (workflow store)
47
- - `--before <YYYY-MM-DD>` — Entries before date
48
- - `--after <YYYY-MM-DD>` Entries after date
49
- - `--dry-run` — Preview destructive ops without executing
50
- - `--confirm` — Skip confirmation prompt
51
- </context>
52
-
53
- <execution>
54
- Follow '~/.maestro/workflows/knowhow.md' Part A (KnowHow Management) completely.
55
- </execution>
56
-
57
- <error_codes>
58
- | Code | Severity | Description | Stage |
59
- |------|----------|-------------|-------|
60
- | E001 | error | No memory stores foundfor workflow store run `/manage-knowhow-capture`; for system store create `~/.claude/projects/{project}/memory/MEMORY.md` manually | resolve_paths |
61
- | E002 | error | Entry ID or filename not found | execute_view, execute_delete |
62
- | E003 | error | Prune requires at least one filter (--tag, --type, --before, --after) | execute_prune |
63
- | E004 | error | Cannot delete MEMORY.md — use `edit` subcommand instead | execute_delete |
64
- | W001 | warning | Workflow index has orphaned files or dangling references | integrity_check |
65
- | W002 | warning | MEMORY.md references non-existent topic file | integrity_check |
66
- | W003 | warning | MEMORY.md exceeds 200 lines content will be truncated at load | execute_edit |
67
- </error_codes>
68
-
69
- <success_criteria>
70
- - [ ] Both store paths correctly resolved
71
- - [ ] Subcommand correctly detected from arguments
72
- - [ ] Store auto-detected from argument format (KNW-*/TIP-* vs filename)
73
- - [ ] List: both stores displayed with appropriate formatting
74
- - [ ] Search: results from both stores, ranked by relevance
75
- - [ ] View: correct store selected, full content displayed
76
- - [ ] Edit: system memory files editable, MEMORY.md kept under 200 lines
77
- - [ ] Delete: MEMORY.md protected, confirmation required, references checked
78
- - [ ] Prune: workflow-only, filters validated, index updated
79
- - [ ] Integrity check catches orphans and broken links
80
- - [ ] Next step: `/manage-knowhow-capture compact` to save new knowhow, or `/manage-status` to continue workflow
81
- </success_criteria>
16
+ <purpose>
17
+ Manage knowhow across two stores: workflow (`.workflow/knowhow/`) and system memory (`~/.claude/projects/*/memory/`). Operations: list, search, view, edit, delete, prune.
18
+ </purpose>
19
+
20
+ <required_reading>
21
+ @~/.maestro/workflows/knowhow.md
22
+ </required_reading>
23
+
24
+ <context>
25
+ Arguments: $ARGUMENTS
26
+
27
+ Dual store architecture (paths, formats, index) defined in workflow knowhow.md.
28
+
29
+ **Subcommands:**
30
+ - `list` — List entries from both stores (default if no arguments)
31
+ - `search <query>` — Full-text search across both stores
32
+ - `view <id|file>` — Display a workflow entry by ID or system file by name
33
+ - `edit <file>` Edit a system memory file (MEMORY.md or topic file)
34
+ - `delete <id|file>` — Remove an entry/file (with confirmation)
35
+ - `prune` — Bulk cleanup by criteria
36
+
37
+ **Flags:**
38
+ - `--store <workflow|system|all>` — Target store (default: `all` for list/search, inferred for other ops)
39
+ - `--tag <tag>` — Filter by tag (workflow store)
40
+ - `--type <compact|tip>` — Filter by entry type (workflow store)
41
+ - `--before <YYYY-MM-DD>` Entries before date
42
+ - `--after <YYYY-MM-DD>` — Entries after date
43
+ - `--dry-run` — Preview destructive ops without executing
44
+ - `--confirm`Skip confirmation prompt
45
+ </context>
46
+
47
+ <execution>
48
+ Follow '~/.maestro/workflows/knowhow.md' Part A (KnowHow Management) completely.
49
+ </execution>
50
+
51
+ <error_codes>
52
+ | Code | Severity | Description | Stage |
53
+ |------|----------|-------------|-------|
54
+ | E001 | error | No memory stores found — for workflow store run `/manage-knowhow-capture`; for system store create `~/.claude/projects/{project}/memory/MEMORY.md` manually | resolve_paths |
55
+ | E002 | error | Entry ID or filename not found | execute_view, execute_delete |
56
+ | E003 | error | Prune requires at least one filter (--tag, --type, --before, --after) | execute_prune |
57
+ | E004 | error | Cannot delete MEMORY.md — use `edit` subcommand instead | execute_delete |
58
+ | W001 | warning | Workflow index has orphaned files or dangling references | integrity_check |
59
+ | W002 | warning | MEMORY.md references non-existent topic file | integrity_check |
60
+ | W003 | warning | MEMORY.md exceeds 200 linescontent will be truncated at load | execute_edit |
61
+ </error_codes>
62
+
63
+ <success_criteria>
64
+ - [ ] Both store paths correctly resolved
65
+ - [ ] Subcommand correctly detected from arguments
66
+ - [ ] Store auto-detected from argument format (KNW-*/TIP-* vs filename)
67
+ - [ ] List: both stores displayed with appropriate formatting
68
+ - [ ] Search: results from both stores, ranked by relevance
69
+ - [ ] View: correct store selected, full content displayed
70
+ - [ ] Edit: system memory files editable, MEMORY.md kept under 200 lines
71
+ - [ ] Delete: MEMORY.md protected, confirmation required, references checked
72
+ - [ ] Prune: workflow-only, filters validated, index updated
73
+ - [ ] Integrity check catches orphans and broken links
74
+ - [ ] Next step routed
75
+ </success_criteria>
76
+
77
+ <completion>
78
+ ### Next-step routing
79
+
80
+ | Condition | Suggestion |
81
+ |-----------|-----------|
82
+ | Want to capture new knowhow | `/manage-knowhow-capture` |
83
+ | View project state | `/manage-status` |
84
+ | Prune stale entries | `/manage-knowledge-audit --scope knowhow` |
85
+ </completion>