@mthanhlm/autodev 0.4.4 → 0.5.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 (75) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/PUBLISH.md +9 -40
  3. package/README.md +70 -104
  4. package/autodev/bin/autodev-tools.cjs +521 -990
  5. package/autodev/templates/brief.md +19 -0
  6. package/autodev/templates/context.md +16 -0
  7. package/autodev/templates/plan.md +26 -46
  8. package/autodev/templates/run.md +20 -0
  9. package/bin/install.js +219 -422
  10. package/commands/autodev/index.md +117 -9
  11. package/commands/autodev/status.md +22 -0
  12. package/hooks/autodev-auto-format.js +3 -3
  13. package/hooks/autodev-git-guard.js +5 -7
  14. package/hooks/autodev-paths.js +3 -3
  15. package/package.json +4 -5
  16. package/scripts/run-tests.cjs +10 -0
  17. package/agents/autodev-codebase-domain.md +0 -25
  18. package/agents/autodev-codebase-quality.md +0 -25
  19. package/agents/autodev-codebase-runtime.md +0 -25
  20. package/agents/autodev-codebase-structure.md +0 -25
  21. package/agents/autodev-review-integration.md +0 -30
  22. package/agents/autodev-review-polish.md +0 -30
  23. package/agents/autodev-review-quality.md +0 -30
  24. package/agents/autodev-review-security.md +0 -30
  25. package/agents/autodev-task-worker.md +0 -39
  26. package/autodev/templates/codebase/domain.md +0 -13
  27. package/autodev/templates/codebase/quality.md +0 -13
  28. package/autodev/templates/codebase/runtime.md +0 -13
  29. package/autodev/templates/codebase/structure.md +0 -13
  30. package/autodev/templates/codebase/summary.md +0 -13
  31. package/autodev/templates/config.json +0 -22
  32. package/autodev/templates/project-state.md +0 -15
  33. package/autodev/templates/project.md +0 -24
  34. package/autodev/templates/requirements.md +0 -14
  35. package/autodev/templates/review.md +0 -27
  36. package/autodev/templates/roadmap.md +0 -17
  37. package/autodev/templates/state.md +0 -15
  38. package/autodev/templates/summary.md +0 -22
  39. package/autodev/templates/task-summary.md +0 -18
  40. package/autodev/templates/task.md +0 -23
  41. package/autodev/templates/track-state.md +0 -16
  42. package/autodev/templates/track.md +0 -24
  43. package/autodev/templates/uat.md +0 -18
  44. package/autodev/workflows/autodev-auto.md +0 -62
  45. package/autodev/workflows/autodev.md +0 -83
  46. package/autodev/workflows/cleanup.md +0 -51
  47. package/autodev/workflows/execute-phase.md +0 -144
  48. package/autodev/workflows/explore-codebase.md +0 -70
  49. package/autodev/workflows/help.md +0 -113
  50. package/autodev/workflows/new-project.md +0 -108
  51. package/autodev/workflows/plan-phase.md +0 -134
  52. package/autodev/workflows/progress.md +0 -18
  53. package/autodev/workflows/review-phase.md +0 -80
  54. package/autodev/workflows/review-plan.md +0 -55
  55. package/autodev/workflows/review-task.md +0 -70
  56. package/autodev/workflows/verify-work.md +0 -71
  57. package/commands/autodev/auto.md +0 -27
  58. package/commands/autodev/cleanup.md +0 -23
  59. package/commands/autodev/execute-phase.md +0 -29
  60. package/commands/autodev/explore-codebase.md +0 -33
  61. package/commands/autodev/help.md +0 -18
  62. package/commands/autodev/new-project.md +0 -30
  63. package/commands/autodev/plan-phase.md +0 -26
  64. package/commands/autodev/progress.md +0 -18
  65. package/commands/autodev/review-phase.md +0 -29
  66. package/commands/autodev/review-task.md +0 -25
  67. package/commands/autodev/verify-work.md +0 -24
  68. package/hooks/autodev-context-monitor.js +0 -59
  69. package/hooks/autodev-phase-boundary.sh +0 -49
  70. package/hooks/autodev-prompt-guard.js +0 -78
  71. package/hooks/autodev-read-guard.js +0 -42
  72. package/hooks/autodev-session-state.sh +0 -51
  73. package/hooks/autodev-statusline.js +0 -83
  74. package/hooks/autodev-workflow-guard.js +0 -43
  75. package/hooks/hooks.json +0 -89
