maxsimcli 5.0.6 → 5.1.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.
Files changed (91) hide show
  1. package/README.md +316 -288
  2. package/dist/assets/CHANGELOG.md +14 -0
  3. package/dist/assets/hooks/maxsim-capture-learnings.cjs +128 -0
  4. package/dist/assets/hooks/maxsim-capture-learnings.cjs.map +1 -0
  5. package/dist/assets/hooks/maxsim-check-update.cjs +126 -88
  6. package/dist/assets/hooks/maxsim-check-update.cjs.map +1 -1
  7. package/dist/assets/hooks/maxsim-notification-sound.cjs +87 -43
  8. package/dist/assets/hooks/maxsim-notification-sound.cjs.map +1 -1
  9. package/dist/assets/hooks/maxsim-statusline.cjs +45 -171
  10. package/dist/assets/hooks/maxsim-statusline.cjs.map +1 -1
  11. package/dist/assets/hooks/maxsim-stop-sound.cjs +86 -43
  12. package/dist/assets/hooks/maxsim-stop-sound.cjs.map +1 -1
  13. package/dist/assets/hooks/maxsim-sync-reminder.cjs +72 -21
  14. package/dist/assets/hooks/maxsim-sync-reminder.cjs.map +1 -1
  15. package/dist/assets/templates/agents/AGENTS.md +62 -51
  16. package/dist/assets/templates/agents/executor.md +44 -59
  17. package/dist/assets/templates/agents/planner.md +36 -31
  18. package/dist/assets/templates/agents/researcher.md +35 -43
  19. package/dist/assets/templates/agents/verifier.md +29 -31
  20. package/dist/assets/templates/commands/maxsim/debug.md +20 -154
  21. package/dist/assets/templates/commands/maxsim/execute.md +19 -33
  22. package/dist/assets/templates/commands/maxsim/go.md +21 -20
  23. package/dist/assets/templates/commands/maxsim/help.md +5 -14
  24. package/dist/assets/templates/commands/maxsim/init.md +18 -40
  25. package/dist/assets/templates/commands/maxsim/plan.md +22 -37
  26. package/dist/assets/templates/commands/maxsim/progress.md +15 -16
  27. package/dist/assets/templates/commands/maxsim/quick.md +18 -29
  28. package/dist/assets/templates/commands/maxsim/settings.md +18 -26
  29. package/dist/assets/templates/references/continuation-format.md +2 -4
  30. package/dist/assets/templates/references/model-profiles.md +2 -2
  31. package/dist/assets/templates/references/planning-config.md +10 -11
  32. package/dist/assets/templates/references/self-improvement.md +120 -0
  33. package/dist/assets/templates/rules/conventions.md +1 -1
  34. package/dist/assets/templates/rules/verification-protocol.md +1 -1
  35. package/dist/assets/templates/skills/brainstorming/SKILL.md +35 -26
  36. package/dist/assets/templates/skills/code-review/SKILL.md +78 -55
  37. package/dist/assets/templates/skills/commit-conventions/SKILL.md +70 -36
  38. package/dist/assets/templates/skills/github-operations/SKILL.md +142 -0
  39. package/dist/assets/templates/skills/handoff-contract/SKILL.md +62 -28
  40. package/dist/assets/templates/skills/maxsim-batch/SKILL.md +68 -42
  41. package/dist/assets/templates/skills/maxsim-simplify/SKILL.md +65 -40
  42. package/dist/assets/templates/skills/project-memory/SKILL.md +121 -0
  43. package/dist/assets/templates/skills/research/SKILL.md +126 -0
  44. package/dist/assets/templates/skills/roadmap-writing/SKILL.md +71 -68
  45. package/dist/assets/templates/skills/systematic-debugging/SKILL.md +37 -25
  46. package/dist/assets/templates/skills/tdd/SKILL.md +36 -39
  47. package/dist/assets/templates/skills/using-maxsim/SKILL.md +69 -55
  48. package/dist/assets/templates/skills/verification/SKILL.md +167 -0
  49. package/dist/assets/templates/workflows/batch.md +249 -268
  50. package/dist/assets/templates/workflows/diagnose-issues.md +225 -151
  51. package/dist/assets/templates/workflows/execute-plan.md +191 -981
  52. package/dist/assets/templates/workflows/execute.md +350 -309
  53. package/dist/assets/templates/workflows/go.md +119 -138
  54. package/dist/assets/templates/workflows/health.md +71 -114
  55. package/dist/assets/templates/workflows/help.md +85 -147
  56. package/dist/assets/templates/workflows/init-existing.md +180 -1373
  57. package/dist/assets/templates/workflows/init.md +53 -165
  58. package/dist/assets/templates/workflows/new-milestone.md +91 -334
  59. package/dist/assets/templates/workflows/new-project.md +165 -1384
  60. package/dist/assets/templates/workflows/plan-create.md +182 -73
  61. package/dist/assets/templates/workflows/plan-discuss.md +89 -82
  62. package/dist/assets/templates/workflows/plan-research.md +191 -85
  63. package/dist/assets/templates/workflows/plan.md +122 -58
  64. package/dist/assets/templates/workflows/progress.md +76 -310
  65. package/dist/assets/templates/workflows/quick.md +70 -495
  66. package/dist/assets/templates/workflows/sdd.md +231 -221
  67. package/dist/assets/templates/workflows/settings.md +90 -120
  68. package/dist/assets/templates/workflows/verify-phase.md +296 -258
  69. package/dist/cli.cjs +17 -23465
  70. package/dist/cli.cjs.map +1 -1
  71. package/dist/install.cjs +356 -8358
  72. package/dist/install.cjs.map +1 -1
  73. package/package.json +16 -22
  74. package/dist/assets/templates/skills/agent-system-map/SKILL.md +0 -92
  75. package/dist/assets/templates/skills/evidence-collection/SKILL.md +0 -87
  76. package/dist/assets/templates/skills/github-artifact-protocol/SKILL.md +0 -67
  77. package/dist/assets/templates/skills/github-tools-guide/SKILL.md +0 -89
  78. package/dist/assets/templates/skills/input-validation/SKILL.md +0 -51
  79. package/dist/assets/templates/skills/memory-management/SKILL.md +0 -75
  80. package/dist/assets/templates/skills/research-methodology/SKILL.md +0 -137
  81. package/dist/assets/templates/skills/sdd/SKILL.md +0 -91
  82. package/dist/assets/templates/skills/tool-priority-guide/SKILL.md +0 -80
  83. package/dist/assets/templates/skills/verification-before-completion/SKILL.md +0 -71
  84. package/dist/assets/templates/skills/verification-gates/SKILL.md +0 -169
  85. package/dist/assets/templates/workflows/discuss-phase.md +0 -683
  86. package/dist/assets/templates/workflows/research-phase.md +0 -73
  87. package/dist/assets/templates/workflows/verify-work.md +0 -572
  88. package/dist/core-D5zUr9cb.cjs +0 -4305
  89. package/dist/core-D5zUr9cb.cjs.map +0 -1
  90. package/dist/skills-CjFWZIGM.cjs +0 -6824
  91. package/dist/skills-CjFWZIGM.cjs.map +0 -1
