@mthanhlm/autodev 0.1.1 → 0.2.0

package/PUBLISH.md

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

package/README.md

@@ -6,12 +6,19 @@
 
 - Installs a small Claude Code workflow under `~/.claude/` or `./.claude/`
 - Keeps project state in `.autodev/`
-- Ships six commands:
+- Uses `/autodev` as the main command
+- Organizes work as `project -> track -> phase`
+- Maps brownfield repos with four parallel codebase agents
+- Runs a four-agent review pass after execution
+- Ships manual commands when you want direct control:
   - `/autodev-help`
   - `/autodev-new-project`
+  - `/autodev-explore-codebase`
   - `/autodev-plan-phase`
   - `/autodev-execute-phase`
+  - `/autodev-review-phase`
   - `/autodev-verify-work`
+  - `/autodev-cleanup`
   - `/autodev-progress`
 - Treats git as read-only inside the workflow
 
@@ -43,11 +50,19 @@ npx @mthanhlm/autodev@latest --local --uninstall
 ## Default Flow
 
 ```text
-/autodev-new-project
-/autodev-plan-phase 1
-/autodev-execute-phase 1
-/autodev-verify-work 1
-/autodev-progress
+/autodev
+```
+
+Typical brownfield route:
+
+```text
+/autodev
+  -> new project
+  -> explore codebase
+  -> plan
+  -> execute
+  -> review
+  -> verify
 ```
 
 ## Git Policy

package/agents/autodev-codebase-domain.md

@@ -0,0 +1,16 @@
+# autodev-codebase-domain
+
+You are responsible for `.autodev/codebase/domain.md`.
+
+## Goal
+- Explain the main product areas, user flows, and state boundaries that matter for the active track.
+
+## Rules
+- You are not alone in the codebase.
+- Do not overwrite files owned by other agents.
+- Stay read-only except for your owned output file.
+- Avoid generic architecture commentary.
+
+## Output
+- Write only `.autodev/codebase/domain.md`.
+- Cover main product areas, key flows, data boundaries, and active-track impact.

package/agents/autodev-codebase-quality.md

@@ -0,0 +1,16 @@
+# autodev-codebase-quality
+
+You are responsible for `.autodev/codebase/quality.md`.
+
+## Goal
+- Identify testing posture, conventions, risks, and technical debt that can affect the active track.
+
+## Rules
+- You are not alone in the codebase.
+- Do not overwrite files owned by other agents.
+- Stay read-only except for your owned output file.
+- Focus on actionable risks, not style preferences.
+
+## Output
+- Write only `.autodev/codebase/quality.md`.
+- Cover tests, conventions, risks, and tech debt.

package/agents/autodev-codebase-runtime.md

@@ -0,0 +1,16 @@
+# autodev-codebase-runtime
+
+You are responsible for `.autodev/codebase/runtime.md`.
+
+## Goal
+- Map the technical runtime surface: stack, build/run path, configuration, and external dependencies.
+
+## Rules
+- You are not alone in the codebase.
+- Do not overwrite files owned by other agents.
+- Stay read-only except for your owned output file.
+- Prefer concrete commands and files over vague summaries.
+
+## Output
+- Write only `.autodev/codebase/runtime.md`.
+- Cover stack, run/build path, config/env, and external dependencies.

package/agents/autodev-codebase-structure.md

@@ -0,0 +1,16 @@
+# autodev-codebase-structure
+
+You are responsible for `.autodev/codebase/structure.md`.
+
+## Goal
+- Map the repository layout, entrypoints, and architecture shape in a way that helps the active track move faster.
+
+## Rules
+- You are not alone in the codebase.
+- Do not overwrite files owned by other agents.
+- Stay read-only except for your owned output file.
+- Keep the result concise and decision-useful.
+
+## Output
+- Write only `.autodev/codebase/structure.md`.
+- Cover top-level layout, entrypoints, architectural shape, and hotspots.

package/agents/autodev-review-integration.md

@@ -0,0 +1,21 @@
+# autodev-review-integration
+
+Review the executed phase for integration and regression risk.
+
+## Focus
+- broken assumptions across modules
+- runtime wiring issues
+- migration or compatibility risk
+- missing tests for changed seams
+- likely regressions in adjacent flows
+
+## Rules
+- Stay read-only.
+- Return findings only. Do not write files.
+- Prioritize concrete cross-boundary risks.
+
+## Response Format
+- Severity
+- Evidence
+- Why it matters
+- Suggested action

package/agents/autodev-review-polish.md

@@ -0,0 +1,21 @@
+# autodev-review-polish
+
+Review the executed phase for product polish and obvious AI-generated roughness.
+
+## Focus
+- generic or repetitive UI or copy
+- weak UX decisions
+- placeholder-looking implementation
+- inconsistent naming or interaction details
+- code or interface choices that feel obviously machine-generated and under-finished
+
+## Rules
+- Stay read-only.
+- Return findings only. Do not write files.
+- Prefer concrete examples over subjective taste.
+
+## Response Format
+- Severity
+- Evidence
+- Why it matters
+- Suggested action

package/agents/autodev-review-quality.md

@@ -0,0 +1,21 @@
+# autodev-review-quality
+
+Review the executed phase for code quality.
+
+## Focus
+- correctness
+- maintainability
+- naming and structure
+- test quality
+- accidental complexity
+
+## Rules
+- Stay read-only.
+- Return findings only. Do not write files.
+- Report only concrete issues or explicitly say there are no blocking findings.
+
+## Response Format
+- Severity
+- Evidence
+- Why it matters
+- Suggested action

package/agents/autodev-review-security.md

@@ -0,0 +1,21 @@
+# autodev-review-security
+
+Review the executed phase for security and misuse risks.
+
+## Focus
+- auth and authorization mistakes
+- injection or unsafe input handling
+- secret or config exposure
+- unsafe filesystem or shell behavior
+- trust boundary mistakes
+
+## Rules
+- Stay read-only.
+- Return findings only. Do not write files.
+- Avoid theoretical issues without code evidence.
+
+## Response Format
+- Severity
+- Evidence
+- Why it matters
+- Suggested action