@mthanhlm/autodev 0.2.0 → 0.2.1

package/PUBLISH.md

@@ -26,7 +26,7 @@ npm pack
 Check the tarball contents:
 
 ```bash
-tar -tf mthanhlm-autodev-0.2.0.tgz
+tar -tf mthanhlm-autodev-0.2.1.tgz
 ```
 
 ## First Public Publish

package/autodev/bin/autodev-tools.cjs

@@ -328,7 +328,8 @@ function buildRoute(cwd) {
   if (!projectExists) {
     return {
       kind: 'init_project',
-      command: '/autodev-new-project',
+      command: '/autodev',
+      manualCommand: '/autodev-new-project',
       reason: existingCodebase ? 'existing_code_detected_without_project_state' : 'project_state_missing',
       projectType
     };
@@ -337,7 +338,8 @@ function buildRoute(cwd) {
   if (projectType === 'brownfield' && !codebaseMapExists) {
     return {
       kind: 'explore_codebase',
-      command: '/autodev-explore-codebase',
+      command: '/autodev',
+      manualCommand: '/autodev-explore-codebase',
       reason: 'brownfield_project_needs_codebase_map',
       projectType
     };
@@ -347,6 +349,7 @@ function buildRoute(cwd) {
     return {
       kind: 'track_select',
       command: '/autodev',
+      manualCommand: null,
       reason: tracks.length > 0 ? 'no_active_track_selected' : 'no_tracks_created',
       projectType
     };
@@ -357,6 +360,7 @@ function buildRoute(cwd) {
     return {
       kind: 'track_setup',
       command: '/autodev',
+      manualCommand: null,
       reason: 'active_track_missing_required_artifacts',
       projectType,
       trackSlug: activeTrack
@@ -368,6 +372,7 @@ function buildRoute(cwd) {
     return {
       kind: 'track_setup',
       command: '/autodev',
+      manualCommand: null,
       reason: 'active_track_has_no_phases',
       projectType,
       trackSlug: activeTrack
@@ -378,7 +383,8 @@ function buildRoute(cwd) {
   if (nextReview && config.workflow.review_after_execute !== false) {
     return {
       kind: 'review_phase',
-      command: `/autodev-review-phase ${nextReview.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-review-phase ${nextReview.number}`,
       reason: 'phase_executed_but_not_reviewed',
       projectType,
       trackSlug: activeTrack,
@@ -390,7 +396,8 @@ function buildRoute(cwd) {
   if (nextVerify) {
     return {
       kind: 'verify_phase',
-      command: `/autodev-verify-work ${nextVerify.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-verify-work ${nextVerify.number}`,
       reason: 'phase_reviewed_but_not_verified',
       projectType,
       trackSlug: activeTrack,
@@ -402,7 +409,8 @@ function buildRoute(cwd) {
   if (nextExecute) {
     return {
       kind: 'execute_phase',
-      command: `/autodev-execute-phase ${nextExecute.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-execute-phase ${nextExecute.number}`,
       reason: 'phase_planned_but_not_executed',
       projectType,
       trackSlug: activeTrack,
@@ -414,7 +422,8 @@ function buildRoute(cwd) {
   if (nextPlan) {
     return {
       kind: 'plan_phase',
-      command: `/autodev-plan-phase ${nextPlan.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-plan-phase ${nextPlan.number}`,
       reason: 'phase_not_planned',
       projectType,
       trackSlug: activeTrack,
@@ -424,7 +433,8 @@ function buildRoute(cwd) {
 
   return {
     kind: 'track_complete',
-    command: '/autodev-cleanup',
+    command: '/autodev',
+    manualCommand: '/autodev-cleanup',
     reason: 'active_track_fully_verified',
     projectType,
     trackSlug: activeTrack
@@ -460,7 +470,8 @@ function buildProgress(cwd) {
       verified: phases.filter(phase => phase.uatExists).length
     },
     route,
-    nextCommand: route.command
+    nextCommand: route.command,
+    manualNextCommand: route.manualCommand || null
   };
 }
 
@@ -482,10 +493,11 @@ function renderProgressTable(progress) {
     `Reviewed: ${progress.counts.reviewed}`,
     `Verified: ${progress.counts.verified}`,
     `Next: ${progress.route.command}`,
+    progress.route.manualCommand ? `Manual Shortcut: ${progress.route.manualCommand}` : null,
     '',
     '| Phase | Type | Name | Plan | Summary | Review | UAT | Status |',
     '| --- | --- | --- | --- | --- | --- | --- | --- |'
-  ];
+  ].filter(Boolean);
 
   for (const phase of progress.phases) {
     lines.push(

package/autodev/workflows/autodev.md

@@ -27,7 +27,9 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
    - `review_phase`: perform the review-phase workflow.
    - `verify_phase`: perform the verify-work workflow.
 
-4. If the route is `track_select` or `track_setup`, handle it directly:
+4. Do not stop after identifying a brownfield codebase route. If the route is `explore_codebase`, perform the exploration as part of the same `/autodev` run instead of telling the user to switch commands.
+
+5. If the route is `track_select` or `track_setup`, handle it directly:
    - If tracks exist, ask whether to continue one of them or create a new track.
    - If no tracks exist, ask only for the current initiative name, desired outcome, and likely phase types.
    - Create or repair:
@@ -45,18 +47,18 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
 
    - After track setup, continue in the same turn by re-running the route logic mentally and executing the next step.
 
-5. If the route is `track_complete`, ask whether the user wants to:
+6. If the route is `track_complete`, ask whether the user wants to:
    - start a new track
    - run cleanup
    - stop here
 
-6. When the user chooses a new track at step 5, create it immediately and continue routing in the same turn.
+7. When the user chooses a new track at step 6, create it immediately and continue routing in the same turn.
 
-7. Every time you finish a routed step, keep both project-level and track-level state aligned. Default the state files to `Next Command: /autodev`.
+8. Every time you finish a routed step, keep both project-level and track-level state aligned. Default the state files to `Next Command: /autodev`.
 
-8. End with:
+9. End with:
    - what step you completed
    - the current route reason in plain language
    - `/autodev` as the default next command
-   - the matching manual shortcut when useful
+   - the matching manual shortcut only as an optional escape hatch
 </process>

package/autodev/workflows/explore-codebase.md

@@ -53,5 +53,5 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init explore-codebase
    - the biggest structural insight
    - the biggest risk
    - `/autodev` as the next command
-   - `/autodev-plan-phase <n>` as the manual shortcut when obvious
+   - `/autodev-plan-phase <n>` only as the optional manual shortcut when obvious
 </process>

package/autodev/workflows/new-project.md

@@ -83,7 +83,7 @@ Each phase must include:
    - `Next Command: /autodev`
    - current ISO timestamp
 
-13. If the project is brownfield, do not fake a codebase map. Leave that for `/autodev-explore-codebase`, and make that the default next step. Otherwise, the next step is planning phase 1.
+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`.
 
 14. End with a short summary and direct the user to `/autodev`. Mention the manual shortcut only if useful.
 </process>

package/autodev/workflows/progress.md

@@ -13,5 +13,5 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" progress table
 
 3. If a project exists, add one short line after the table with:
    - `/autodev` as the default next command
-   - the routed manual shortcut from the table when useful
+   - the routed manual shortcut from the table only when useful
 </process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mthanhlm/autodev",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A lean Claude Code workflow system with a single entrypoint, brownfield codebase mapping, and read-only git.",
   "bin": {
     "autodev": "bin/install.js"