maestro-flow 0.3.37 → 0.3.39

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 (186) hide show
  1. package/.claude/agents/workflow-analyzer.md +2 -0
  2. package/.claude/agents/workflow-debugger.md +2 -0
  3. package/.claude/agents/workflow-executor.md +2 -0
  4. package/.claude/agents/workflow-integration-checker.md +1 -0
  5. package/.claude/agents/workflow-nyquist-auditor.md +1 -0
  6. package/.claude/agents/workflow-planner.md +2 -0
  7. package/.claude/agents/workflow-reviewer.md +2 -0
  8. package/.claude/agents/workflow-verifier.md +2 -0
  9. package/.claude/commands/learn-decompose.md +176 -176
  10. package/.claude/commands/learn-follow.md +167 -167
  11. package/.claude/commands/learn-investigate.md +221 -221
  12. package/.claude/commands/learn-retro.md +303 -303
  13. package/.claude/commands/learn-second-opinion.md +167 -167
  14. package/.claude/commands/maestro-amend.md +300 -300
  15. package/.claude/commands/maestro-analyze.md +126 -126
  16. package/.claude/commands/maestro-brainstorm.md +100 -100
  17. package/.claude/commands/maestro-composer.md +354 -354
  18. package/.claude/commands/maestro-execute.md +120 -114
  19. package/.claude/commands/maestro-fork.md +86 -86
  20. package/.claude/commands/maestro-init.md +78 -78
  21. package/.claude/commands/maestro-learn.md +140 -140
  22. package/.claude/commands/maestro-link-coordinate.md +1 -1
  23. package/.claude/commands/maestro-merge.md +61 -61
  24. package/.claude/commands/maestro-milestone-release.md +96 -96
  25. package/.claude/commands/maestro-overlay.md +178 -178
  26. package/.claude/commands/maestro-plan.md +150 -138
  27. package/.claude/commands/maestro-player.md +404 -404
  28. package/.claude/commands/maestro-quick.md +56 -56
  29. package/.claude/commands/maestro-ralph-execute.md +7 -18
  30. package/.claude/commands/maestro-ralph.md +9 -3
  31. package/.claude/commands/maestro-roadmap.md +1 -1
  32. package/.claude/commands/maestro-ui-design.md +93 -93
  33. package/.claude/commands/maestro-update.md +176 -176
  34. package/.claude/commands/maestro-verify.md +96 -90
  35. package/.claude/commands/maestro.md +121 -121
  36. package/.claude/commands/manage-codebase-rebuild.md +75 -75
  37. package/.claude/commands/manage-codebase-refresh.md +57 -57
  38. package/.claude/commands/manage-harvest.md +94 -94
  39. package/.claude/commands/manage-issue-discover.md +77 -77
  40. package/.claude/commands/manage-issue.md +73 -73
  41. package/.claude/commands/manage-knowhow-capture.md +193 -193
  42. package/.claude/commands/manage-knowhow.md +77 -77
  43. package/.claude/commands/manage-learn.md +67 -67
  44. package/.claude/commands/manage-status.md +51 -51
  45. package/.claude/commands/manage-wiki.md +62 -62
  46. package/.claude/commands/quality-auto-test.md +1 -1
  47. package/.claude/commands/quality-debug.md +121 -115
  48. package/.claude/commands/quality-refactor.md +55 -55
  49. package/.claude/commands/quality-retrospective.md +78 -78
  50. package/.claude/commands/quality-review.md +114 -108
  51. package/.claude/commands/quality-sync.md +51 -51
  52. package/.claude/commands/quality-test.md +103 -103
  53. package/.claude/commands/spec-add.md +49 -49
  54. package/.claude/commands/spec-load.md +51 -51
  55. package/.claude/commands/spec-remove.md +51 -51
  56. package/.claude/commands/spec-setup.md +51 -51
  57. package/.claude/commands/wiki-connect.md +62 -62
  58. package/.claude/commands/wiki-digest.md +69 -69
  59. package/.codex/skills/learn-decompose/SKILL.md +113 -113
  60. package/.codex/skills/learn-follow/SKILL.md +1 -1
  61. package/.codex/skills/learn-investigate/SKILL.md +83 -83
  62. package/.codex/skills/learn-retro/SKILL.md +83 -83
  63. package/.codex/skills/learn-second-opinion/SKILL.md +86 -86
  64. package/.codex/skills/maestro/SKILL.md +304 -304
  65. package/.codex/skills/maestro-analyze/SKILL.md +9 -8
  66. package/.codex/skills/maestro-brainstorm/SKILL.md +442 -397
  67. package/.codex/skills/maestro-composer/SKILL.md +213 -213
  68. package/.codex/skills/maestro-execute/SKILL.md +346 -318
  69. package/.codex/skills/maestro-fork/SKILL.md +56 -2
  70. package/.codex/skills/maestro-init/SKILL.md +40 -16
  71. package/.codex/skills/maestro-learn/SKILL.md +80 -80
  72. package/.codex/skills/maestro-link-coordinate/SKILL.md +257 -257
  73. package/.codex/skills/maestro-merge/SKILL.md +1 -1
  74. package/.codex/skills/maestro-milestone-audit/SKILL.md +1 -1
  75. package/.codex/skills/maestro-milestone-complete/SKILL.md +40 -9
  76. package/.codex/skills/maestro-milestone-release/SKILL.md +70 -70
  77. package/.codex/skills/maestro-overlay/SKILL.md +1 -1
  78. package/.codex/skills/maestro-plan/SKILL.md +19 -4
  79. package/.codex/skills/maestro-player/SKILL.md +323 -323
  80. package/.codex/skills/maestro-quick/SKILL.md +1 -1
  81. package/.codex/skills/maestro-ralph/SKILL.md +681 -578
  82. package/.codex/skills/maestro-roadmap/SKILL.md +518 -468
  83. package/.codex/skills/maestro-ui-design/SKILL.md +109 -12
  84. package/.codex/skills/maestro-verify/SKILL.md +27 -9
  85. package/.codex/skills/manage-codebase-rebuild/SKILL.md +3 -2
  86. package/.codex/skills/manage-codebase-refresh/SKILL.md +1 -1
  87. package/.codex/skills/manage-harvest/SKILL.md +91 -91
  88. package/.codex/skills/manage-issue/SKILL.md +19 -6
  89. package/.codex/skills/manage-issue-discover/SKILL.md +1 -1
  90. package/.codex/skills/manage-knowhow/SKILL.md +95 -95
  91. package/.codex/skills/manage-knowhow-capture/SKILL.md +110 -110
  92. package/.codex/skills/manage-learn/SKILL.md +1 -1
  93. package/.codex/skills/manage-status/SKILL.md +1 -1
  94. package/.codex/skills/manage-wiki/SKILL.md +55 -55
  95. package/.codex/skills/quality-auto-test/SKILL.md +547 -547
  96. package/.codex/skills/quality-debug/SKILL.md +339 -334
  97. package/.codex/skills/quality-refactor/SKILL.md +1 -1
  98. package/.codex/skills/quality-retrospective/SKILL.md +292 -292
  99. package/.codex/skills/quality-review/SKILL.md +365 -364
  100. package/.codex/skills/quality-sync/SKILL.md +1 -1
  101. package/.codex/skills/quality-test/SKILL.md +498 -498
  102. package/.codex/skills/spec-add/SKILL.md +101 -101
  103. package/.codex/skills/spec-load/SKILL.md +77 -77
  104. package/.codex/skills/spec-map/SKILL.md +1 -1
  105. package/.codex/skills/spec-remove/SKILL.md +69 -69
  106. package/.codex/skills/spec-setup/SKILL.md +1 -1
  107. package/.codex/skills/team-coordinate/SKILL.md +2 -1
  108. package/.codex/skills/team-executor/SKILL.md +116 -115
  109. package/.codex/skills/team-lifecycle-v4/SKILL.md +2 -1
  110. package/.codex/skills/team-lifecycle-v4/instructions/agent-instruction.md +14 -6
  111. package/.codex/skills/team-lifecycle-v4/roles/analyst/role.md +16 -4
  112. package/.codex/skills/team-lifecycle-v4/roles/executor/commands/implement.md +7 -1
  113. package/.codex/skills/team-lifecycle-v4/roles/planner/role.md +16 -4
  114. package/.codex/skills/team-lifecycle-v4/roles/writer/role.md +8 -2
  115. package/.codex/skills/team-quality-assurance/SKILL.md +2 -1
  116. package/.codex/skills/team-quality-assurance/roles/scout/role.md +9 -2
  117. package/.codex/skills/team-review/SKILL.md +2 -1
  118. package/.codex/skills/team-review/roles/reviewer/role.md +10 -1
  119. package/.codex/skills/team-review/roles/scanner/role.md +10 -1
  120. package/.codex/skills/team-tech-debt/SKILL.md +144 -143
  121. package/.codex/skills/team-tech-debt/roles/executor/role.md +9 -5
  122. package/.codex/skills/team-tech-debt/roles/scanner/role.md +10 -0
  123. package/.codex/skills/team-tech-debt/roles/validator/role.md +8 -2
  124. package/.codex/skills/team-testing/SKILL.md +2 -1
  125. package/.codex/skills/team-testing/roles/executor/role.md +8 -2
  126. package/.codex/skills/team-testing/roles/generator/role.md +8 -2
  127. package/.codex/skills/wiki-connect/SKILL.md +73 -73
  128. package/.codex/skills/wiki-digest/SKILL.md +87 -87
  129. package/README.md +6 -0
  130. package/README.zh-CN.md +6 -0
  131. package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.js +4 -0
  132. package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.js.map +1 -1
  133. package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js +118 -7
  134. package/dashboard/dist-server/dashboard/src/server/agents/codex-cli-adapter.js.map +1 -1
  135. package/dashboard/dist-server/shared/agent-types.d.ts +2 -0
  136. package/dashboard/dist-server/src/agents/cli-agent-runner.d.ts +2 -0
  137. package/dashboard/dist-server/src/agents/cli-agent-runner.js +4 -0
  138. package/dashboard/dist-server/src/agents/cli-agent-runner.js.map +1 -1
  139. package/dashboard/dist-server/src/commands/delegate.d.ts +2 -0
  140. package/dashboard/dist-server/src/commands/delegate.js +18 -0
  141. package/dashboard/dist-server/src/commands/delegate.js.map +1 -1
  142. package/dashboard/dist-server/src/config/cli-tools-config.d.ts +6 -0
  143. package/dashboard/dist-server/src/config/cli-tools-config.js +2 -0
  144. package/dashboard/dist-server/src/config/cli-tools-config.js.map +1 -1
  145. package/dist/shared/agent-types.d.ts +2 -0
  146. package/dist/shared/agent-types.d.ts.map +1 -1
  147. package/dist/src/agents/cli-agent-runner.d.ts +2 -0
  148. package/dist/src/agents/cli-agent-runner.d.ts.map +1 -1
  149. package/dist/src/agents/cli-agent-runner.js +4 -0
  150. package/dist/src/agents/cli-agent-runner.js.map +1 -1
  151. package/dist/src/commands/config.d.ts.map +1 -1
  152. package/dist/src/commands/config.js +29 -1
  153. package/dist/src/commands/config.js.map +1 -1
  154. package/dist/src/commands/delegate.d.ts +2 -0
  155. package/dist/src/commands/delegate.d.ts.map +1 -1
  156. package/dist/src/commands/delegate.js +18 -0
  157. package/dist/src/commands/delegate.js.map +1 -1
  158. package/dist/src/commands/launcher.d.ts.map +1 -1
  159. package/dist/src/commands/launcher.js +27 -4
  160. package/dist/src/commands/launcher.js.map +1 -1
  161. package/dist/src/config/cli-tools-config.d.ts +6 -0
  162. package/dist/src/config/cli-tools-config.d.ts.map +1 -1
  163. package/dist/src/config/cli-tools-config.js +2 -0
  164. package/dist/src/config/cli-tools-config.js.map +1 -1
  165. package/dist/src/core/overlay/applier.d.ts.map +1 -1
  166. package/dist/src/core/overlay/applier.js +65 -5
  167. package/dist/src/core/overlay/applier.js.map +1 -1
  168. package/dist/src/core/overlay/loader.d.ts.map +1 -1
  169. package/dist/src/core/overlay/loader.js +9 -4
  170. package/dist/src/core/overlay/loader.js.map +1 -1
  171. package/dist/src/core/overlay/types.d.ts +2 -0
  172. package/dist/src/core/overlay/types.d.ts.map +1 -1
  173. package/dist/src/core/overlay/types.js +2 -0
  174. package/dist/src/core/overlay/types.js.map +1 -1
  175. package/dist/src/tui/tools-ui/ToolsDashboard.d.ts.map +1 -1
  176. package/dist/src/tui/tools-ui/ToolsDashboard.js +1 -1
  177. package/dist/src/tui/tools-ui/ToolsDashboard.js.map +1 -1
  178. package/dist/src/tui/tools-ui/ToolsOverview.d.ts.map +1 -1
  179. package/dist/src/tui/tools-ui/ToolsOverview.js +51 -4
  180. package/dist/src/tui/tools-ui/ToolsOverview.js.map +1 -1
  181. package/package.json +1 -1
  182. package/shared/agent-types.ts +2 -0
  183. package/workflows/delegate-protocol.codex.md +65 -0
  184. package/workflows/issue-analyze.md +2 -3
  185. package/workflows/issue-gaps-analyze.codex.md +260 -0
  186. package/workflows/issue-gaps-analyze.md +214 -0
