@mthanhlm/autodev 0.3.3 → 0.3.5

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "autodev",
+  "description": "A lean Claude Code workflow system with a single entrypoint, task-based phase execution, and read-only git.",
+  "version": "0.3.5",
+  "author": {
+    "name": "mthanhlm"
+  },
+  "license": "MIT"
+}

package/PUBLISH.md

@@ -20,6 +20,7 @@ npm whoami
 ```bash
 cd autodev
 npm test
+claude plugin validate .
 npm pack
 ```
 
@@ -73,3 +74,9 @@ Open Claude Code in that directory and run:
 ```text
 /autodev-help
 ```
+
+Optional source-tree check during development:
+
+```bash
+claude --plugin-dir . agents
+```

package/README.md

@@ -4,7 +4,7 @@
 
 ## What It Does
 
-- Installs a small Claude Code workflow under `~/.claude/` or `./.claude/`
+- Installs a standalone Claude Code workflow under `~/.claude/` or `./.claude/`
 - Keeps project state in `.autodev/`
 - Uses `/autodev` as the main command
 - Organizes work as `project -> track -> phase -> tasks`
@@ -24,6 +24,9 @@
 
 ## Install
 
+Primary supported usage is the standalone `npx` installer.
+The repo also carries Claude Code plugin metadata for validation and local development, but the supported end-user runtime remains the installed `.claude/` workflow.
+
 ```bash
 npx @mthanhlm/autodev@latest --global
 ```
@@ -60,6 +63,7 @@ Typical brownfield route:
   -> new project
   -> explore codebase
   -> plan phase
+  -> review phase plan
   -> execute next task
   -> execute next task
   -> review
@@ -92,6 +96,7 @@ project -> track -> phase -> tasks
 
 - `/autodev` remains the single entrypoint
 - A phase is planned into one phase overview plus multiple task files
+- `/autodev` stops after planning so the user can review the phase before any execution starts
 - The phase keeps one user-facing orchestration session
 - Each task is preferably executed by a fresh worker agent in the background
 - After each task, the worker reports back with files changed, verification, and blockers

package/agents/autodev-codebase-domain.md

@@ -1,3 +1,10 @@
+---
+name: autodev-codebase-domain
+description: Product and domain mapper for brownfield exploration. Use proactively when mapping an existing codebase and writing `.autodev/codebase/domain.md`.
+tools: Read, Grep, Glob, Bash, Write
+model: inherit
+---
+
 # autodev-codebase-domain
 
 You are responsible for `.autodev/codebase/domain.md`.

package/agents/autodev-codebase-quality.md

@@ -1,3 +1,10 @@
+---
+name: autodev-codebase-quality
+description: Testing and technical-debt mapper for brownfield exploration. Use proactively when mapping an existing codebase and writing `.autodev/codebase/quality.md`.
+tools: Read, Grep, Glob, Bash, Write
+model: inherit
+---
+
 # autodev-codebase-quality
 
 You are responsible for `.autodev/codebase/quality.md`.

package/agents/autodev-codebase-runtime.md

@@ -1,3 +1,10 @@
+---
+name: autodev-codebase-runtime
+description: Runtime and dependency mapper for brownfield exploration. Use proactively when mapping an existing codebase and writing `.autodev/codebase/runtime.md`.
+tools: Read, Grep, Glob, Bash, Write
+model: inherit
+---
+
 # autodev-codebase-runtime
 
 You are responsible for `.autodev/codebase/runtime.md`.

package/agents/autodev-codebase-structure.md

@@ -1,3 +1,10 @@
+---
+name: autodev-codebase-structure
+description: Repository structure mapper for brownfield exploration. Use proactively when mapping an existing codebase and writing `.autodev/codebase/structure.md`.
+tools: Read, Grep, Glob, Bash, Write
+model: inherit
+---
+
 # autodev-codebase-structure
 
 You are responsible for `.autodev/codebase/structure.md`.

package/agents/autodev-review-integration.md

@@ -1,3 +1,10 @@
+---
+name: autodev-review-integration
+description: Integration review specialist for executed phases. Use proactively after code changes to find cross-module regressions and wiring mistakes.
+tools: Read, Grep, Glob, Bash
+model: inherit
+---
+
 # autodev-review-integration
 
 Review the executed phase for integration and regression risk.

package/agents/autodev-review-polish.md

@@ -1,3 +1,10 @@
+---
+name: autodev-review-polish
+description: Product polish review specialist for executed phases. Use proactively after code changes to find rough UX, copy, and finish issues.
+tools: Read, Grep, Glob, Bash
+model: inherit
+---
+
 # autodev-review-polish
 
 Review the executed phase for product polish and obvious AI-generated roughness.