@@ -1,167 +1,33 @@
1
1
  ---
2
2
  name: maxsim:debug
3
- description: Systematic debugging with persistent state across context resets
4
- argument-hint: [issue description]
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Task
9
- - AskUserQuestion
3
+ description: Systematic debugging with reproduce-hypothesize-isolate-verify-fix cycle
4
+ argument-hint: "[issue description]"
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, AskUserQuestion]
10
6
  ---
11
7
 
12
8
  <objective>
13
- Debug issues using scientific method with subagent isolation.
14
-
15
- **Orchestrator role:** Gather symptoms, spawn verifier agent (debug mode), handle checkpoints, spawn continuations.
16
-
17
- **Why subagent:** Investigation burns context fast (reading files, forming hypotheses, testing). Fresh 200k context per investigation. Main context stays lean for user interaction.
9
+ Debug issues using a scientific method cycle: Reproduce → Hypothesize → Isolate → Verify → Fix. Active debug sessions are tracked as GitHub Issues (label: `debug`).
18
10
  </objective>
19
11
 
20
12
  <context>
21
- User's issue: $ARGUMENTS
13
+ Arguments: $ARGUMENTS
14
+
15
+ If $ARGUMENTS is provided, treat it as the issue description and skip straight to symptom confirmation.
22
16
 
23
- Check for active sessions:
24
- ```bash
25
- ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
26
- ```
17
+ GitHub is the sole source of truth. Check for open Issues labeled `debug` to detect active sessions — no .planning/debug/ files.
27
18
  </context>
28
19
 
29
20
  <process>