@@ -1,113 +0,0 @@
1
- # autodev
2
-
3
- Lean Claude Code workflow. No automatic commits. No branches. No worktrees. Git is read-only.
4
- It resolves `.autodev/` state from the repo root even when you start Claude in a nested subdirectory.
5
- It can auto-format edited code after writes when the repo already has a local formatter available.
6
- Supported runtime is Claude Code with Node plus `sh`/`bash` available.
7
-
8
- ## Main Entry
9
-
10
- - `/autodev`
11
- The default checkpointed command. It routes automatically through project setup, codebase mapping, planning, plan review, execution, review, verification, and cleanup.
12
- - `/autodev-auto`
13
- The explicit continuous mode. It keeps going until the track is done or a real stop condition appears, such as missing intent, dependency deadlock, retry-limit exhaustion, or manual verification.
14
-
15
- ## Manual Commands
16
-
17
- - `/autodev-help`
18
- Shows this reference.
19
- - `/autodev-new-project`
20
- Creates project state in `.autodev/` and the first active track under `.autodev/tracks/<track>/`.
21
- - `/autodev-explore-codebase`
22
- Uses foreground codebase agents, one at a time when available, to map a brownfield repo into `.autodev/codebase/`.
23
- - `/autodev-plan-phase [phase]`
24
- Creates or revises one phase plan plus task files in `.autodev/tracks/<track>/phases/NN-type-name/`.
25
- - `/autodev-execute-phase [phase]`
26
- Orchestrates exactly one task for the phase, preferring a fresh foreground delegated agent, and writes `TASK-NN-SUMMARY.md`.
27
- - `/autodev-review-task [phase]`
28
- Pauses after one completed task so the user can review the result before executing the next task or starting phase review.
29
- - `/autodev-review-phase [phase]`
30
- Uses foreground review agents, one at a time when available, for code quality, security, integration, and polish, then writes `NN-REVIEW.md`.
31
- - `/autodev-verify-work [phase]`
32
- Records manual verification in `NN-UAT.md` and captures fix-return gaps when verification fails.
33
- - `/autodev-progress`
34
- Shows project type, active track, phase status, and the next recommended route.
35
- - `/autodev-cleanup`
36
- Asks what to clean or archive. No flags required.
37
-
38
- ## Workflow Model
39
-
40
- ```text
41
- project -> track -> phase -> tasks
42
- ```
43
-
44
- - `project`
45
- Whole repo or product context.
46
- - `track`
47
- The current initiative, feature line, refactor, or bugfix stream.
48
- - `phase`
49
- Small milestone slices inside the active track.
50
- - `task`
51
- Reviewable execution units inside a phase.
52
-
53
- ## Blocker Recovery
54
-
55
- - Review or verification blockers should normally stay in the same phase.
56
- - Preserve completed task history.
57
- - Append `TASK-XX` remediation work to the same phase.
58
- - Only create a new phase when the blocker reveals genuinely new scope.
59
-
60
- ## Default Flow
61
-
62
- ```text
63
- /autodev
64
- ```
65
-
66
- Typical brownfield route:
67
-
68
- ```text
69
- /autodev
70
- -> new project
71
- -> explore codebase
72
- -> plan
73
- -> review plan
74
- -> execute
75
- -> review task
76
- -> execute
77
- -> review task
78
- -> review
79
- -> verify
80
- -> next track or cleanup
81
- ```
82
-
83
- ## Git Policy
84
-
85
- Allowed:
86
-
87
- - `git status`
88
- - `git diff`
89
- - `git log`
90
- - `git show`
91
- - `git rev-parse`
92
- - `git ls-files`
93
- - `git branch --show-current`
94
-
95
- Blocked:
96
-
97
- - `git init`
98
- - `git add`
99
- - `git commit`
100
- - `git checkout`
101
- - `git switch`
102
- - `git merge`
103
- - `git rebase`
104
- - `git worktree`
105
- - `git clean`
106
- - `git cherry-pick`
107
- - `git push`
108
- - `git pull`
109
- - `git stash`
110
- - `git reset`
111
- - `git fetch`
112
- - `git clone`
113
- - mutating `git branch`, `git tag`, and `git remote` commands
@@ -1,108 +0,0 @@
1
- <purpose>
2
- Initialize `.autodev/` with useful project-level context, then create the first active track. Prefer fast clarity over exhaustive ceremonies.
3
- </purpose>
4
-
5
- <rules>
6
- - Do not run `git init`, `git add`, `git commit`, `git checkout`, `git switch`, `git merge`, `git rebase`, `git worktree`, `git push`, `git pull`, `git stash`, `git reset`, `git fetch`, or `git clone`.
7
- - Git is read-only only.
8
- - Use concise questioning, but do a short discovery pass before writing project state.
9
- - Ask only for details that materially change requirements or roadmap.
10
- - Treat the repository as a `project`, then put the current initiative in a `track`.
11
- - If this workflow was entered from `/autodev-auto`, continue automatically only when the current prompt is specific enough to define the project and first track without guessing.
12
- </rules>
13
-
14
- <process>
15
- 1. Run:
16
-
17
- ```bash
18
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
19
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init new-project
20
- ```
21
-
22
- If this run came from `/autodev-auto`, append `--auto` to the same command.
23
-
24
- 2. If `.autodev/PROJECT.md` already exists, stop and tell the user to use `/autodev`.
25
-
26
- 3. Do a short discovery pass before writing project or track files.
27
- - If the current prompt is thin, ask for:
28
- - what the user wants to build or change right now
29
- - who it is for or what pain it solves
30
- - what done looks like for the first track
31
- - scope boundaries, constraints, and explicit non-goals that materially affect planning
32
- - whether this is greenfield or brownfield if ambiguous
33
- - Prefer one compact batch of questions over a long drip of follow-ups.
34
- - Reflect the understanding back in 2-5 bullets before writing files when the original request was vague.
35
-
36
- 4. Read the templates from the execution context.
37
-
38
- 5. Create `.autodev/config.json` from the template with these defaults unless the user explicitly asks otherwise:
39
- - `project.type: "greenfield"` or `"brownfield"`
40
- - `workflow.research: false`
41
- - `workflow.review_after_execute: true`
42
- - `git.mode: "read-only"`
43
- - `hooks.auto_format: true`
44
-
45
- 6. Write `.autodev/PROJECT.md` with:
46
- - one-line summary
47
- - project type
48
- - repo or product problem
49
- - current user goal or job to be done
50
- - users or operators
51
- - success criteria
52
- - constraints
53
- - non-goals
54
-
55
- 7. Create `.autodev/ACTIVE_TRACK` with a lowercase hyphenated slug for the first track.
56
-
57
- 8. Write `.autodev/STATE.md` with:
58
- - `Project Type: ...`
59
- - `Active Track: <slug>`
60
- - `Current Step: initialized`
61
- - `Current Task: none`
62
- - `Current Task Status: idle`
63
- - `Status: active`
64
- - `Run Mode: checkpointed` for `/autodev`, or `Run Mode: auto` for `/autodev-auto`
65
- - `Auto Retry Count: 0`
66
- - `Next Command: /autodev` for checkpointed mode, or `/autodev-auto` for auto mode
67
- - current ISO timestamp
68
-
69
- 9. Create `.autodev/tracks/<slug>/TRACK.md` with:
70
- - track name
71
- - type or workstream shape
72
- - why this track exists now
73
- - desired outcome and what done looks like
74
- - scope boundaries and explicit non-goals
75
- - known dependencies
76
- - brownfield notes if this is an existing repo
77
-
78
- 10. Write `.autodev/tracks/<slug>/REQUIREMENTS.md` with clear must-have requirements and acceptance bullets for the track only.
79
- Tie the acceptance bullets to the discovered outcome instead of placeholder implementation tasks.
80
-
81
- 11. Write `.autodev/tracks/<slug>/ROADMAP.md` with 2-8 phases using this exact heading format:
82
-
83
- ```text
84
- ## Phase N [type]: Name
85
- ```
86
-
87
- Each phase must include:
88
- - `Status: pending`
89
- - `Goal: ...`
90
- - `Deliverables:`
91
- - `Risks:`
92
-
93
- 12. Write `.autodev/tracks/<slug>/STATE.md` with:
94
- - `Current Phase: 1`
95
- - `Current Phase Type: <type>`
96
- - `Current Step: planning`
97
- - `Current Task: none`
98
- - `Current Task Status: idle`
99
- - `Status: active`
100
- - `Run Mode: checkpointed` for `/autodev`, or `Run Mode: auto` for `/autodev-auto`
101
- - `Auto Retry Count: 0`
102
- - `Next Command: /autodev` for checkpointed mode, or `/autodev-auto` for auto mode
103
- - current ISO timestamp
104
-
105
- 13. If the project is brownfield, do not fake a codebase map. Continue into codebase exploration inside `/autodev` by default. Mention `/autodev-explore-codebase` only as a manual shortcut. Otherwise, the next step is planning phase 1 through `/autodev`.
106
-
107
- 14. End with a short summary of what the user wants to build or change and direct the user to `/autodev`. Mention the manual shortcut only if useful.
108
- </process>
@@ -1,134 +0,0 @@
1
- <purpose>
2
- Create one practical phase plan for the active track, then break it into reviewable task files that are small enough for fresh foreground-agent execution.
3
- </purpose>
4
-
5
- <rules>
6
- - One plan file per phase: `NN-PLAN.md`.
7
- - Use task files as the execution unit.
8
- - Prefer direct action over deep orchestration.
9
- - Optional research is allowed only when the user asks for it or `workflow.research` is true.
10
- - Never include git write commands in the plan.
11
- - Do not use waves by default.
12
- - When revising a blocked phase, preserve the same phase, the same phase goal, and all completed task history.
13
- - In `/autodev-auto`, a freshly written or repaired plan should continue automatically unless the plan itself still depends on unresolved user intent.
14
- </rules>
15
-
16
- <process>
17
- 1. Run:
18
-
19
- ```bash
20
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
21
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init plan-phase "$ARGUMENTS"
22
- ```
23
-
24
- If this run came from `/autodev-auto`, append `--auto` to the same command.
25
-
26
- 2. If there is no active track or no roadmap for it, stop and tell the user to run `/autodev`.
27
-
28
- 3. If no phase is found, tell the user all phases already have plans and show `/autodev-progress`.
29
-
30
- 4. Read:
31
- - `.autodev/PROJECT.md`
32
- - `.autodev/STATE.md`
33
- - `.autodev/codebase/summary.md` if it exists
34
- - `.autodev/tracks/<active-track>/TRACK.md`
35
- - `.autodev/tracks/<active-track>/REQUIREMENTS.md`
36
- - `.autodev/tracks/<active-track>/ROADMAP.md`
37
- - `.autodev/tracks/<active-track>/STATE.md`
38
- - the target phase section
39
- - any existing `TASK-*.md`
40
- - any existing `TASK-*-SUMMARY.md`
41
- - `NN-REVIEW.md` if it exists
42
- - `NN-UAT.md` if it exists
43
- - any existing code relevant to this phase
44
-
45
- 5. If research is enabled or explicitly requested, do targeted read-only research only. Keep the output folded into the plan instead of producing a separate research artifact.
46
-
47
- 6. Create the phase directory if missing:
48
-
49
- ```text
50
- .autodev/tracks/<active-track>/phases/NN-type-name/
51
- ```
52
-
53
- 7. Write or update `NN-PLAN.md` from the template. The plan must include:
54
- - phase type
55
- - goal
56
- - shared verification commands
57
- - task list overview
58
- - explicit git read-only reminder
59
-
60
- 8. If this phase is being reopened because of `blocked_review`, `blocked_verification`, `blocked_dependencies`, or another blocker status:
61
- - keep the same phase directory and phase goal
62
- - do not create a new phase for ordinary blockers
63
- - do not delete or rewrite completed task summaries
64
- - do not renumber completed tasks
65
- - preserve already-completed task rows in the phase plan
66
- - append new remediation tasks after `last_task_number`
67
- - default to one appended remediation task when the blockers are tightly related
68
- - split into multiple appended remediation tasks only when the blockers are clearly separate
69
- - only rewrite still-pending tasks when that improves clarity
70
- - make the new task titles explicit, for example:
71
- - `TASK-03: Fix review blockers from 01-REVIEW.md`
72
- - `TASK-04: Fix verification gaps from 01-UAT.md`
73
-
74
- 9. Create or update task files in the same phase directory:
75
-
76
- ```text
77
- TASK-01.md
78
- TASK-02.md
79
- ...
80
- ```
81
-
82
- Each task should be:
83
- - small enough for one fresh delegated agent context
84
- - clear about likely files to touch
85
- - explicit about verification
86
- - reviewable as a standalone unit
87
- - sequential by default unless there is an obvious safe dependency split
88
-
89
- Each task file must include:
90
- - task title
91
- - `Status: pending`
92
- - `Depends On: ...`
93
- - goal
94
- - why it is separate
95
- - files likely to change
96
- - implementation notes
97
- - verification
98
- - done looks like
99
-
100
- 10. When revising a blocked phase:
101
- - point `Current Task` to the first still-pending executable task after the revision
102
- - if all existing tasks are completed and you add remediation work, `Current Task` should be the first newly appended fix task
103
- - never reset `Current Task` back to `01` just because the phase was replanned
104
-
105
- 11. Update the active track `STATE.md` so it points to:
106
- - `Current Phase: N`
107
- - `Current Phase Type: <type>`
108
- - `Current Step: plan_review`
109
- - `Current Task: <first-pending-task>` if tasks exist, otherwise `none`
110
- - `Current Task Status: pending_review`
111
- - `Run Mode: checkpointed` for `/autodev`, or `Run Mode: auto` for `/autodev-auto`
112
- - `Auto Retry Count: 0`
113
- - `Next Command: /autodev` for checkpointed mode, or `/autodev-auto` for auto mode
114
- - current ISO timestamp
115
-
116
- 12. Update `.autodev/STATE.md` so it points to:
117
- - `Active Track: <slug>`
118
- - `Current Step: plan_review`
119
- - `Current Task: <first-pending-task>` if tasks exist, otherwise `none`
120
- - `Current Task Status: pending_review`
121
- - `Run Mode: checkpointed` for `/autodev`, or `Run Mode: auto` for `/autodev-auto`
122
- - `Auto Retry Count: 0`
123
- - `Next Command: /autodev` for checkpointed mode, or `/autodev-auto` for auto mode
124
- - current ISO timestamp
125
-
126
- 13. End with a short summary and stop for review.
127
- Tell the user:
128
- - the plan and task files are ready for review
129
- - completed task history from the phase was preserved
130
- - any blocker remediation was added as appended task work inside the same phase
131
- - in checkpointed mode, `/autodev` will open the review checkpoint before any execution starts
132
- - in auto mode, `/autodev-auto` should continue directly into execution unless a real ambiguity remains
133
- - `/autodev-execute-phase N` is only the optional manual bypass after review
134
- </process>
@@ -1,18 +0,0 @@
1
- <purpose>
2
- Render the current autodev status with no extra ceremony.
3
- </purpose>
4
-
5
- <process>
6
- 1. Run:
7
-
8
- ```bash
9
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
10
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" progress table
11
- ```
12
-
13
- 2. Output the table directly.
14
-
15
- 3. If a project exists, add one short line after the table with:
16
- - `/autodev` as the default next command
17
- - the routed manual shortcut from the table only when useful
18
- </process>
@@ -1,80 +0,0 @@
1
- <purpose>
2
- Run the automatic review bundle after execution so the user sees code quality, security, integration, and polish risks before manual verification.
3
- </purpose>
4
-
5
- <rules>
6
- - Prefer a small set of foreground review agents, run one at a time, when agent delegation is available.
7
- - Review findings should be concrete and evidence-based.
8
- - Do not edit repository code in this step unless the user explicitly asks for fixes.
9
- - Write one consolidated review artifact for the phase.
10
- - In `/autodev-auto`, blockers should reopen the same phase automatically unless the auto retry limit has already been reached.
11
- </rules>
12
-
13
- <process>
14
- 1. Run:
15
-
16
- ```bash
17
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
18
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init review-phase "$ARGUMENTS"
19
- ```
20
-
21
- If this run came from `/autodev-auto`, append `--auto` to the same command.
22
-
23
- 2. If no executed phase is found, stop and direct the user to `/autodev-execute-phase`.
24
-
25
- 3. Read:
26
- - `.autodev/STATE.md`
27
- - the active track `STATE.md`
28
- - `NN-PLAN.md`
29
- - all `TASK-*.md`
30
- - all `TASK-*-SUMMARY.md`
31
- - `NN-SUMMARY.md`
32
- - relevant source files and tests
33
-
34
- 4. If agent delegation is available, explicitly call the `Agent` tool for these review subagents, one at a time in the foreground:
35
- - `autodev-review-quality` for standalone installs, or `autodev:autodev-review-quality` in direct plugin runs
36
- - `autodev-review-security` for standalone installs, or `autodev:autodev-review-security` in direct plugin runs
37
- - `autodev-review-integration` for standalone installs, or `autodev:autodev-review-integration` in direct plugin runs
38
- - `autodev-review-polish` for standalone installs, or `autodev:autodev-review-polish` in direct plugin runs
39
-
40
- 5. Tell each review agent:
41
- - it is not alone in the codebase
42
- - it should stay read-only and return findings only
43
- - it should focus on clear issues, not generic commentary
44
- - it should report severity, evidence, and suggested action
45
-
46
- 6. If agent delegation is unavailable, do not stop on the raw platform message.
47
- Treat messages like `specialized agents aren't available` as an environment limitation, tell the user review will continue in the current session, and perform the same review pass directly using the four lenses:
48
- - quality
49
- - security
50
- - integration
51
- - product polish
52
-
53
- 7. Synthesize the four agent responses, or the current-session four-lens review, into `NN-REVIEW.md` from the template with:
54
- - grouped findings
55
- - blockers vs non-blockers
56
- - what looks solid
57
- - a final recommendation
58
-
59
- 8. If blockers are found:
60
- - set project and track state back to `Current Step: planning`
61
- - set `Current Task: none`
62
- - set `Current Task Status: blocked_review`
63
- - keep `Run Mode` aligned to the current command
64
- - if this is `/autodev-auto`, increment `Auto Retry Count` by `1`
65
- - keep `Next Command` aligned to the current command
66
- - make the recommendation point back to revising the same phase with appended blocker-fix tasks
67
- - do not recommend creating a new phase for ordinary review blockers
68
- - preserve completed task history and phase goal
69
-
70
- 9. If blockers are not found:
71
- - set project and track state to `Current Step: verification`
72
- - reset `Auto Retry Count` to `0`
73
- - keep `Run Mode` aligned to the current command
74
- - keep `Next Command` aligned to the current command
75
-
76
- 10. End with a short review result:
77
- - ready for verification, or
78
- - return to execution
79
- - include the manual shortcut command
80
- </process>
@@ -1,55 +0,0 @@
1
- <purpose>
2
- Pause after phase planning so the user can review the generated plan and task breakdown before any execution starts.
3
- </purpose>
4
-
5
- <rules>
6
- - Do not start task execution automatically from a freshly created plan.
7
- - Keep this as a control checkpoint for the user.
8
- - Do not edit repository code in this step unless the user explicitly chooses to revise the plan.
9
- - Prefer `/autodev` as the entrypoint even at this checkpoint.
10
- </rules>
11
-
12
- <process>
13
- 1. Run:
14
-
15
- ```bash
16
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
17
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init review-plan "$ARGUMENTS"
18
- ```
19
-
20
- 2. If no planned phase is found, stop and direct the user to `/autodev`.
21
-
22
- 3. Read:
23
- - `.autodev/STATE.md`
24
- - the active track `STATE.md`
25
- - `NN-PLAN.md`
26
- - all `TASK-*.md`
27
-
28
- 4. Show the user a concise review summary:
29
- - phase id and phase goal
30
- - task list with dependencies
31
- - likely files or areas to change
32
- - shared verification plan
33
-
34
- 5. Ask the user what to do next with `AskUserQuestion`:
35
- - execute one task now
36
- - revise the phase plan
37
- - stop here
38
-
39
- 6. If the user chooses to execute now:
40
- - load the execute-phase workflow
41
- - perform exactly one task in the same turn
42
- - stop after that task completes
43
-
44
- 7. If the user chooses to revise the plan:
45
- - load the plan-phase workflow
46
- - revise the same phase in the same turn
47
-
48
- 8. If the user chooses to stop here:
49
- - keep both state files on:
50
- - `Current Step: plan_review`
51
- - `Next Command: /autodev`
52
- - end with a short note that execution has not started yet
53
-
54
- 9. End with a short outcome summary and `/autodev` as the default next command.
55
- </process>
@@ -1,70 +0,0 @@
1
- <purpose>
2
- Pause after one completed task so the user can review the outcome before more execution happens in the same phase.
3
- </purpose>
4
-
5
- <rules>
6
- - This is a control checkpoint, not an execution step.
7
- - Do not auto-run the next task from this checkpoint without explicit user approval.
8
- - Prefer `/autodev` as the entrypoint even at this checkpoint.
9
- - If all tasks are done, do not auto-start phase review without explicit user approval.
10
- </rules>
11
-
12
- <process>
13
- 1. Run:
14
-
15
- ```bash
16
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
17
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init review-task "$ARGUMENTS"
18
- ```
19
-
20
- 2. If no phase is found, stop and direct the user to `/autodev`.
21
-
22
- 3. Read:
23
- - `.autodev/STATE.md`
24
- - the active track `STATE.md`
25
- - `NN-PLAN.md`
26
- - all `TASK-*.md`
27
- - the current task summary from `current_task_summary_path`
28
- - if `Current Task` is missing or stale, infer the checkpoint task from the most recent existing `TASK-*-SUMMARY.md`
29
- - `NN-SUMMARY.md` if it exists
30
-
31
- 4. Show the user a concise checkpoint summary:
32
- - completed task id and title
33
- - what changed
34
- - verification run
35
- - blockers or open concerns
36
- - the next ready task, if any
37
-
38
- 5. If more tasks remain, ask the user what to do next with `AskUserQuestion`:
39
- - execute the next task now
40
- - revise the phase plan
41
- - stop here
42
-
43
- 6. If all tasks are done, ask the user what to do next with `AskUserQuestion`:
44
- - run phase review now
45
- - revise the phase plan
46
- - stop here
47
-
48
- 7. If the user chooses to execute the next task:
49
- - load the execute-phase workflow
50
- - perform exactly one task in the same turn
51
- - stop again after that task completes
52
-
53
- 8. If the user chooses to run phase review:
54
- - load the review-phase workflow
55
- - perform it in the same turn
56
-
57
- 9. If the user chooses to revise the plan:
58
- - load the plan-phase workflow
59
- - revise the same phase in the same turn
60
-
61
- 10. If the user chooses to stop here:
62
- - keep both state files on:
63
- - `Current Step: task_review`
64
- - `Current Task: <current-task>`
65
- - `Current Task Status: complete`
66
- - `Next Command: /autodev`
67
- - end with a short note that no further execution has started
68
-
69
- 11. End with a short outcome summary and `/autodev` as the default next command.
70
- </process>
@@ -1,71 +0,0 @@
1
- <purpose>
2
- Run lightweight user acceptance testing after review and keep the next action obvious, including a clean fix-return path when verification fails.
3
- </purpose>
4
-
5
- <rules>
6
- - Verify against what the phase plan, summary, and review claim.
7
- - Keep the interaction concise and test-oriented.
8
- - Do not auto-generate a new plan unless a real gap appears.
9
- - Verification failures should normally reopen the same phase with appended remediation tasks, not create a new phase.
10
- - In `/autodev-auto`, prefer fully automatable verification first and stop only when verification truly requires human observation or judgment.
11
- </rules>
12
-
13
- <process>
14
- 1. Run:
15
-
16
- ```bash
17
- AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
18
- node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init verify-work "$ARGUMENTS"
19
- ```
20
-
21
- If this run came from `/autodev-auto`, append `--auto` to the same command.
22
-
23
- 2. If no reviewed phase is found, stop and direct the user to `/autodev-review-phase`.
24
-
25
- 3. Read:
26
- - `NN-PLAN.md`
27
- - all `TASK-*.md`
28
- - all `TASK-*-SUMMARY.md`
29
- - `NN-SUMMARY.md`
30
- - `NN-REVIEW.md`
31
- - relevant code or UI files
32
-
33
- 4. Choose the verification lane:
34
- - If the phase can be verified with concrete commands or deterministic checks that do not require human observation, run those checks directly.
35
- - If the phase still depends on visual inspection, human judgment, credentials the assistant does not have, or missing reproducible checks, stop and treat it as `needs_manual_verification`.
36
- - When user input is needed, present a short manual verification flow one check at a time.
37
-
38
- 5. Write or update `NN-UAT.md` from the template with:
39
- - test cases
40
- - results
41
- - bugs or follow-up
42
- - recommended next step
43
-
44
- 6. If verification fails, add a `Fix Return` section to `NN-UAT.md` with:
45
- - exact failed behaviors
46
- - reproduction notes
47
- - the smallest acceptable fix target
48
- - a note that the follow-up should be appended to the same phase as remediation task work unless scope truly changed
49
-
50
- 7. Update the active track `STATE.md`:
51
- - if verification passed and another phase remains, move to the next phase and set `Current Step: planning`
52
- - if verification passed and no phase remains, set `Current Step: complete`
53
- - if verification failed, keep the same phase active and set `Current Step: planning`
54
- - when moving to another phase, set `Current Task: none` and `Current Task Status: idle`
55
- - when verification failed, set `Current Task: none` and `Current Task Status: blocked_verification`
56
- - keep `Run Mode` aligned to the current command
57
- - reset `Auto Retry Count` to `0` on success, or increment it by `1` for `/autodev-auto` verification failures
58
- - always set `Next Command` aligned to the current command
59
- - always refresh the ISO timestamp
60
- - when verification failed, the next planning pass should preserve completed tasks and append remediation tasks to the same phase
61
-
62
- 8. Update `.autodev/STATE.md` with the matching project-level status and refreshed timestamp.
63
-
64
- 9. In `/autodev-auto`, if verification cannot be completed without human judgment:
65
- - stop instead of guessing
66
- - keep the current phase active
67
- - tell the user this pause reason is `needs_manual_verification`
68
- - recommend `/autodev` for manual verification or `/autodev-auto` again after the missing checks are made automatable
69
-
70
- 10. End with the verification result and the next command. Mention the manual shortcut only if it helps.
71
- </process>
@@ -1,27 +0,0 @@
1
- ---
2
- name: autodev:auto
3
- description: Run autodev continuously until blocked, manual verification is required, or the active track is done
4
- argument-hint: "[goal, track, or question]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Bash
10
- - Grep
11
- - Glob
12
- - TodoWrite
13
- - AskUserQuestion
14
- - Agent
15
- - WebFetch
16
- ---
17
- <objective>
18
- Use `/autodev-auto` as the explicit opt-in continuous runner. Keep going until the work is done or a real stop condition appears.
19
- </objective>
20
-
21
- <execution_context>
22
- @~/.claude/autodev/workflows/autodev-auto.md
23
- </execution_context>
24
-
25
- <process>
26
- Execute the auto router workflow in @~/.claude/autodev/workflows/autodev-auto.md end-to-end.
27
- </process>