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.
- package/README.md +316 -288
- package/dist/assets/CHANGELOG.md +14 -0
- package/dist/assets/hooks/maxsim-capture-learnings.cjs +128 -0
- package/dist/assets/hooks/maxsim-capture-learnings.cjs.map +1 -0
- package/dist/assets/hooks/maxsim-check-update.cjs +126 -88
- package/dist/assets/hooks/maxsim-check-update.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-notification-sound.cjs +87 -43
- package/dist/assets/hooks/maxsim-notification-sound.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-statusline.cjs +45 -171
- package/dist/assets/hooks/maxsim-statusline.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-stop-sound.cjs +86 -43
- package/dist/assets/hooks/maxsim-stop-sound.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-sync-reminder.cjs +72 -21
- package/dist/assets/hooks/maxsim-sync-reminder.cjs.map +1 -1
- package/dist/assets/templates/agents/AGENTS.md +62 -51
- package/dist/assets/templates/agents/executor.md +44 -59
- package/dist/assets/templates/agents/planner.md +36 -31
- package/dist/assets/templates/agents/researcher.md +35 -43
- package/dist/assets/templates/agents/verifier.md +29 -31
- package/dist/assets/templates/commands/maxsim/debug.md +20 -154
- package/dist/assets/templates/commands/maxsim/execute.md +19 -33
- package/dist/assets/templates/commands/maxsim/go.md +21 -20
- package/dist/assets/templates/commands/maxsim/help.md +5 -14
- package/dist/assets/templates/commands/maxsim/init.md +18 -40
- package/dist/assets/templates/commands/maxsim/plan.md +22 -37
- package/dist/assets/templates/commands/maxsim/progress.md +15 -16
- package/dist/assets/templates/commands/maxsim/quick.md +18 -29
- package/dist/assets/templates/commands/maxsim/settings.md +18 -26
- package/dist/assets/templates/references/continuation-format.md +2 -4
- package/dist/assets/templates/references/model-profiles.md +2 -2
- package/dist/assets/templates/references/planning-config.md +10 -11
- package/dist/assets/templates/references/self-improvement.md +120 -0
- package/dist/assets/templates/rules/conventions.md +1 -1
- package/dist/assets/templates/rules/verification-protocol.md +1 -1
- package/dist/assets/templates/skills/brainstorming/SKILL.md +35 -26
- package/dist/assets/templates/skills/code-review/SKILL.md +78 -55
- package/dist/assets/templates/skills/commit-conventions/SKILL.md +70 -36
- package/dist/assets/templates/skills/github-operations/SKILL.md +142 -0
- package/dist/assets/templates/skills/handoff-contract/SKILL.md +62 -28
- package/dist/assets/templates/skills/maxsim-batch/SKILL.md +68 -42
- package/dist/assets/templates/skills/maxsim-simplify/SKILL.md +65 -40
- package/dist/assets/templates/skills/project-memory/SKILL.md +121 -0
- package/dist/assets/templates/skills/research/SKILL.md +126 -0
- package/dist/assets/templates/skills/roadmap-writing/SKILL.md +71 -68
- package/dist/assets/templates/skills/systematic-debugging/SKILL.md +37 -25
- package/dist/assets/templates/skills/tdd/SKILL.md +36 -39
- package/dist/assets/templates/skills/using-maxsim/SKILL.md +69 -55
- package/dist/assets/templates/skills/verification/SKILL.md +167 -0
- package/dist/assets/templates/workflows/batch.md +249 -268
- package/dist/assets/templates/workflows/diagnose-issues.md +225 -151
- package/dist/assets/templates/workflows/execute-plan.md +191 -981
- package/dist/assets/templates/workflows/execute.md +350 -309
- package/dist/assets/templates/workflows/go.md +119 -138
- package/dist/assets/templates/workflows/health.md +71 -114
- package/dist/assets/templates/workflows/help.md +85 -147
- package/dist/assets/templates/workflows/init-existing.md +180 -1373
- package/dist/assets/templates/workflows/init.md +53 -165
- package/dist/assets/templates/workflows/new-milestone.md +91 -334
- package/dist/assets/templates/workflows/new-project.md +165 -1384
- package/dist/assets/templates/workflows/plan-create.md +182 -73
- package/dist/assets/templates/workflows/plan-discuss.md +89 -82
- package/dist/assets/templates/workflows/plan-research.md +191 -85
- package/dist/assets/templates/workflows/plan.md +122 -58
- package/dist/assets/templates/workflows/progress.md +76 -310
- package/dist/assets/templates/workflows/quick.md +70 -495
- package/dist/assets/templates/workflows/sdd.md +231 -221
- package/dist/assets/templates/workflows/settings.md +90 -120
- package/dist/assets/templates/workflows/verify-phase.md +296 -258
- package/dist/cli.cjs +17 -23465
- package/dist/cli.cjs.map +1 -1
- package/dist/install.cjs +356 -8358
- package/dist/install.cjs.map +1 -1
- package/package.json +16 -22
- package/dist/assets/templates/skills/agent-system-map/SKILL.md +0 -92
- package/dist/assets/templates/skills/evidence-collection/SKILL.md +0 -87
- package/dist/assets/templates/skills/github-artifact-protocol/SKILL.md +0 -67
- package/dist/assets/templates/skills/github-tools-guide/SKILL.md +0 -89
- package/dist/assets/templates/skills/input-validation/SKILL.md +0 -51
- package/dist/assets/templates/skills/memory-management/SKILL.md +0 -75
- package/dist/assets/templates/skills/research-methodology/SKILL.md +0 -137
- package/dist/assets/templates/skills/sdd/SKILL.md +0 -91
- package/dist/assets/templates/skills/tool-priority-guide/SKILL.md +0 -80
- package/dist/assets/templates/skills/verification-before-completion/SKILL.md +0 -71
- package/dist/assets/templates/skills/verification-gates/SKILL.md +0 -169
- package/dist/assets/templates/workflows/discuss-phase.md +0 -683
- package/dist/assets/templates/workflows/research-phase.md +0 -73
- package/dist/assets/templates/workflows/verify-work.md +0 -572
- package/dist/core-D5zUr9cb.cjs +0 -4305
- package/dist/core-D5zUr9cb.cjs.map +0 -1
- package/dist/skills-CjFWZIGM.cjs +0 -6824
- package/dist/skills-CjFWZIGM.cjs.map +0 -1
|
@@ -1,167 +1,33 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: maxsim:debug
|
|
3
|
-
description: Systematic debugging with
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
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
|
|
4
|
-
argument-hint: "<phase-number>
|
|
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
|
-
|
|
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
|
-
|
|
13
|
+
Arguments: $ARGUMENTS
|
|
14
|
+
|
|
15
|
+
Phase number is required (e.g., `/maxsim:execute 3`).
|
|
38
16
|
|
|
39
|
-
|
|
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
|
-
|
|
44
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
<
|
|
24
|
-
|
|
25
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
9
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
26
|
-
|
|
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
|
-
|
|
38
|
-
|
|
15
|
+
Flags:
|
|
16
|
+
- `--auto` — Skip confirmations after config questions. For new projects, expects an idea document via @ reference.
|
|
39
17
|
|
|
40
|
-
|
|
41
|
-
|
|
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
|
-
|
|
51
|
-
|
|
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:
|
|
4
|
-
argument-hint: "
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
49
|
-
|
|
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:
|
|
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
|
-
|
|
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
|
-
<
|
|
19
|
-
|
|
20
|
-
</
|
|
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
|
-
|
|
24
|
-
|
|
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:
|
|
4
|
-
argument-hint: "[
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
40
|
-
|
|
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:
|
|
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
|
-
|
|
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
|
-
<
|
|
24
|
-
|
|
25
|
-
</
|
|
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
|
-
|
|
16
|
+
Follow @~/.claude/maxsim/workflows/settings.md end-to-end.
|
|
29
17
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
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>
|