30
-
31
- ## 0. Initialize Context
32
-
33
- ```bash
34
- INIT=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs state load)
35
- ```
36
-
37
- Extract `commit_docs` from init JSON. Resolve debugger model:
38
- ```bash
39
- DEBUGGER_MODEL=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs resolve-model verifier --raw)
40
- ```
41
-
42
- ## 1. Check Active Sessions
43
-
44
- If active sessions exist AND no $ARGUMENTS:
45
- - List sessions with status, hypothesis, next action
46
- - User picks number to resume OR describes new issue
47
-
48
- If $ARGUMENTS provided OR user describes new issue:
49
- - Continue to symptom gathering
50
-
51
- ## 2. Gather Symptoms (if new issue)
52
-
53
- Use AskUserQuestion for each:
54
-
55
- 1. **Expected behavior** - What should happen?
56
- 2. **Actual behavior** - What happens instead?
57
- 3. **Error messages** - Any errors? (paste or describe)
58
- 4. **Timeline** - When did this start? Ever worked?
59
- 5. **Reproduction** - How do you trigger it?
60
-
61
- After all gathered, confirm ready to investigate.
62
-
63
- ## 3. Spawn Verifier Agent (Debug Mode)
64
-
65
- Fill prompt and spawn:
66
-
67
- ```markdown
68
- <objective>
69
- Investigate issue: {slug}
70
-
71
- **Summary:** {trigger}
72
- </objective>
73
-
74
- <symptoms>
75
- expected: {expected}
76
- actual: {actual}
77
- errors: {errors}
78
- reproduction: {reproduction}
79
- timeline: {timeline}
80
- </symptoms>
81
-
82
- <mode>
83
- symptoms_prefilled: true
84
- goal: find_and_fix
85
- </mode>
86
-
87
- <debug_file>
88
- Create: .planning/debug/{slug}.md
89
- </debug_file>
90
- ```
91
-
92
- ```
93
- Task(
94
- prompt=filled_prompt,
95
- subagent_type="verifier",
96
- model="{debugger_model}",
97
- description="Debug {slug}"
98
- )
99
- ```
100
-
101
- ## 4. Handle Agent Return
102
-
103
- **If `## ROOT CAUSE FOUND`:**
104
- - Display root cause and evidence summary
105
- - Offer options:
106
- - "Fix now" - spawn fix subagent
107
- - "Plan fix" - suggest /maxsim:plan --gaps
108
- - "Manual fix" - done
109
-
110
- **If `## CHECKPOINT REACHED`:**
111
- - Present checkpoint details to user
112
- - Get user response
113
- - If checkpoint type is `human-verify`:
114
- - If user confirms fixed: continue so agent can finalize/resolve/archive
115
- - If user reports issues: continue so agent returns to investigation/fixing
116
- - Spawn continuation agent (see step 5)
117
-
118
- **If `## INVESTIGATION INCONCLUSIVE`:**
119
- - Show what was checked and eliminated
120
- - Offer options:
121
- - "Continue investigating" - spawn new agent with additional context
122
- - "Manual investigation" - done
123
- - "Add more context" - gather more symptoms, spawn again
124
-
125
- ## 5. Spawn Continuation Agent (After Checkpoint)
126
-
127
- When user responds to checkpoint, spawn fresh agent:
128
-
129
- ```markdown
130
- <objective>
131
- Continue debugging {slug}. Evidence is in the debug file.
132
- </objective>
133
-
134
- <prior_state>
135
- <files_to_read>
136
- - .planning/debug/{slug}.md (Debug session state)
137
- </files_to_read>
138
- </prior_state>
139
-
140
- <checkpoint_response>
141
- **Type:** {checkpoint_type}
142
- **Response:** {user_response}
143
- </checkpoint_response>
144
-
145
- <mode>
146
- goal: find_and_fix
147
- </mode>
148
- ```
149
-
150
- ```
151
- Task(
152
- prompt=continuation_prompt,
153
- subagent_type="verifier",
154
- model="{debugger_model}",
155
- description="Continue debug {slug}"
156
- )
157
- ```
158
-
21
+ Follow @~/.claude/maxsim/workflows/debug.md end-to-end.
22
+
23
+ 1. Check GitHub for open Issues labeled `debug` (active sessions)
24
+ - If active sessions exist and no $ARGUMENTS: list them, let user pick to resume or start new
25
+ 2. Gather symptoms via AskUserQuestion: expected behavior, actual behavior, errors, timeline, reproduction steps
26
+ 3. Create a GitHub Issue labeled `debug` to track the session
27
+ 4. Spawn a verifier Agent with symptoms and the GitHub Issue URL as context
28
+ 5. Handle Agent return:
29
+ - Root cause found → display findings, offer Fix / Plan Fix / Manual
30
+ - Checkpoint reached → surface to user, get response, spawn continuation Agent
31
+ - Inconclusive → show what was eliminated, offer Continue / Manual / Add Context
32
+ 6. On fix: close the GitHub debug Issue with resolution summary
159
33
  </process>