@@ -1,95 +1,95 @@
1
- ---
2
- name: manage-knowhow
3
- description: Manage knowhow entries across workflow and system stores (list, search, view, edit, delete, prune)
4
- argument-hint: "[list|search|view|edit|delete|prune] [query|id|file] [--store workflow|system|all] [--tag tag] [--type type]"
5
- allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
6
- ---
7
-
8
- <purpose>
9
- Manage knowhow entries across workflow and system stores. Provides list, search, view, edit, delete, and prune operations over `.workflow/knowhow/` (workflow store) and `~/.claude/projects/{project}/memory/` (system store).
10
- </purpose>
11
-
12
- <context>
13
- $ARGUMENTS — subcommand followed by options. Defaults to `list` if no arguments.
14
-
15
- ```bash
16
- $manage-knowhow
17
- $manage-knowhow "list --store workflow"
18
- $manage-knowhow "search authentication"
19
- $manage-knowhow "view KNW-20260318-001"
20
- $manage-knowhow "edit MEMORY.md"
21
- $manage-knowhow "delete TIP-20260318-001 --confirm"
22
- $manage-knowhow "prune --before 2026-01-01 --type tip --dry-run"
23
- ```
24
-
25
- **Subcommands**: `list`, `search`, `view`, `edit`, `delete`, `prune`.
26
-
27
- **Flags**:
28
- - `--store workflow|system|all` — Target store (default: all)
29
- - `--tag <tag>` — Filter by tag
30
- - `--type <session|tip|template|recipe|reference|decision>` — Filter by knowhow type
31
- - `--confirm` — Skip delete confirmation prompt
32
- - `--before <date>` / `--after <date>` — Date filters for prune
33
- - `--dry-run` — Preview prune without deleting
34
- </context>
35
-
36
- <execution>
37
-
38
- ### Step 1: Resolve Store Paths
39
-
40
- - **Workflow store**: `.workflow/knowhow/` (entries: `KNW-*.md`, `TIP-*.md`, `TPL-*.md`, `RCP-*.md`, `REF-*.md`, `DCS-*.md`, indexed in `.workflow/wiki-index.json`)
41
- - **System store**: `~/.claude/projects/{project}/memory/` (files: `MEMORY.md` + topic `.md` files)
42
-
43
- Derive system path from project root (replace path separators with `--`, prefix drive letter).
44
-
45
- ### Step 2: Parse Subcommand
46
-
47
- Default to `list` if no arguments. Parse first token as subcommand.
48
-
49
- ### Step 3: Execute Subcommand
50
-
51
- **list**: Show entries from both stores (or filtered by `--store`, `--tag`, `--type`).
52
- - Workflow: use `maestro wiki list --type knowhow --json` or read `.workflow/wiki-index.json`, display ID, type, category, date, tags, title
53
- - System: list `.md` files in system memory directory
54
-
55
- **search `<query>`**: Full-text grep across both stores. Rank by match count.
56
-
57
- **view `<id|file>`**: Auto-detect store from format (`KNW-*/TIP-*/TPL-*/RCP-*/REF-*/DCS-*` = workflow, else system). Display full content.
58
-
59
- **edit `<file>`**: Edit a system memory file. Read current content, apply changes. Warn if MEMORY.md exceeds 200 lines (W003).
60
-
61
- **delete `<id|file>`**: Require confirmation (or `--confirm` flag). MEMORY.md cannot be deleted (E004). Remove entry file (WikiIndexer auto-updates `.workflow/wiki-index.json` on next access).
62
-
63
- **prune**: Requires at least one filter (`--tag`, `--type`, `--before`, `--after`). Workflow store only. `--dry-run` previews without deleting.
64
-
65
- ### Step 4: Integrity Check
66
-
67
- After write operations, verify:
68
- - No orphaned files without index entries (W001)
69
- - No dangling index references to missing files (W001)
70
- - System MEMORY.md references valid topic files (W002)
71
- </execution>
72
-
73
- <error_codes>
74
- | Code | Severity | Description |
75
- |------|----------|-------------|
76
- | E001 | error | No stores found — run `Skill({ skill: "manage-knowhow-capture" })` or create MEMORY.md |
77
- | E002 | error | Entry ID or filename not found |
78
- | E003 | error | Prune requires at least one filter flag |
79
- | E004 | error | Cannot delete MEMORY.md — use `edit` subcommand instead |
80
- | W001 | warning | Index has orphaned files or dangling references |
81
- | W002 | warning | MEMORY.md references non-existent topic file |
82
- | W003 | warning | MEMORY.md exceeds 200 lines — content truncated at load |
83
- </error_codes>
84
-
85
- <success_criteria>
86
- - [ ] Store paths resolved correctly for both workflow and system stores
87
- - [ ] Subcommand parsed and validated (defaults to list)
88
- - [ ] list: displays entries from selected stores with filtering
89
- - [ ] search: full-text grep across stores, ranked by match count
90
- - [ ] view: auto-detects store, displays full content
91
- - [ ] edit: reads and applies changes to system memory files
92
- - [ ] delete: requires confirmation, prevents MEMORY.md deletion
93
- - [ ] prune: requires filter, supports --dry-run, workflow store only
94
- - [ ] Integrity check after write operations (orphans, dangling refs)
95
- </success_criteria>
1
+ ---
2
+ name: manage-knowhow
3
+ description: Manage knowhow entries (workflow and system)
4
+ argument-hint: "[list|search|view|edit|delete|prune] [query|id|file] [--store workflow|system|all] [--tag tag] [--type type]"
5
+ allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
6
+ ---
7
+
8
+ <purpose>
9
+ Manage knowhow entries across workflow and system stores. Provides list, search, view, edit, delete, and prune operations over `.workflow/knowhow/` (workflow store) and `~/.claude/projects/{project}/memory/` (system store).
10
+ </purpose>
11
+
12
+ <context>
13
+ $ARGUMENTS — subcommand followed by options. Defaults to `list` if no arguments.
14
+
15
+ ```bash
16
+ $manage-knowhow
17
+ $manage-knowhow "list --store workflow"
18
+ $manage-knowhow "search authentication"
19
+ $manage-knowhow "view KNW-20260318-001"
20
+ $manage-knowhow "edit MEMORY.md"
21
+ $manage-knowhow "delete TIP-20260318-001 --confirm"
22
+ $manage-knowhow "prune --before 2026-01-01 --type tip --dry-run"
23
+ ```
24
+
25
+ **Subcommands**: `list`, `search`, `view`, `edit`, `delete`, `prune`.
26
+
27
+ **Flags**:
28
+ - `--store workflow|system|all` — Target store (default: all)
29
+ - `--tag <tag>` — Filter by tag
30
+ - `--type <session|tip|template|recipe|reference|decision>` — Filter by knowhow type
31
+ - `--confirm` — Skip delete confirmation prompt
32
+ - `--before <date>` / `--after <date>` — Date filters for prune
33
+ - `--dry-run` — Preview prune without deleting
34
+ </context>
35
+
36
+ <execution>
37
+
38
+ ### Step 1: Resolve Store Paths
39
+
40
+ - **Workflow store**: `.workflow/knowhow/` (entries: `KNW-*.md`, `TIP-*.md`, `TPL-*.md`, `RCP-*.md`, `REF-*.md`, `DCS-*.md`, indexed in `.workflow/wiki-index.json`)
41
+ - **System store**: `~/.claude/projects/{project}/memory/` (files: `MEMORY.md` + topic `.md` files)
42
+
43
+ Derive system path from project root (replace path separators with `--`, prefix drive letter).
44
+
45
+ ### Step 2: Parse Subcommand
46
+
47
+ Default to `list` if no arguments. Parse first token as subcommand.
48
+
49
+ ### Step 3: Execute Subcommand
50
+
51
+ **list**: Show entries from both stores (or filtered by `--store`, `--tag`, `--type`).
52
+ - Workflow: use `maestro wiki list --type knowhow --json` or read `.workflow/wiki-index.json`, display ID, type, category, date, tags, title
53
+ - System: list `.md` files in system memory directory
54
+
55
+ **search `<query>`**: Full-text grep across both stores. Rank by match count.
56
+
57
+ **view `<id|file>`**: Auto-detect store from format (`KNW-*/TIP-*/TPL-*/RCP-*/REF-*/DCS-*` = workflow, else system). Display full content.
58
+
59
+ **edit `<file>`**: Edit a system memory file. Read current content, apply changes. Warn if MEMORY.md exceeds 200 lines (W003).
60
+
61
+ **delete `<id|file>`**: Require confirmation (or `--confirm` flag). MEMORY.md cannot be deleted (E004). Remove entry file (WikiIndexer auto-updates `.workflow/wiki-index.json` on next access).
62
+
63
+ **prune**: Requires at least one filter (`--tag`, `--type`, `--before`, `--after`). Workflow store only. `--dry-run` previews without deleting.
64
+
65
+ ### Step 4: Integrity Check
66
+
67
+ After write operations, verify:
68
+ - No orphaned files without index entries (W001)
69
+ - No dangling index references to missing files (W001)
70
+ - System MEMORY.md references valid topic files (W002)
71
+ </execution>
72
+
73
+ <error_codes>
74
+ | Code | Severity | Description |
75
+ |------|----------|-------------|
76
+ | E001 | error | No stores found — run `Skill({ skill: "manage-knowhow-capture" })` or create MEMORY.md |
77
+ | E002 | error | Entry ID or filename not found |
78
+ | E003 | error | Prune requires at least one filter flag |
79
+ | E004 | error | Cannot delete MEMORY.md — use `edit` subcommand instead |
80
+ | W001 | warning | Index has orphaned files or dangling references |
81
+ | W002 | warning | MEMORY.md references non-existent topic file |
82
+ | W003 | warning | MEMORY.md exceeds 200 lines — content truncated at load |
83
+ </error_codes>
84
+
85
+ <success_criteria>
86
+ - [ ] Store paths resolved correctly for both workflow and system stores
87
+ - [ ] Subcommand parsed and validated (defaults to list)
88
+ - [ ] list: displays entries from selected stores with filtering
89
+ - [ ] search: full-text grep across stores, ranked by match count
90
+ - [ ] view: auto-detects store, displays full content
91
+ - [ ] edit: reads and applies changes to system memory files
92
+ - [ ] delete: requires confirmation, prevents MEMORY.md deletion
93
+ - [ ] prune: requires filter, supports --dry-run, workflow store only
94
+ - [ ] Integrity check after write operations (orphans, dangling refs)
95
+ </success_criteria>
@@ -1,110 +1,110 @@
1
- ---
2
- name: manage-knowhow-capture
3
- description: Capture reusable knowledge into .workflow/knowhow/ — session compact, template, recipe, reference, decision, or tip
4
- argument-hint: "[type] [description] [--lang lang] [--source url] [--tag tag1,tag2]"
5
- allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
6
- ---
7
-
8
- <purpose>
9
- Capture reusable knowledge into `.workflow/knowhow/`. Six content types: `session` (full session recovery), `template` (code/config pattern), `recipe` (step-by-step guide), `reference` (external doc summary), `decision` (ADR), `tip` (quick note). Auto-detects type or asks user.
10
- </purpose>
11
-
12
- <context>
13
- $ARGUMENTS — type token followed by description and optional flags.
14
-
15
- ```bash
16
- $manage-knowhow-capture
17
- $manage-knowhow-capture "compact"
18
- $manage-knowhow-capture "template React form pattern --lang typescript"
19
- $manage-knowhow-capture "tip Always check state.json before phase operations --tag workflow,state"
20
- $manage-knowhow-capture "recipe Deploy to production --tag deploy,ops"
21
- $manage-knowhow-capture "reference Stripe API --source https://docs.stripe.com/api"
22
- $manage-knowhow-capture "decision Use PostgreSQL over MongoDB --status accepted"
23
- ```
24
-
25
- **Types**: `compact` | `template` | `recipe` | `reference` | `decision` | `tip`
26
-
27
- **Flags**:
28
- - `--lang <lang>` — Language for templates (typescript, python, bash, yaml, ...)
29
- - `--source <url>` — Source URL for references
30
- - `--tag tag1,tag2` — Categorization tags
31
- - `--title <title>` — Explicit title
32
- </context>
33
-
34
- <execution>
35
-
36
- ### Step 1: Validate
37
-
38
- Verify `.workflow/` exists (E001). Create `.workflow/knowhow/` if missing.
39
-
40
- ### Step 2: Detect Type
41
-
42
- Parse first token as type. If absent or ambiguous, ask user via AskUserQuestion.
43
-
44
- | Token | Type |
45
- |-------|------|
46
- | `compact`, `session`, `压缩` | session |
47
- | `template`, `tpl`, `模板` | template |
48
- | `recipe`, `rcp`, `配方`, `步骤` | recipe |
49
- | `reference`, `ref`, `参考` | reference |
50
- | `decision`, `dcs`, `决策` | decision |
51
- | `tip`, `note`, `记录` | tip |
52
-
53
- ### Step 3: Capture Content by Type
54
-
55
- **session** (KNW-{YYYYMMDD}-{HHMM}.md):
56
- Extract from conversation: objective, key decisions, modified files (absolute paths), execution plan (verbatim), pending work, notes. Sections: Session ID, Project Root, Objective, Execution Plan, Working Files, Reference Files, Last Action, Decisions, Constraints, Dependencies, Changes Made, Pending, Notes.
57
-
58
- **template** (TPL-{YYYYMMDD}-{HHMM}.md):
59
- Prompt for or extract: language (`--lang`), usage context, code content, parameters, dependencies. Sections: Usage, Parameters, Dependencies, Code (fenced block).
60
-
61
- **recipe** (RCP-{YYYYMMDD}-{HHMM}.md):
62
- Prompt for or extract: goal, prerequisites, numbered steps, expected outcome, common pitfalls, related entries. Sections: Goal, Prerequisites, Steps, Expected Outcome, Common Pitfalls, Related.
63
-
64
- **reference** (REF-{YYYYMMDD}-{HHMM}.md):
65
- Source from `--source` flag (offer WebFetch if URL). Extract: key points, applicable scenarios, quick examples. Sections: Source, Key Points, Applicable Scenarios, Quick Examples.
66
-
67
- **decision** (DCS-{YYYYMMDD}-{HHMM}.md):
68
- Prompt for or extract: context, decision, alternatives (at least 2), rationale, consequences. Sections: Context, Decision, Alternatives Considered (table), Rationale, Consequences, Related.
69
-
70
- **tip** (TIP-{YYYYMMDD}-{HHMM}.md):
71
- Content from remaining arguments. Auto-detect context from recent conversation files. Sections: Content, Context, Tags, Timestamp.
72
-
73
- ### Step 4: Write File
74
-
75
- Write to `.workflow/knowhow/{PREFIX}-{YYYYMMDD}-{HHMM}.md` with YAML frontmatter:
76
-
77
- ```yaml
78
- ---
79
- title: {auto or --title}
80
- type: {type}
81
- category: {type}
82
- created: {ISO timestamp}
83
- tags: [{tags}]
84
- ```
85
- Plus type-specific: `lang` (template), `source` (reference), `status` (decision).
86
-
87
- ### Step 5: Confirm
88
-
89
- Display: type, ID, file path, and type-specific summary.
90
- </execution>
91
-
92
- <error_codes>
93
- | Code | Severity | Description |
94
- |------|----------|-------------|
95
- | E001 | error | `.workflow/` not initialized — run `Skill({ skill: "maestro-init" })` first |
96
- | E002 | error | Template: no code provided after prompt |
97
- | E003 | error | Recipe: no steps provided after prompt |
98
- | W001 | warning | No active workflow session — compact captures conversation only |
99
- | W002 | warning | No explicit plan found — using inferred plan |
100
- | W003 | warning | `--source` URL could not be fetched — proceeding with manual entry |
101
- </error_codes>
102
-
103
- <success_criteria>
104
- - [ ] `.workflow/` existence validated; `.workflow/knowhow/` created if missing
105
- - [ ] Type detected or prompted (all 6 types)
106
- - [ ] Type-specific content collected (code for template, steps for recipe, etc.)
107
- - [ ] YAML frontmatter with type-specific fields written
108
- - [ ] Markdown file written with correct prefix and structured sections
109
- - [ ] Confirmation displayed with ID, type, category, and file path
110
- </success_criteria>
1
+ ---
2
+ name: manage-knowhow-capture
3
+ description: Capture reusable knowledge as templates, recipes, or tips
4
+ argument-hint: "[type] [description] [--lang lang] [--source url] [--tag tag1,tag2]"
5
+ allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
6
+ ---
7
+
8
+ <purpose>
9
+ Capture reusable knowledge into `.workflow/knowhow/`. Six content types: `session` (full session recovery), `template` (code/config pattern), `recipe` (step-by-step guide), `reference` (external doc summary), `decision` (ADR), `tip` (quick note). Auto-detects type or asks user.
10
+ </purpose>
11
+
12
+ <context>
13
+ $ARGUMENTS — type token followed by description and optional flags.
14
+
15
+ ```bash
16
+ $manage-knowhow-capture
17
+ $manage-knowhow-capture "compact"
18
+ $manage-knowhow-capture "template React form pattern --lang typescript"
19
+ $manage-knowhow-capture "tip Always check state.json before phase operations --tag workflow,state"
20
+ $manage-knowhow-capture "recipe Deploy to production --tag deploy,ops"
21
+ $manage-knowhow-capture "reference Stripe API --source https://docs.stripe.com/api"
22
+ $manage-knowhow-capture "decision Use PostgreSQL over MongoDB --status accepted"
23
+ ```
24
+
25
+ **Types**: `compact` | `template` | `recipe` | `reference` | `decision` | `tip`
26
+
27
+ **Flags**:
28
+ - `--lang <lang>` — Language for templates (typescript, python, bash, yaml, ...)
29
+ - `--source <url>` — Source URL for references
30
+ - `--tag tag1,tag2` — Categorization tags
31
+ - `--title <title>` — Explicit title
32
+ </context>
33
+
34
+ <execution>
35
+
36
+ ### Step 1: Validate
37
+
38
+ Verify `.workflow/` exists (E001). Create `.workflow/knowhow/` if missing.
39
+
40
+ ### Step 2: Detect Type
41
+
42
+ Parse first token as type. If absent or ambiguous, ask user via AskUserQuestion.
43
+
44
+ | Token | Type |
45
+ |-------|------|
46
+ | `compact`, `session`, `压缩` | session |
47
+ | `template`, `tpl`, `模板` | template |
48
+ | `recipe`, `rcp`, `配方`, `步骤` | recipe |
49
+ | `reference`, `ref`, `参考` | reference |
50
+ | `decision`, `dcs`, `决策` | decision |
51
+ | `tip`, `note`, `记录` | tip |
52
+
53
+ ### Step 3: Capture Content by Type
54
+
55
+ **session** (KNW-{YYYYMMDD}-{HHMM}.md):
56
+ Extract from conversation: objective, key decisions, modified files (absolute paths), execution plan (verbatim), pending work, notes. Sections: Session ID, Project Root, Objective, Execution Plan, Working Files, Reference Files, Last Action, Decisions, Constraints, Dependencies, Changes Made, Pending, Notes.
57
+
58
+ **template** (TPL-{YYYYMMDD}-{HHMM}.md):
59
+ Prompt for or extract: language (`--lang`), usage context, code content, parameters, dependencies. Sections: Usage, Parameters, Dependencies, Code (fenced block).
60
+
61
+ **recipe** (RCP-{YYYYMMDD}-{HHMM}.md):
62
+ Prompt for or extract: goal, prerequisites, numbered steps, expected outcome, common pitfalls, related entries. Sections: Goal, Prerequisites, Steps, Expected Outcome, Common Pitfalls, Related.
63
+
64
+ **reference** (REF-{YYYYMMDD}-{HHMM}.md):
65
+ Source from `--source` flag (offer WebFetch if URL). Extract: key points, applicable scenarios, quick examples. Sections: Source, Key Points, Applicable Scenarios, Quick Examples.
66
+
67
+ **decision** (DCS-{YYYYMMDD}-{HHMM}.md):
68
+ Prompt for or extract: context, decision, alternatives (at least 2), rationale, consequences. Sections: Context, Decision, Alternatives Considered (table), Rationale, Consequences, Related.
69
+
70
+ **tip** (TIP-{YYYYMMDD}-{HHMM}.md):
71
+ Content from remaining arguments. Auto-detect context from recent conversation files. Sections: Content, Context, Tags, Timestamp.
72
+
73
+ ### Step 4: Write File
74
+
75
+ Write to `.workflow/knowhow/{PREFIX}-{YYYYMMDD}-{HHMM}.md` with YAML frontmatter:
76
+
77
+ ```yaml
78
+ ---
79
+ title: {auto or --title}
80
+ type: {type}
81
+ category: {type}
82
+ created: {ISO timestamp}
83
+ tags: [{tags}]
84
+ ```
85
+ Plus type-specific: `lang` (template), `source` (reference), `status` (decision).
86
+
87
+ ### Step 5: Confirm
88
+
89
+ Display: type, ID, file path, and type-specific summary.
90
+ </execution>
91
+
92
+ <error_codes>
93
+ | Code | Severity | Description |
94
+ |------|----------|-------------|
95
+ | E001 | error | `.workflow/` not initialized — run `Skill({ skill: "maestro-init" })` first |
96
+ | E002 | error | Template: no code provided after prompt |
97
+ | E003 | error | Recipe: no steps provided after prompt |
98
+ | W001 | warning | No active workflow session — compact captures conversation only |
99
+ | W002 | warning | No explicit plan found — using inferred plan |
100
+ | W003 | warning | `--source` URL could not be fetched — proceeding with manual entry |
101
+ </error_codes>
102
+
103
+ <success_criteria>
104
+ - [ ] `.workflow/` existence validated; `.workflow/knowhow/` created if missing
105
+ - [ ] Type detected or prompted (all 6 types)
106
+ - [ ] Type-specific content collected (code for template, steps for recipe, etc.)
107
+ - [ ] YAML frontmatter with type-specific fields written
108
+ - [ ] Markdown file written with correct prefix and structured sections
109
+ - [ ] Confirmation displayed with ID, type, category, and file path
110
+ </success_criteria>
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: manage-learn
3
- description: Capture atomic learning insights into .workflow/learning/lessons.jsonl. Lightweight CRUD over the shared learning store — supports capture, list, search, and show modes. No LLM or CLI calls; all operations are pure file reads and writes.
3
+ description: Capture and search learning insights and tips
4
4
  argument-hint: "[\"<insight text>\"|list|search <query>|show <INS-id>] [--category pattern|antipattern|decision|tool|gotcha|technique] [--tag t1,t2] [--phase N] [--confidence high|medium|low]"
