autodev

autodev is a global Claude Code plugin for one job: keep durable context in the repo, execute one bounded slice of work at a time, and stay honest about verification.

This reset removes the old workflow tree, multi-agent prompt theater, and markdown state machine. The new design is smaller on purpose.

Core Behavior

• Installs globally into ~/.claude
• Forces CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 in Claude Code settings.json
• Uses /autodev as the main entrypoint
• Uses /autodev-status for a compact state view
• Keeps durable project context in .autodev/
• Blocks git write commands while allowing read-only git
• Auto-formats edited code when the repo already has a local formatter
• Stops when verification is missing instead of pretending the work is done

Durable Files

autodev keeps a small, inspectable file set in the repo:

• .autodev/state.json Machine state. This is the only authoritative state file.
• .autodev/brief.md Goal, constraints, users, and definition of done.
• .autodev/context.md Optional brownfield snapshot for the current goal.
• .autodev/plan.md One active plan with 3-7 items.
• .autodev/runs/*.md Append-only run reports with observed facts and verification results.

Install

Supported mode is global install only.

npx @mthanhlm/autodev@latest

Equivalent explicit form:

npx @mthanhlm/autodev@latest --global

Uninstall:

npx @mthanhlm/autodev@latest --uninstall

Commands

/autodev
/autodev-status

Typical brownfield flow:

/autodev
  -> write brief.md
  -> write context.md
  -> write plan.md
  -> execute one item
  -> verify it
  -> append a run report
  -> stop or continue from state.json later

Trust Rules

• state.json is machine truth and is updated through the CLI, not by hand.
• The plugin should not claim a task is done without observed verification output or explicit manual confirmation from the user.
• If a check could not be run, the result is Unverified, not Done.
• If the plan is blocked, update the remaining plan instead of expanding the system around the blockage.

Git Policy

Blocked:

• git add
• git commit
• git checkout
• git switch
• git merge
• git rebase
• git push
• git pull
• git stash
• git reset
• git fetch
• git clone

Allowed examples:

• git status
• git diff
• git log
• git show
• git rev-parse
• git ls-files
• git branch --show-current

Publish

Release steps are in PUBLISH.md.