160
-
161
- <success_criteria>
162
- - [ ] Active sessions checked
163
- - [ ] Symptoms gathered (if new)
164
- - [ ] Verifier agent spawned with debug context
165
- - [ ] Checkpoints handled correctly
166
- - [ ] Root cause confirmed before fixing
167
- </success_criteria>
@@ -1,45 +1,31 @@
1
1
  ---
2
2
  name: maxsim:execute
3
- description: Execute all plans in a phase with auto-verification and retry
4
- argument-hint: "<phase-number> [--worktrees|--no-worktrees]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Glob
10
- - Grep
11
- - Bash
12
- - Task
13
- - TodoWrite
3
+ description: Execute all plans in a phase with parallel agents and auto-verification
4
+ argument-hint: "<phase-number>"
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
14
6
  ---
15
- <objective>
16
- Execute the phase state machine: Execute all plans in wave order, auto-verify, retry on failure (max 2 retries).
17
-
18
- **How it works:**
19
- 1. Detect phase state (already done, partially executed, ready to execute)
20
- 2. Execute all plans grouped by wave — parallel within waves, sequential across waves
21
- 3. Auto-verify after all plans complete — spawn verifier agent
22
- 4. If verification fails, auto-retry with gap closure (max 2 retries, 3 total attempts)
23
- 5. On final failure, report what failed and let user decide
24
- 6. Supports worktree-based parallel execution: --worktrees forces worktree isolation, --no-worktrees forces standard mode
25
7
 
26
- **Re-entry:** If phase is already executed and verified, show status and offer options (view results, re-execute, view verification).
27
-
28
- **Phase-level only:** Operates on the entire phase — no plan-level granularity.
8
+ <objective>
9
+ Execute all task Issues in a phase using parallel Agents, auto-verify results, and retry on failure (max 2 retries). GitHub Issues track task state throughout.
29
10
  </objective>
30
11
 
31
- <execution_context>
32
- @~/.claude/maxsim/workflows/execute.md
33
- @~/.claude/maxsim/references/ui-brand.md
34
- </execution_context>
35
-
36
12
  <context>
37
- Phase number: $ARGUMENTS (required — e.g., `/maxsim:execute 3`)
13
+ Arguments: $ARGUMENTS
14
+
15
+ Phase number is required (e.g., `/maxsim:execute 3`).
38
16
 
39
- Context files are resolved inside the workflow via `maxsim-tools init execute-phase` and per-subagent context assembly.
17
+ GitHub is the sole source of truth. Task state (todo/in-progress/done) is read from GitHub Issue labels and Project Board columns — no .planning/ files.
18
+
19
+ Re-entry: If phase is already executed and verified, show status and offer options (view results, re-execute).
40
20
  </context>
41
21
 
42
22
  <process>
43
- Execute the execute workflow from @~/.claude/maxsim/workflows/execute.md end-to-end.
44
- Preserve all workflow gates (state detection, wave execution, verification, retry loop, re-entry flow).
23
+ Follow @~/.claude/maxsim/workflows/execute.md end-to-end.
24
+
25
+ 1. Detect phase state from GitHub Project Board (already done / partially executed / ready)
26
+ 2. Group task Issues by wave — execute parallel Agents within each wave, sequential across waves
27
+ 3. Each Agent updates its GitHub Issue label on start and completion
28
+ 4. After all tasks complete, spawn a verifier Agent to check acceptance criteria
29
+ 5. On verification failure, auto-retry with gap-closure context (max 2 retries)
30
+ 6. On final failure, report what failed and surface options to user
45
31
  </process>
@@ -1,29 +1,30 @@
1
1
  ---
2
2
  name: maxsim:go
3
- description: Auto-detect project state and dispatch to the right command
4
- allowed-tools:
5
- - Read
6
- - Bash
7
- - Glob
8
- - Grep
9
- - SlashCommand
3
+ description: Auto-detect project state and execute the right action
4
+ allowed-tools: [Read, Bash, Grep, Glob, Agent, AskUserQuestion]
10
5
  ---