5
5
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: manage-status
3
- description: Display project dashboard with phase progress, active tasks, and next steps
3
+ description: Show project dashboard with progress and next steps
4
4
  argument-hint: ""
5
5
  allowed-tools: Read, Bash, Glob, Grep
6
6
  ---
@@ -1,55 +1,55 @@
1
- ---
2
- name: manage-wiki
3
- description: Wiki knowledge graph management health dashboard, orphan cleanup, entry search, and graph statistics
4
- argument-hint: "[health|search|cleanup|stats] [options]"
5
- allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
6
- ---
7
-
8
- <purpose>
9
- Unified wiki graph management. Health monitoring, interactive search, orphan cleanup, and graph statistics. Day-to-day operations to keep the knowledge graph healthy.
10
-
11
- Complements `wiki-connect` (link discovery) and `wiki-digest` (synthesis) with operational tooling.
12
- </purpose>
13
-
14
- <required_reading>
15
- @~/.maestro/workflows/wiki-manage.md
16
- </required_reading>
17
-
18
- <context>
19
- $ARGUMENTS — subcommand and optional flags.
20
-
21
- **Subcommands:**
22
- | Subcommand | Description |
23
- |-----------|-------------|
24
- | `health` | Health dashboard — score, broken links, orphans, hubs (default) |
25
- | `search <query>` | Interactive BM25 search with follow-up actions |
26
- | `cleanup` | Find and resolve orphans, broken links, stale entries |
27
- | `stats` | Graph statistics — type distribution, tag frequency, growth |
28
-
29
- **Flags:**
30
- - `--type <type>` — Filter: spec, knowhow, note, lesson, issue
31
- - `--fix` — Auto-fix issues during cleanup
32
- - `--json` — JSON output
33
- </context>
34
-
35
- <execution>
36
- Follow '~/.maestro/workflows/wiki-manage.md' completely.
37
- </execution>
38
-
39
- <error_codes>
40
- | Code | Severity | Description |
41
- |------|----------|-------------|
42
- | E001 | fatal | `.workflow/` not initialized |
43
- | E002 | fatal | No wiki entries found |
44
- | E003 | error | Invalid subcommand |
45
- | W001 | warning | Health score below 50 |
46
- | W002 | warning | Cleanup had partial failures |
47
- </error_codes>
48
-
49
- <success_criteria>
50
- - [ ] Subcommand parsed (health/search/cleanup/stats)
51
- - [ ] Wiki data loaded via `maestro wiki` CLI
52
- - [ ] Results displayed in formatted output
53
- - [ ] If cleanup --fix: issues resolved and delta reported
54
- - [ ] Next-step suggestions provided
55
- </success_criteria>
1
+ ---
2
+ name: manage-wiki
3
+ description: Manage wiki graph -- health, cleanup, search, stats
4
+ argument-hint: "[health|search|cleanup|stats] [options]"
5
+ allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
6
+ ---
7
+
8
+ <purpose>
9
+ Unified wiki graph management. Health monitoring, interactive search, orphan cleanup, and graph statistics. Day-to-day operations to keep the knowledge graph healthy.
10
+
11
+ Complements `wiki-connect` (link discovery) and `wiki-digest` (synthesis) with operational tooling.
12
+ </purpose>
13
+
14
+ <required_reading>
15
+ @~/.maestro/workflows/wiki-manage.md
16
+ </required_reading>
17
+
18
+ <context>
19
+ $ARGUMENTS — subcommand and optional flags.
20
+
21
+ **Subcommands:**
22
+ | Subcommand | Description |
23
+ |-----------|-------------|
24
+ | `health` | Health dashboard — score, broken links, orphans, hubs (default) |
25
+ | `search <query>` | Interactive BM25 search with follow-up actions |
26
+ | `cleanup` | Find and resolve orphans, broken links, stale entries |
27
+ | `stats` | Graph statistics — type distribution, tag frequency, growth |
28
+
29
+ **Flags:**
30
+ - `--type <type>` — Filter: spec, knowhow, note, lesson, issue
31
+ - `--fix` — Auto-fix issues during cleanup
32
+ - `--json` — JSON output
33
+ </context>
34
+
35
+ <execution>
36
+ Follow '~/.maestro/workflows/wiki-manage.md' completely.
37
+ </execution>
38
+
39
+ <error_codes>
40
+ | Code | Severity | Description |
41
+ |------|----------|-------------|
42
+ | E001 | fatal | `.workflow/` not initialized |
43
+ | E002 | fatal | No wiki entries found |
44
+ | E003 | error | Invalid subcommand |
45
+ | W001 | warning | Health score below 50 |
46
+ | W002 | warning | Cleanup had partial failures |
47
+ </error_codes>
48
+
49
+ <success_criteria>
50
+ - [ ] Subcommand parsed (health/search/cleanup/stats)
51
+ - [ ] Wiki data loaded via `maestro wiki` CLI
52
+ - [ ] Results displayed in formatted output
53
+ - [ ] If cleanup --fix: issues resolved and delta reported
54
+ - [ ] Next-step suggestions provided
55
+ </success_criteria>