@mthanhlm/autodev 0.1.0

package/autodev/workflows/help.md

@@ -0,0 +1,57 @@
+# autodev
+
+Lean Claude Code workflow. No automatic commits. No branches. No worktrees. Git is read-only.
+
+## Commands
+
+- `/autodev-new-project`
+  Creates `.autodev/PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, and `config.json`.
+- `/autodev-plan-phase [phase]`
+  Creates or revises one phase plan in `.autodev/phases/NN-name/NN-PLAN.md`.
+- `/autodev-execute-phase [phase]`
+  Executes one phase plan sequentially and writes `NN-SUMMARY.md`.
+- `/autodev-verify-work [phase]`
+  Records manual verification in `NN-UAT.md`.
+- `/autodev-progress`
+  Shows the current project status and next command.
+- `/autodev-help`
+  Shows this reference.
+
+## Default Flow
+
+```text
+/autodev-new-project
+/autodev-plan-phase 1
+/autodev-execute-phase 1
+/autodev-verify-work 1
+/autodev-progress
+```
+
+## Git Policy
+
+Allowed:
+
+- `git status`
+- `git diff`
+- `git log`
+- `git show`
+- `git rev-parse`
+- `git ls-files`
+- `git branch --show-current`
+
+Blocked:
+
+- `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`
+- `git clone`

package/autodev/workflows/new-project.md

@@ -0,0 +1,62 @@
+<purpose>
+Initialize `.autodev/` with the minimum useful project context. Prefer fast clarity over exhaustive ceremonies.
+</purpose>
+
+<rules>
+- 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`.
+- Git is read-only only.
+- Use concise questioning. Ask only for details that materially change requirements or roadmap.
+</rules>
+
+<process>
+1. Run:
+
+```bash
+node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init new-project
+```
+
+2. If `.autodev/PROJECT.md` already exists, stop and tell the user to use `/autodev-progress`.
+
+3. If the current prompt does not provide enough information to write a real roadmap, ask a short set of questions to lock:
+   - the product outcome
+   - the primary user
+   - any hard constraints
+
+4. Read the templates from the execution context.
+
+5. Create `.autodev/config.json` from the template with these defaults unless the user explicitly asks otherwise:
+   - `workflow.research: false`
+   - `execution.parallel: false`
+   - `git.mode: "read-only"`
+
+6. Write `.autodev/PROJECT.md` with:
+   - one-line summary
+   - problem
+   - users
+   - success criteria
+   - constraints
+   - non-goals
+
+7. Write `.autodev/REQUIREMENTS.md` with clear must-have requirements and acceptance bullets.
+
+8. Write `.autodev/ROADMAP.md` with 3-8 phases using this exact heading format:
+
+```text
+## Phase N: Name
+```
+
+Each phase must include:
+   - `Status: pending`
+   - `Goal: ...`
+   - `Deliverables:`
+   - `Risks:`
+
+9. Write `.autodev/STATE.md` with:
+   - `Current Phase: 1`
+   - `Current Step: planning`
+   - `Status: active`
+   - `Next Command: /autodev-plan-phase 1`
+   - current ISO timestamp
+
+10. End with a short summary and direct the user to `/autodev-plan-phase 1`.
+</process>

package/autodev/workflows/plan-phase.md

@@ -0,0 +1,54 @@
+<purpose>
+Create one practical phase plan. Keep it concrete, small enough to execute, and free of git-write steps.
+</purpose>
+
+<rules>
+- One plan file per phase: `NN-PLAN.md`.
+- Prefer direct action over deep orchestration.
+- Optional research is allowed only when the user asks for it or `workflow.research` is true.
+- Never include git write commands in the plan.
+</rules>
+
+<process>
+1. Run:
+
+```bash
+node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init plan-phase "$ARGUMENTS"
+```
+
+2. If `.autodev/ROADMAP.md` does not exist, stop and tell the user to run `/autodev-new-project`.
+
+3. If no phase is found, tell the user all phases already have plans and show `/autodev-progress`.
+
+4. Read:
+   - `.autodev/PROJECT.md`
+   - `.autodev/REQUIREMENTS.md`
+   - `.autodev/ROADMAP.md`
+   - `.autodev/STATE.md`
+   - the target phase section
+   - any existing code relevant to this phase
+
+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.
+
+6. Create the phase directory if missing:
+
+```text
+.autodev/phases/NN-name/
+```
+
+7. Write or replace `NN-PLAN.md` from the template. The plan must include:
+   - goal
+   - concrete implementation steps
+   - likely files to touch
+   - verification commands
+   - manual checks
+   - explicit git read-only reminder
+
+8. Update `.autodev/STATE.md` so it points to:
+   - `Current Phase: N`
+   - `Current Step: planned`
+   - `Next Command: /autodev-execute-phase N`
+   - current ISO timestamp
+
+9. End with a short summary and direct the user to `/autodev-execute-phase N`.
+</process>

package/autodev/workflows/progress.md

@@ -0,0 +1,15 @@
+<purpose>
+Render the current autodev status with no extra ceremony.
+</purpose>
+
+<process>
+1. Run:
+
+```bash
+node "$HOME/.claude/autodev/bin/autodev-tools.cjs" progress table
+```
+
+2. Output the table directly.
+
+3. If a project exists, add one short line after the table with the next recommended command.
+</process>

package/autodev/workflows/verify-work.md

@@ -0,0 +1,39 @@
+<purpose>
+Run lightweight user acceptance testing and keep the next action obvious.
+</purpose>
+
+<rules>
+- Verify against what the phase plan and summary claim.
+- Keep the interaction concise and test-oriented.
+- Do not auto-generate a new plan unless a real gap appears.
+</rules>
+
+<process>
+1. Run:
+
+```bash
+node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init verify-work "$ARGUMENTS"
+```
+
+2. If no executed phase is found, stop and direct the user to `/autodev-execute-phase`.
+
+3. Read:
+   - `NN-PLAN.md`
+   - `NN-SUMMARY.md`
+   - relevant code or UI files
+
+4. Present a short manual verification flow. Keep it one check at a time when user input is needed.
+
+5. Write or update `NN-UAT.md` from the template with:
+   - test cases
+   - results
+   - bugs or follow-up
+   - recommended next step
+
+6. Update `.autodev/STATE.md`:
+   - if verification passed, move to the next phase and set `Next Command` to `/autodev-plan-phase <next>`
+   - if verification failed, keep the same phase active and set `Next Command` to `/autodev-execute-phase N`
+   - always refresh the ISO timestamp
+
+7. End with the verification result and the next command.
+</process>