11
- <objective>
12
- Auto-detect project state through deep context gathering, surface any problems, and dispatch to the appropriate MAXSIM command.
13
-
14
- **How it works:**
15
- 1. Gather deep context (project state, git status, recent commits, blockers)
16
- 2. Surface any problems and block until resolved
17
- 3. Show detection reasoning (what was found)
18
- 4. Act immediately by dispatching to the right command
19
6
 
20
- Show + Act pattern: display detection reasoning, then act. No arguments -- pure auto-detection. User can Ctrl+C if the detection is wrong.
7
+ <objective>
8
+ Auto-detect project state from GitHub and dispatch to the right action. No arguments — pure auto-detection. Show detection reasoning, enter Plan Mode, propose the action, then execute after user approval.
21
9
  </objective>
22
10
 
23
- <execution_context>
24
- @~/.claude/maxsim/workflows/go.md
25
- </execution_context>
11
+ <context>
12
+ GitHub is the sole source of truth. Read the GitHub Project Board, open Issues, and Milestones to determine current state. Do NOT read .planning/ files.
13
+
14
+ Detection priority:
15
+ 1. No CLAUDE.md or GitHub Milestone → init needed
16
+ 2. Active Milestone with no planned phase → plan next phase
17
+ 3. Active Milestone with planned phase not executed → execute that phase
18
+ 4. Open bug/issue labeled `bug` → debug workflow
19
+ 5. All phases done → offer milestone completion
20
+ </context>
26
21
 
27
22
  <process>
28
- Execute the go workflow from @~/.claude/maxsim/workflows/go.md end-to-end.
23
+ Follow @~/.claude/maxsim/workflows/go.md end-to-end.
24
+
25
+ 1. Read GitHub Project Board state via `gh` CLI
26
+ 2. Detect what's next using the priority list above
27
+ 3. Enter Plan Mode — show detection reasoning and proposed action
28
+ 4. Wait for user approval (Ctrl+C cancels)
29
+ 5. Execute approved action by spawning the appropriate Agent
29
30
  </process>
@@ -1,22 +1,13 @@
1
1
  ---
2
2
  name: maxsim:help
3
- description: Show MAXSIM command reference and usage guide
3
+ description: Show available MaxsimCLI commands and usage
4
+ allowed-tools: [Read]
4
5
  ---
5
- <objective>
6
- Display the complete MAXSIM command reference.
7
6
 
8
- Output ONLY the reference content below. Do NOT add:
9
- - Project-specific analysis
10
- - Git status or file context
11
- - Next-step suggestions
12
- - Any commentary beyond the reference
7
+ <objective>
8
+ Display the complete MaxsimCLI command reference. Output ONLY the reference content — no project analysis, no git status, no commentary.
13
9
  </objective>
14
10
 
15
- <execution_context>
16
- @~/.claude/maxsim/workflows/help.md
17
- </execution_context>
18
-
19
11
  <process>
20
- Output the complete MAXSIM command reference from @~/.claude/maxsim/workflows/help.md.
21
- Display directly -- no additions or modifications.
12
+ Output the command reference from @~/.claude/maxsim/workflows/help.md directly. No additions or modifications.
22
13
  </process>
@@ -1,52 +1,30 @@
1
1
  ---
2
2
  name: maxsim:init
3
- description: Initialize a new project or manage milestone lifecycle
3
+ description: Initialize MaxsimCLI in current project with GitHub integration
4
4
  argument-hint: "[--auto]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Write
9
- - Task
10
- - AskUserQuestion
11
- - Glob
12
- - Grep
13
- - WebFetch
14
- - mcp__context7__resolve-library-id
15
- - mcp__context7__get-library-docs
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, AskUserQuestion, WebFetch]
16
6
  ---
17
- <context>
18
- **Flags:**
19
- - `--auto` -- Automatic mode. After config questions, runs the appropriate flow without further interaction. For new projects, expects idea document via @ reference.
20
- </context>
21
7
 
22
8
  <objective>
23
- Unified project initialization. Detects whether this is a new project, existing project, or milestone lifecycle and routes to the appropriate workflow.
9
+ Initialize MaxsimCLI for the current project. Scans the repo, interviews the user, sets up GitHub Milestone and Project Board, writes CLAUDE.md, and optionally generates a Roadmap.
10
+ </objective>
24
11
 