package/agents/autodev-review-quality.md

@@ -1,3 +1,10 @@
+---
+name: autodev-review-quality
+description: Quality review specialist for executed phases. Use proactively after code changes to find correctness, maintainability, and test issues.
+tools: Read, Grep, Glob, Bash
+model: inherit
+---
+
 # autodev-review-quality
 
 Review the executed phase for code quality.

package/agents/autodev-review-security.md

@@ -1,3 +1,10 @@
+---
+name: autodev-review-security
+description: Security review specialist for executed phases. Use proactively after code changes to find auth, input-handling, and trust-boundary issues.
+tools: Read, Grep, Glob, Bash
+model: inherit
+---
+
 # autodev-review-security
 
 Review the executed phase for security and misuse risks.

package/agents/autodev-task-worker.md

@@ -1,3 +1,10 @@
+---
+name: autodev-task-worker
+description: Single-task implementation worker for autodev phases. Use proactively when one `.autodev` task should run in a fresh agent context and produce its matching `TASK-NN-SUMMARY.md`.
+tools: Read, Grep, Glob, Bash, Edit, Write
+model: inherit
+---
+
 # autodev-task-worker
 
 Execute one assigned task inside the current phase and report back to the main phase session.

package/autodev/bin/autodev-tools.cjs

@@ -507,16 +507,16 @@ function buildRoute(cwd) {
     };
   }
 
