viepilot 1.0.0

package/workflows/evolve.md

@@ -0,0 +1,258 @@
+<purpose>
+Nâng cấp hoặc mở rộng dự án: thêm features, bắt đầu milestone mới, hoặc refactor.
+</purpose>
+
+<process>
+
+<step name="detect_state">
+## 1. Detect Current State
+
+```bash
+cat .viepilot/TRACKER.md
+cat .viepilot/ROADMAP.md
+```
+
+Determine:
+- Current milestone progress
+- Is milestone complete?
+- Current version
+</step>
+
+<step name="ask_intent">
+## 2. Ask User Intent
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► EVOLVE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Current: {milestone_name}
+ Progress: {percent}%
+ Version: {version}
+
+How would you like to evolve the project?
+
+1. Add Feature - Add new feature to current milestone
+2. New Milestone - Start a new milestone (archive current)
+3. Refactor - Improve existing code without new features
+```
+</step>
+
+<step name="add_feature">
+## 3A. Add Feature Mode
+
+### Gather Feature Info
+```
+Describe the new feature:
+
+1. Feature name?
+2. What does it do? (1-2 sentences)
+3. Which services/modules affected?
+4. Dependencies on existing code?
+5. Estimated complexity? (S/M/L/XL)
+6. Có cần brainstorm chuyên sâu không? (landing page / UX / growth ideas / research-heavy)
+```
+
+### Check Architecture Compatibility
+```bash
+cat .viepilot/ARCHITECTURE.md
+```
+
+Questions:
+- Does it fit existing architecture?
+- Need new services?
+- Database changes needed?
+- Breaking changes?
+
+If incompatible → suggest refactor first or discuss alternative.
+
+### Smart Route to Brainstorm (khi phù hợp)
+Nếu feature có nội dung thiên về product discovery, UX, hoặc landing page:
+- Route qua brainstorm nâng cao thay vì chốt phase ngay:
+  - `/vp-brainstorm --new --landing --research` (nếu có landing page)
+  - `/vp-brainstorm --new --research` (nếu cần research decision)
+- Sau khi brainstorm xong, quay lại `/vp-evolve` để crystallize phase/tasks.
+
+### Generate Phase
+Create new phase in ROADMAP.md:
+```markdown
+### Phase {N+1}: {Feature Name}
+**Goal**: {description}
+**Estimated Tasks**: {count}
+**Dependencies**: Phase {N}
+
+| Task | Description | Acceptance Criteria |
+|------|-------------|---------------------|
+| {N+1}.1 | ... | ... |
+| {N+1}.2 | ... | ... |
+
+**Verification**:
+- [ ] {criteria}
+```
+
+### Create Phase Directory
+```bash
+mkdir -p .viepilot/phases/{NN}-{feature-slug}/tasks/
+```
+
+Create:
+- SPEC.md
+- PHASE-STATE.md
+- Task files
+
+### Update State
+- Update ROADMAP.md
+- Update TRACKER.md
+- Suggest version bump (MINOR)
+</step>
+
+<step name="new_milestone">
+## 3B. New Milestone Mode
+
+### Archive Current Milestone
+```bash
+mkdir -p .viepilot/milestones/v{current}/
+mv .viepilot/ROADMAP.md .viepilot/milestones/v{current}/
+```
+
+Create MILESTONE-SUMMARY.md:
+```markdown
+# Milestone {version} - {name} Summary
+
+## Completed: {date}
+
+## Phases
+{list phases with status}
+
+## Key Achievements
+- {achievement}
+
+## Decisions Made
+{from TRACKER.md}
+
+## Metrics
+- Total tasks: {count}
+- Completed: {count}
+- Skipped: {count}
+
+## Lessons Learned
+- {lesson}
+```
+
+Create git tag:
+```bash
+git tag -a v{version} -m "Release v{version} - {milestone_name}"
+```
+
+### Start New Milestone
+```
+New milestone details:
+
+1. Milestone name?
+2. Milestone goal? (1-2 sentences)
+3. Target features?
+```
+
+Options:
+- Route to `/vp-brainstorm --new` for full brainstorm
+- Nếu milestone có landing page focus: `/vp-brainstorm --new --landing --research`
+- Quick setup with minimal questions
+
+### Generate New ROADMAP.md
+Either from brainstorm or quick setup.
+
+### Update Version
+- Bump MAJOR (breaking) or MINOR (features)
+- Update all version references
+</step>
+
+<step name="refactor">
+## 3C. Refactor Mode
+
+### Analyze Code
+```
+What would you like to refactor?
+
+1. Auto-detect - Analyze code for improvement areas
+2. Specific area - Tell me what to refactor
+```
+
+**Auto-detect checks:**
+- Code duplication
+- Long methods/classes
+- Architecture violations
+- Performance issues
+- Technical debt markers (TODO, FIXME, HACK)
+
+### Create Refactor Tasks
+For each improvement:
+```markdown
+| Task | Description | Impact |
+|------|-------------|--------|
+| R.1 | Extract {X} to separate class | Maintainability |
+| R.2 | Optimize {Y} query | Performance |
+```
+
+### Ensure Backward Compatibility
+- List any breaking changes
+- Document migration steps if needed
+- Update ARCHITECTURE.md if structure changes
+
+### Generate Refactor Phase
+Add to ROADMAP.md as phase {N+0.5} or insert between phases.
+</step>
+
+<step name="update_version">
+## 4. Update Version
+
+Based on changes:
+
+| Mode | Version Bump |
+|------|--------------|
+| Add Feature | MINOR (x.Y.z) |
+| New Milestone | MAJOR or MINOR |
+| Refactor | PATCH (x.y.Z) |
+
+Update in:
+- TRACKER.md
+- pom.xml / package.json / version file
+- CHANGELOG.md [Unreleased] section
+</step>
+
+<step name="confirm">
+## 5. Confirm & Suggest Next
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► EVOLVE COMPLETE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Mode: {Add Feature | New Milestone | Refactor}
+
+ Changes:
+ - {change 1}
+ - {change 2}
+
+ Version: {old} → {new}
+
+ New Phases:
+ - Phase {N}: {name}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Next: /vp-auto --from {new_phase}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] User intent identified
+- [ ] Architecture compatibility checked
+- [ ] New phases added to ROADMAP.md
+- [ ] Phase directories created
+- [ ] TRACKER.md updated
+- [ ] Version bumped appropriately
+- [ ] CHANGELOG.md updated
+- [ ] Ready for execution
+</success_criteria>

package/workflows/pause-work.md

@@ -0,0 +1,255 @@
+<purpose>
+Save complete work state để có thể resume từ bất kỳ context nào.
+Creates HANDOFF.json và .continue-here.md cho recovery.
+</purpose>
+
+<process>
+
+<step name="detect">
+## 1. Detect Current Position
+
+```bash
+# Read current state
+cat .viepilot/TRACKER.md
+```
+
+Extract: current_phase, current_task
+
+If unclear, find from recent files:
+```bash
+ls -lt .viepilot/phases/*/PHASE-STATE.md | head -1
+```
+
+If still unclear, ask user which phase/task they're on.
+</step>
+
+<step name="gather">
+## 2. Gather State
+
+Collect complete state:
+
+### 1. Current Position
+- Phase number and name
+- Task number and name
+- Line/function if applicable
+
+### 2. Work Completed (this session)
+```bash
+git log --oneline --since="8 hours ago"
+```
+- List commits made
+- Summarize changes
+
+### 3. Work Remaining
+- Read PHASE-STATE.md
+- List incomplete tasks
+- Estimate remaining effort
+
+### 4. Decisions Made
+- Check git commits for decisions
+- Ask user for any unlisted decisions
+
+### 5. Blockers/Issues
+- Any errors encountered?
+- Anything stuck?
+
+### 6. Human Actions Pending
+- Manual setup needed?
+- API keys/credentials?
+- External approvals?
+
+### 7. Background Processes
+- Dev servers running?
+- Watchers active?
+
+### 8. Uncommitted Files
+```bash
+git status --porcelain
+```
+
+Ask user for clarifications if needed.
+</step>
+
+<step name="write_handoff_json">
+## 3. Write HANDOFF.json
+
+```bash
+timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+```
+
+Create `.viepilot/HANDOFF.json`:
+```json
+{
+  "version": "1.0",
+  "timestamp": "{timestamp}",
+  "phase": "{phase_number}",
+  "phase_name": "{phase_name}",
+  "phase_dir": ".viepilot/phases/{phase_slug}",
+  "task": {task_number},
+  "task_name": "{task_name}",
+  "total_tasks": {total},
+  "status": "paused",
+  "completed_tasks": [
+    {
+      "id": 1,
+      "name": "{name}",
+      "status": "done",
+      "commit": "{short_hash}"
+    }
+  ],
+  "remaining_tasks": [
+    {
+      "id": 3,
+      "name": "{name}",
+      "status": "not_started"
+    }
+  ],
+  "blockers": [
+    {
+      "description": "{description}",
+      "type": "technical|human_action|external",
+      "workaround": "{if any}"
+    }
+  ],
+  "human_actions_pending": [
+    {
+      "action": "{what}",
+      "context": "{why}",
+      "blocking": true
+    }
+  ],
+  "decisions": [
+    {
+      "decision": "{what}",
+      "rationale": "{why}",
+      "phase": "{phase}"
+    }
+  ],
+  "uncommitted_files": ["{file1}", "{file2}"],
+  "next_action": "{specific first action when resuming}",
+  "context_notes": "{mental state, approach, what you were thinking}"
+}
+```
+</step>
+
+<step name="write_continue_here">
+## 4. Write .continue-here.md
+
+Create `.viepilot/phases/{phase}/.continue-here.md`:
+
+```markdown
+---
+phase: {phase_slug}
+task: {task_number}
+total_tasks: {total}
+status: in_progress
+last_updated: {timestamp}
+---
+
+<current_state>
+Phase {N}: {Phase Name}
+Task {T}: {Task Name}
+
+Currently working on: {specific detail}
+</current_state>
+
+<completed_work>
+- Task 1: {name} - Done ✅
+- Task 2: {name} - Done ✅
+- Task 3: {name} - In progress (60%)
+  - Completed: {what's done}
+  - Remaining: {what's left}
+</completed_work>
+
+<remaining_work>
+- Task 3: {what's left to do}
+- Task 4: {name} - Not started
+- Task 5: {name} - Not started
+</remaining_work>
+
+<decisions_made>
+- Decided to use {X} because {reason}
+- Chose {approach} over {alternative} because {reason}
+</decisions_made>
+
+<blockers>
+- {Blocker 1}: {status/workaround}
+- None currently
+</blockers>
+
+<human_actions>
+- {Action needed}: {context}
+- None pending
+</human_actions>
+
+<context>
+Mental state: {what you were thinking}
+Approach: {the plan you were following}
+Notes: {any important notes}
+</context>
+
+<next_action>
+Start with: {specific first action when resuming}
+
+Commands to run:
+1. {command}
+2. {command}
+</next_action>
+```
+</step>
+
+<step name="commit">
+## 5. Git Commit
+
+```bash
+git add -A
+git commit -m "wip({phase}): paused at task {task}/{total}
+
+State saved for resume:
+- Phase: {phase_name}
+- Task: {task_name}
+- Status: {status}
+
+Resume with: /vp-resume"
+git push
+```
+</step>
+
+<step name="confirm">
+## 6. Confirm
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► PAUSED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Work paused successfully.
+
+ Current State:
+ ├── Phase: {phase_name}
+ ├── Task: {task} of {total}
+ ├── Status: {status}
+ └── Blockers: {count}
+
+ Files Saved:
+ ├── .viepilot/HANDOFF.json
+ └── .viepilot/phases/{phase}/.continue-here.md
+
+ Committed as WIP.
+
+ ─────────────────────────────────────────────────
+ To resume: /vp-resume
+ ─────────────────────────────────────────────────
+```
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] HANDOFF.json created with complete state
+- [ ] .continue-here.md created with human-readable context
+- [ ] All sections filled with specific content
+- [ ] Uncommitted changes identified
+- [ ] Git WIP commit created
+- [ ] User knows how to resume
+</success_criteria>