25
- **Creates (depending on scenario):**
26
- - `.planning/PROJECT.md` -- project context
27
- - `.planning/config.json` -- workflow preferences
28
- - `.planning/REQUIREMENTS.md` -- scoped requirements
29
- - `.planning/ROADMAP.md` -- phase structure
30
- - `.planning/STATE.md` -- project memory
31
- - `.planning/DECISIONS.md` -- key decisions with rationale
32
- - `.planning/ACCEPTANCE-CRITERIA.md` -- measurable success criteria
33
- - `.planning/NO-GOS.md` -- explicit exclusions and anti-patterns
34
- - `.planning/codebase/` -- codebase analysis (existing projects only)
35
- - `.planning/research/` -- domain research (optional)
12
+ <context>
13
+ Arguments: $ARGUMENTS
36
14
 
37
- **After this command:** Run `/maxsim:plan 1` to start phase planning.
38
- </objective>
15
+ Flags:
16
+ - `--auto` — Skip confirmations after config questions. For new projects, expects an idea document via @ reference.
39
17
 
40
- <execution_context>
41
- @~/.claude/maxsim/workflows/init.md
42
- @~/.claude/maxsim/references/questioning.md
43
- @~/.claude/maxsim/references/thinking-partner.md
44
- @~/.claude/maxsim/references/ui-brand.md
45
- @~/.claude/maxsim/templates/project.md
46
- @~/.claude/maxsim/templates/requirements.md
47
- </execution_context>
18
+ GitHub is the sole source of truth. Init creates GitHub Milestones and Issues — no .planning/ files.
19
+ </context>
48
20
 
49
21
  <process>
50
- Execute the init workflow from @~/.claude/maxsim/workflows/init.md end-to-end.
51
- Pass $ARGUMENTS through to the workflow for flag handling (--auto).
22
+ Follow @~/.claude/maxsim/workflows/init.md end-to-end.
23
+
24
+ 1. Scan repo structure (language, framework, existing CI)
25
+ 2. Interview user: project goal, scope, constraints, success criteria
26
+ 3. Create GitHub Milestone for this project/version
27
+ 4. Write CLAUDE.md with project context and MaxsimCLI config
28
+ 5. Optionally generate Roadmap as GitHub Issues (phases)
29
+ 6. Confirm setup and suggest `/maxsim:plan 1` as next step
52
30
  </process>
@@ -1,50 +1,35 @@
1
1
  ---
2
2
  name: maxsim:plan
3
- description: State-machine plan command Discussion, Research, Planning stages with gate confirmations
4
- argument-hint: "[phase-number] [--force-research] [--skip-verify]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - Task
12
- - WebFetch
13
- - mcp__context7__*
3
+ description: Plan a specific phase with discussion, research, and task breakdown
4
+ argument-hint: "<phase-number> [--force-research] [--skip-verify]"
5
+ allowed-tools: [Read, Write, Bash, Grep, Glob, Agent, AskUserQuestion, WebFetch]
14
6
  ---
15
- <objective>
16
- Execute the plan state machine: Discussion -> Research -> Planning. Each stage produces artifacts, shows a gate summary, and waits for user confirmation before advancing.
17
-
18
- **How it works:**
19
- 1. Detect current stage from phase artifacts (CONTEXT.md, RESEARCH.md, PLAN.md)
20
- 2. Start at the earliest incomplete stage
21
- 3. Run each stage via dedicated sub-workflow
22
- 4. Show rich gate summary after each stage — wait for user confirmation
23
- 5. Advance to next stage on confirmation
24
7
 
25
- **Re-entry:** If phase is already planned, show status and offer options (view, re-plan, execute).
26
-
27
- **Flags:**
28
- - `--force-research` — Re-run research even if RESEARCH.md exists
29
- - `--skip-verify` — Skip plan verification loop after planning stage
8
+ <objective>
9
+ Run the plan state machine for a phase: Discussion → Research → Planning. Each stage produces GitHub Issues/comments as artifacts, shows a gate summary, and waits for confirmation before advancing.
30
10
  </objective>
31
11
 
32
- <execution_context>
33
- @~/.claude/maxsim/workflows/plan.md
34
- @~/.claude/maxsim/references/ui-brand.md
35
- </execution_context>
36
-
37
12
  <context>
38
- Phase number: $ARGUMENTS (optional — auto-detects next unplanned phase if omitted)
13
+ Arguments: $ARGUMENTS
14
+
15
+ Phase number is required. Auto-detects next unplanned phase if omitted.
16
+
17
+ Flags:
18
+ - `--force-research` — Re-run research even if research notes already exist on the GitHub Issue
19
+ - `--skip-verify` — Skip plan verification loop after the planning stage
39
20
 