-  const nextExecute = phases.find(phase => phase.planExists && !phase.summaryExists);
-  if (nextExecute) {
+  const nextPlannedReview = phases.find(phase => phase.planExists && !phase.summaryExists);
+  if (nextPlannedReview) {
     return {
-      kind: 'execute_phase',
+      kind: 'plan_review',
       command: '/autodev',
-      manualCommand: `/autodev-execute-phase ${nextExecute.number}`,
-      reason: 'phase_planned_but_not_executed',
+      manualCommand: `/autodev-execute-phase ${nextPlannedReview.number}`,
+      reason: 'phase_planned_awaiting_user_review',
       projectType,
       trackSlug: activeTrack,
-      phaseNumber: nextExecute.number
+      phaseNumber: nextPlannedReview.number
     };
   }
 
@@ -702,7 +702,15 @@ function initPayload(cwd, mode, requestedPhase) {
   const activeTrack = readActiveTrack(cwd);
   const tracks = listTracks(cwd);
   const track = trackPaths(cwd, activeTrack);
-  const phaseMode = mode === 'review-phase' ? 'review' : mode === 'verify-work' ? 'verify' : mode === 'execute-phase' ? 'execute' : mode === 'plan-phase' ? 'plan' : null;
+  const phaseMode = mode === 'review-phase'
+    ? 'review'
+    : mode === 'verify-work'
+      ? 'verify'
+      : mode === 'execute-phase' || mode === 'review-plan'
+        ? 'execute'
+        : mode === 'plan-phase'
+          ? 'plan'
+          : null;
   const phase = phaseMode && activeTrack ? resolvePhase(cwd, activeTrack, requestedPhase, phaseMode) : null;
   const tasks = phase ? listTasksForPhaseDetails(phase) : [];
   const nextTask = nextExecutableTask(tasks);

package/autodev/workflows/autodev.md

@@ -15,18 +15,20 @@ Use `/autodev` as the single entrypoint for the normal workflow. Route automatic
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" status
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" status
 ```
 
 2. Inspect the returned `route.kind`, `project_type`, `tracks`, and active track data.
 
 3. Route as follows:
-   - `init_project`: read `@~/.claude/autodev/workflows/new-project.md`, then perform that workflow.
-   - `explore_codebase`: read `@~/.claude/autodev/workflows/explore-codebase.md`, then perform that workflow.
-   - `plan_phase`: read `@~/.claude/autodev/workflows/plan-phase.md`, then perform that workflow.
-   - `execute_phase`: read `@~/.claude/autodev/workflows/execute-phase.md`, then perform that workflow, which should advance one task-sized unit in the current phase session by trying a fresh task worker first and falling back cleanly when delegation is unavailable.
-   - `review_phase`: read `@~/.claude/autodev/workflows/review-phase.md`, then perform that workflow.
-   - `verify_phase`: read `@~/.claude/autodev/workflows/verify-work.md`, then perform that workflow.
+   - `init_project`: load and perform the new-project workflow.
+   - `explore_codebase`: load and perform the explore-codebase workflow.
+   - `plan_phase`: load and perform the plan-phase workflow.
+   - `plan_review`: load and perform the review-plan workflow so the user can review the phase plan before any execution starts.
+   - `execute_phase`: load and perform the execute-phase workflow, which should advance one task-sized unit in the current phase session by trying a fresh worker agent first and falling back cleanly when agent delegation is unavailable.
+   - `review_phase`: load and perform the review-phase workflow.
+   - `verify_phase`: load and perform the verify-work workflow.
 
 4. Read only the workflow file needed for the selected route. Do not load the others "just in case".
 

package/autodev/workflows/cleanup.md

@@ -13,7 +13,8 @@ Clean or archive autodev state without flags. Prefer preserving useful project c
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" cleanup
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" cleanup
 ```
 
 2. If no `.autodev/` project exists, stop and say there is nothing to clean.

package/autodev/workflows/execute-phase.md

@@ -9,8 +9,8 @@ Execute an active-track phase through task-sized worker runs, keep the main sess
 - Execute one task at a time by default.
 - Do not use waves.
 - Prefer a fresh background worker for each task so the phase session does not bloat.
-- If the `Task` tool is available and specialized agents are supported in this environment, delegate task implementation.
-- If a delegation attempt fails with an environment limitation like `specialized agents aren't available`, treat delegation as unavailable for this run and continue cleanly.
+- If agent delegation is available in this environment, delegate task implementation.
+- If a delegation attempt fails with an environment limitation like `specialized agents aren't available`, treat agent delegation as unavailable for this run and continue cleanly.
 - The main phase session should remain orchestration-focused whenever delegation works.
 - The main phase session may update `.autodev/` state and aggregate phase artifacts.
 </rules>
@@ -19,7 +19,8 @@ Execute an active-track phase through task-sized worker runs, keep the main sess
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init execute-phase "$ARGUMENTS"
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init execute-phase "$ARGUMENTS"
 ```
 
 2. If no phase is found or the plan file is missing, stop and direct the user to `/autodev-plan-phase`.
@@ -48,8 +49,12 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init execute-phase "$ARGUMENT
    - verification plan
    - any dependency note
 
-7. If the `Task` tool is available, first try to spawn one fresh background worker using `autodev-task-worker` for the selected task.
-   Tell it:
+7. If agent delegation is available, explicitly call the `Agent` tool and select the installed task-worker subagent for the selected task.
+   Use:
+   - `autodev-task-worker` when autodev is installed into `.claude/`
+   - `autodev:autodev-task-worker` only when this workflow is being run directly from a plugin directory
+
+   Tell the subagent:
    - phase path
    - task path
    - summary path to write
@@ -60,7 +65,7 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init execute-phase "$ARGUMENT
 
 8. If worker delegation is unavailable, do not stop on the raw platform message.
    Treat messages like `specialized agents aren't available` as a capability limitation, then:
-   - tell the user plainly that background task workers are unavailable in this environment
+   - tell the user plainly that worker-agent delegation is unavailable in this environment
    - continue with the same task in the current session
    - keep the same task boundaries
    - still write the task summary before moving on

package/autodev/workflows/explore-codebase.md

@@ -13,7 +13,8 @@ Map a brownfield repository quickly and produce a usable codebase brief without
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init explore-codebase
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init explore-codebase
 ```
 
 2. If no project exists, stop and tell the user to use `/autodev` or `/autodev-new-project`.
@@ -25,11 +26,11 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init explore-codebase
    - the active track docs if they exist
    - representative repo files needed to orient the exploration
 
-4. If specialized agents are available, spawn four parallel agents with these owned outputs:
-   - `autodev-codebase-structure` owns `.autodev/codebase/structure.md`
-   - `autodev-codebase-domain` owns `.autodev/codebase/domain.md`
-   - `autodev-codebase-runtime` owns `.autodev/codebase/runtime.md`
-   - `autodev-codebase-quality` owns `.autodev/codebase/quality.md`
+4. If specialized agents are available, explicitly call the `Agent` tool four times with these installed subagents and owned outputs:
+   - `autodev-codebase-structure` for standalone installs, or `autodev:autodev-codebase-structure` in direct plugin runs, owns `.autodev/codebase/structure.md`
+   - `autodev-codebase-domain` for standalone installs, or `autodev:autodev-codebase-domain` in direct plugin runs, owns `.autodev/codebase/domain.md`
+   - `autodev-codebase-runtime` for standalone installs, or `autodev:autodev-codebase-runtime` in direct plugin runs, owns `.autodev/codebase/runtime.md`
+   - `autodev-codebase-quality` for standalone installs, or `autodev:autodev-codebase-quality` in direct plugin runs, owns `.autodev/codebase/quality.md`
 
 5. Tell each agent:
    - it is not alone in the codebase

package/autodev/workflows/help.md

@@ -5,7 +5,7 @@ Lean Claude Code workflow. No automatic commits. No branches. No worktrees. Git
 ## Main Entry
 
 - `/autodev`
-  The normal command. It routes automatically through project setup, codebase mapping, planning, execution, review, verification, and cleanup.
+  The normal command. It routes automatically through project setup, codebase mapping, planning, plan review, execution, review, verification, and cleanup.
 
 ## Manual Commands
 
@@ -18,7 +18,7 @@ Lean Claude Code workflow. No automatic commits. No branches. No worktrees. Git
 - `/autodev-plan-phase [phase]`
   Creates or revises one phase plan plus task files in `.autodev/tracks/<track>/phases/NN-type-name/`.
 - `/autodev-execute-phase [phase]`
-  Orchestrates one phase task-by-task, preferring a fresh worker per task, and writes `TASK-NN-SUMMARY.md` plus the final `NN-SUMMARY.md`.
+  Orchestrates one phase task-by-task, preferring a fresh worker agent per task, and writes `TASK-NN-SUMMARY.md` plus the final `NN-SUMMARY.md`.
 - `/autodev-review-phase [phase]`
   Uses four review agents when available for code quality, security, integration, and polish, then writes `NN-REVIEW.md`.
 - `/autodev-verify-work [phase]`
@@ -56,6 +56,7 @@ Typical brownfield route:
   -> new project
   -> explore codebase
   -> plan
+  -> review plan
   -> execute
   -> review
   -> verify

package/autodev/workflows/new-project.md

@@ -13,7 +13,8 @@ Initialize `.autodev/` with useful project-level context, then create the first
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init new-project
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init new-project
 ```
 
 2. If `.autodev/PROJECT.md` already exists, stop and tell the user to use `/autodev`.

package/autodev/workflows/plan-phase.md

@@ -15,7 +15,8 @@ Create one practical phase plan for the active track, then break it into reviewa
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init plan-phase "$ARGUMENTS"
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init plan-phase "$ARGUMENTS"
 ```
 
 2. If there is no active track or no roadmap for it, stop and tell the user to run `/autodev`.
@@ -77,19 +78,23 @@ Each task file must include:
 9. Update the active track `STATE.md` so it points to:
    - `Current Phase: N`
    - `Current Phase Type: <type>`
-   - `Current Step: planned`
+   - `Current Step: plan_review`
    - `Current Task: 01` if tasks exist, otherwise `none`
-   - `Current Task Status: ready`
+   - `Current Task Status: pending_review`
    - `Next Command: /autodev`
    - current ISO timestamp
 
 10. Update `.autodev/STATE.md` so it points to:
    - `Active Track: <slug>`
-   - `Current Step: planned`
+   - `Current Step: plan_review`
    - `Current Task: 01` if tasks exist, otherwise `none`
-   - `Current Task Status: ready`
+   - `Current Task Status: pending_review`
    - `Next Command: /autodev`
    - current ISO timestamp
 
-11. End with a short summary and direct the user to `/autodev`. Mention `/autodev-execute-phase N` as the manual shortcut.
+11. End with a short summary and stop for review.
+   Tell the user:
+   - the plan and task files are ready for review
+   - `/autodev` will open the review checkpoint before any execution starts
+   - `/autodev-execute-phase N` is only the optional manual bypass after review
 </process>

package/autodev/workflows/progress.md

@@ -6,7 +6,8 @@ Render the current autodev status with no extra ceremony.
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" progress table
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" progress table
 ```
 
 2. Output the table directly.

package/autodev/workflows/review-phase.md

@@ -13,7 +13,8 @@ Run the automatic review bundle after execution so the user sees code quality, s
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init review-phase "$ARGUMENTS"
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init review-phase "$ARGUMENTS"
 ```
 
 2. If no executed phase is found, stop and direct the user to `/autodev-execute-phase`.
@@ -27,11 +28,11 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init review-phase "$ARGUMENTS
    - `NN-SUMMARY.md`
    - relevant source files and tests
 
-4. If specialized agents are available, spawn four parallel review agents:
-   - `autodev-review-quality`
-   - `autodev-review-security`
-   - `autodev-review-integration`
-   - `autodev-review-polish`
+4. If specialized agents are available, explicitly call the `Agent` tool four times with these installed review subagents:
+   - `autodev-review-quality` for standalone installs, or `autodev:autodev-review-quality` in direct plugin runs
+   - `autodev-review-security` for standalone installs, or `autodev:autodev-review-security` in direct plugin runs
+   - `autodev-review-integration` for standalone installs, or `autodev:autodev-review-integration` in direct plugin runs
+   - `autodev-review-polish` for standalone installs, or `autodev:autodev-review-polish` in direct plugin runs
 
 5. Tell each review agent:
    - it is not alone in the codebase

package/autodev/workflows/review-plan.md

@@ -0,0 +1,54 @@
+<purpose>
+Pause after phase planning so the user can review the generated plan and task breakdown before any execution starts.
+</purpose>
+
+<rules>
+- Do not start task execution automatically from a freshly created plan.
+- Keep this as a control checkpoint for the user.
+- Do not edit repository code in this step unless the user explicitly chooses to revise the plan.
+- Prefer `/autodev` as the entrypoint even at this checkpoint.
+</rules>
+
+<process>
+1. Run:
+
+```bash
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init review-plan "$ARGUMENTS"
+```
+
+2. If no planned phase is found, stop and direct the user to `/autodev`.
+
+3. Read:
+   - `.autodev/STATE.md`
+   - the active track `STATE.md`
+   - `NN-PLAN.md`
+   - all `TASK-*.md`
+
+4. Show the user a concise review summary:
+   - phase id and phase goal
+   - task list with dependencies
+   - likely files or areas to change
+   - shared verification plan
+
+5. Ask the user what to do next with `AskUserQuestion`:
+   - execute the next task now
+   - revise the phase plan
+   - stop here
+
+6. If the user chooses to execute now:
+   - load the execute-phase workflow
+   - perform it in the same turn
+
+7. If the user chooses to revise the plan:
+   - load the plan-phase workflow
+   - revise the same phase in the same turn
+
+8. If the user chooses to stop here:
+   - keep both state files on:
+     - `Current Step: plan_review`
+     - `Next Command: /autodev`
+   - end with a short note that execution has not started yet
+
+9. End with a short outcome summary and `/autodev` as the default next command.
+</process>

package/autodev/workflows/verify-work.md

@@ -12,7 +12,8 @@ Run lightweight user acceptance testing after review and keep the next action ob
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init verify-work "$ARGUMENTS"
+AUTODEV_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+node "$AUTODEV_ROOT/autodev/bin/autodev-tools.cjs" init verify-work "$ARGUMENTS"
 ```
 
 2. If no reviewed phase is found, stop and direct the user to `/autodev-review-phase`.

package/bin/install.js

@@ -13,6 +13,7 @@ const reset = '\x1b[0m';
 const MANAGED_PREFIX = 'autodev-';
 const ROOT_COMMAND = 'autodev';
 const HOOK_FILES = [
+  'hooks.json',
   'autodev-context-monitor.js',
   'autodev-git-guard.js',
   'autodev-phase-boundary.sh',

package/commands/autodev/execute-phase.md

@@ -11,7 +11,7 @@ allowed-tools:
   - Glob
   - TodoWrite
   - AskUserQuestion
-  - Task
+  - Agent
 ---
 <objective>
 Execute one active-track phase through task-sized worker runs and record both task-level and phase-level summaries.

package/commands/autodev/explore-codebase.md

@@ -9,7 +9,7 @@ allowed-tools:
   - Grep
   - Glob
   - AskUserQuestion
-  - Task
+  - Agent
 ---
 <objective>
 Explore the current repository, use parallel codebase agents when available, and write the brownfield map into `.autodev/codebase/`.

package/commands/autodev/index.md

@@ -11,7 +11,7 @@ allowed-tools:
   - Glob
   - TodoWrite
   - AskUserQuestion
-  - Task
+  - Agent
   - WebFetch
 ---
 <objective>

package/commands/autodev/review-phase.md

@@ -9,7 +9,7 @@ allowed-tools:
   - Bash
   - Grep
   - Glob
-  - Task
+  - Agent
 ---
 <objective>
 Run the automatic review bundle for one executed phase and write a single review artifact.

package/hooks/hooks.json

@@ -0,0 +1,79 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-session-state.sh\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-prompt-guard.js\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-read-guard.js\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-workflow-guard.js\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-git-guard.js\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash|Edit|Write|MultiEdit|Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-context-monitor.js\"",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/autodev-phase-boundary.sh\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@mthanhlm/autodev",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "A lean Claude Code workflow system with a single entrypoint, task-based phase execution, and read-only git.",
   "bin": {
     "autodev": "bin/install.js"
   },
   "files": [
+    ".claude-plugin",
     "bin",
     "commands",
     "agents",