40
- **Flags:**
41
- - `--force-research` — Re-run research even if RESEARCH.md exists
42
- - `--skip-verify` — Skip plan verification loop after planning stage
21
+ GitHub is the sole source of truth. Stage state is read from GitHub Issue labels and comments — no .planning/ files.
43
22
 
44
- Context files are resolved inside the workflow via `maxsim-tools init plan-phase` and per-subagent context assembly.
23
+ Re-entry: If phase is already planned, show status and offer options (view, re-plan, execute).
45
24
  </context>
46
25
 
47
26
  <process>
48
- Execute the plan workflow from @~/.claude/maxsim/workflows/plan.md end-to-end.
49
- Preserve all workflow gates (stage detection, discussion, research, planning, gate confirmations, re-entry flow).
27
+ Follow @~/.claude/maxsim/workflows/plan.md end-to-end.
28
+
29
+ 1. Detect current stage from GitHub Issue labels on the phase Issue
30
+ 2. Start at earliest incomplete stage
31
+ 3. Discussion stage: clarify scope with user via AskUserQuestion
32
+ 4. Research stage: spawn Agent for domain/codebase research (skipped if notes exist and no --force-research)
33
+ 5. Planning stage: spawn Agent to break phase into task Issues with acceptance criteria
34
+ 6. Show gate summary after each stage — wait for confirmation before advancing
50
35
  </process>
@@ -1,25 +1,24 @@
1
1
  ---
2
2
  name: maxsim:progress
3
- description: Check project progress, milestone status, and route to next action
4
- allowed-tools:
5
- - Read
6
- - Bash
7
- - Grep
8
- - Glob
9
- - Task
10
- - SlashCommand
3
+ description: Show project status from GitHub Project Board with next-action recommendation
4
+ allowed-tools: [Read, Bash, Grep, Glob]
11
5
  ---
12
- <objective>
13
- Check project progress, milestone status, and offer milestone completion when all phases are done. Shows GitHub Issues-based progress alongside local ROADMAP.md progress for cross-validation.
14
6
 
15
- Provides situational awareness before continuing work, detects phase gaps, and intelligently routes to the next action.
7
+ <objective>
8
+ Show current project progress from GitHub and recommend the next action. Provides situational awareness, detects gaps, and routes to the appropriate next command.
16
9
  </objective>
17
10
 
18
- <execution_context>
19
- @~/.claude/maxsim/workflows/progress.md
20
- </execution_context>
11
+ <context>
12
+ GitHub is the sole source of truth. Read the GitHub Project Board, Milestone progress, and open Issues to build the status view — no .planning/ or ROADMAP.md files.
13
+ </context>
21
14
 
22
15
  <process>
23
- Execute the progress workflow from @~/.claude/maxsim/workflows/progress.md end-to-end.
24
- Preserve all routing logic (Routes A through F) and edge case handling.
16
+ Follow @~/.claude/maxsim/workflows/progress.md end-to-end.
17
+
18
+ 1. Read active GitHub Milestone and its completion percentage
19
+ 2. Read GitHub Project Board columns to get phase/task states
20
+ 3. List open Issues by label (bug, quick, debug, blocked)
21
+ 4. Render a status table: phases with planned/executed/verified state
22
+ 5. Detect gaps (planned but not executed, executed but not verified)
23
+ 6. Recommend next action with the exact command to run
25
24
  </process>
@@ -1,41 +1,30 @@
1
1
  ---
2
2
  name: maxsim:quick
3
- description: Execute a quick task with MAXSIM guarantees
4
- argument-hint: "[--full]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Glob
10
- - Grep
11
- - Bash
12
- - Task
13
- - AskUserQuestion
3
+ description: Quick task - create GitHub Issue and execute in simplified flow
4
+ argument-hint: "[task description]"
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, AskUserQuestion]
14
6
  ---
15
- <objective>
16
- Execute small, ad-hoc tasks with MAXSIM guarantees (atomic commits, STATE.md tracking).
17
-
18
- Quick mode is the same system with a shorter path:
19
- - Spawns planner (quick mode) + executor(s)
20
- - Quick tasks are tracked via GitHub Issues (label: "quick"), separate from planned phases
21
- - Updates STATE.md "Quick Tasks Completed" table (NOT ROADMAP.md)
22
7
 
23
- **Default:** Skips research, plan-checker, verifier. Use when you know exactly what to do.
24
-
25
- **`--full` flag:** Enables plan-checking (max 2 iterations) and post-execution verification. Use when you want quality guarantees without full milestone ceremony.
8
+ <objective>
9
+ Execute small, ad-hoc tasks with MaxsimCLI guarantees (atomic commits, GitHub tracking). Skips research, plan-checker, and verifier by default for speed.
26
10
  </objective>
27
11
 
28
- <execution_context>
29
- @~/.claude/maxsim/workflows/quick.md
30
- </execution_context>
31
-
32
12
  <context>
33
- $ARGUMENTS
13
+ Arguments: $ARGUMENTS
14
+
15
+ If $ARGUMENTS is provided, treat it as the task description.
34
16
 
35
- Context files are resolved inside the workflow (`init quick`) and delegated via `<files_to_read>` blocks.
17
+ Quick tasks are tracked as GitHub Issues (label: `quick`) separate from planned phase Issues. GitHub is the sole source of truth — no STATE.md or .planning/ files.
36
18
  </context>
37
19
 
38
20
  <process>
39
- Execute the quick workflow from @~/.claude/maxsim/workflows/quick.md end-to-end.
40
- Preserve all workflow gates (validation, task description, planning, execution, state updates, commits).
21
+ Follow @~/.claude/maxsim/workflows/quick.md end-to-end.
22
+
23
+ 1. Get task description from $ARGUMENTS or via AskUserQuestion
24
+ 2. Clarify scope if ambiguous (one focused question)
25
+ 3. Create a GitHub Issue labeled `quick` for the task
26
+ 4. Spawn a planner Agent (quick mode) to produce a concise implementation plan
27
+ 5. Spawn executor Agent(s) to implement the plan
28
+ 6. Commit with atomic message referencing the GitHub Issue
29
+ 7. Close the GitHub Issue with completion summary
41
30
  </process>
@@ -1,37 +1,29 @@
1
1
  ---
2
2
  name: maxsim:settings
3
- description: Configure MAXSIM workflow toggles and model profile
4
- allowed-tools:
5
- - Read
6
- - Write
7
- - Bash
8
- - AskUserQuestion
3
+ description: View and modify MaxsimCLI configuration
4
+ allowed-tools: [Read, Write, Edit, Bash, AskUserQuestion]
9
5
  ---
10
6
 
11
7
  <objective>
12
- Interactive configuration of MAXSIM workflow agents, model profile, and pipeline settings via multi-question prompt. Includes integrated profile management with model assignment details per tier.
13
-
14
- Routes to the settings workflow which handles:
15
- - Config existence ensuring
16
- - Current settings reading and parsing
17
- - Interactive prompt (model profile, research, plan_checker, verifier, auto-advance, nyquist, branching)
18
- - Profile description showing actual model assignments per profile tier
19
- - Config merging and writing
20
- - Confirmation display
8
+ Interactively view and modify MaxsimCLI configuration: model profile, pipeline toggles (research, plan-checker, verifier, auto-advance), and branching strategy.
21
9
  </objective>
22
10
 
23
- <execution_context>
24
- @~/.claude/maxsim/workflows/settings.md
25
- </execution_context>
11
+ <context>
12
+ Configuration is stored in CLAUDE.md (project-level) and `~/.claude/maxsim/config.json` (global). Present current values as pre-selections in each prompt.
13
+ </context>
26
14
 
27
15
  <process>
28
- **Follow the settings workflow** from `@~/.claude/maxsim/workflows/settings.md`.
16
+ Follow @~/.claude/maxsim/workflows/settings.md end-to-end.
29
17
 
30
- The workflow handles all logic including:
31
- 1. Config file creation with defaults if missing
32
- 2. Current config reading
33
- 3. Interactive settings presentation with pre-selection
34
- 4. Answer parsing and config merging
35
- 5. File writing
36
- 6. Confirmation display
18
+ 1. Read current config from CLAUDE.md and `~/.claude/maxsim/config.json`
19
+ 2. Display current settings with descriptions
20
+ 3. Use AskUserQuestion to interactively configure:
21
+ - Model profile (with per-tier model assignment details)
22
+ - Research stage enabled/disabled
23
+ - Plan-checker enabled/disabled
24
+ - Verifier enabled/disabled
25
+ - Auto-advance between stages
26
+ - Branching strategy (per-phase / per-task / none)
27
+ 4. Merge answers and write updated config
28
+ 5. Display confirmation of saved settings
37
29
  </process>