viepilot 1.0.0

package/skills/vp-status/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: vp-status
+description: "Hiển thị progress dashboard và actionable insights"
+version: 0.1.0
+---
+
+<cursor_skill_adapter>
+## A. Skill Invocation
+- Skill được gọi khi user mention `vp-status`, `/vp-status`, "status", "tiến độ", "đang ở đâu"
+- Treat all user text after the skill mention as `{{VP_ARGS}}`
+
+## B. Tool Usage
+Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+</cursor_skill_adapter>
+
+<objective>
+Hiển thị visual progress dashboard với actionable insights.
+
+**Reads:**
+- `.viepilot/TRACKER.md`
+- `.viepilot/ROADMAP.md`
+- `.viepilot/phases/*/PHASE-STATE.md`
+- `CHANGELOG.md`
+
+**Output:** Dashboard display với next action suggestions.
+</objective>
+
+<process>
+
+### Step 1: Load State
+```bash
+cat .viepilot/TRACKER.md
+cat .viepilot/ROADMAP.md
+```
+
+### Step 2: Calculate Progress
+For each phase:
+- Count total tasks
+- Count completed tasks
+- Calculate percentage
+
+Overall:
+- Total phases
+- Completed phases
+- Overall percentage
+
+### Step 3: Display Dashboard
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► STATUS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Project: {project_name}
+ Version: {current_version}
+ Milestone: {milestone_name}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ PHASE PROGRESS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Phase 1: Project Setup       [██████████] 100% ✅
+ Phase 2: Database Foundation [████████░░]  80% 🔄
+ Phase 3: TAP Service Core    [░░░░░░░░░░]   0% ⏳
+ Phase 4: Location Service    [░░░░░░░░░░]   0% ⏳
+ Phase 5: API Gateway         [░░░░░░░░░░]   0% ⏳
+
+ ─────────────────────────────────────────────────────────────────
+ Overall Progress:            [████░░░░░░]  36%
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ CURRENT STATE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Current Phase: 02 - Database Foundation
+ Current Task:  4/5 - Create TimescaleDB hypertables
+ Task Status:   In Progress
+
+ Last Activity: 2 hours ago
+ Last Commit:   feat(db): create vehicle/device tables
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ QUALITY METRICS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Tests:     45 pass, 2 fail ⚠️
+ Coverage:  72%
+ Lint:      0 errors, 3 warnings
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ DECISIONS & BLOCKERS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Decisions Made: 24 total, 21 locked, 3 pending
+ Blockers: 0 active
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ NEXT ACTIONS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Recommended: Fix 2 failing tests, then continue task 4
+
+ Quick Actions:
+ 1. Continue current task    → /vp-auto --from 2
+ 2. View failing tests       → (show test output)
+ 3. View current task        → (show task file)
+ 4. Pause work              → /vp-pause
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Step 4: Offer Quick Actions
+Based on state, offer relevant actions:
+
+If tests failing:
+- "Fix failing tests"
+- "View test output"
+
+If task in progress:
+- "Continue task"
+- "View task details"
+
+If phase complete:
+- "Start next phase"
+- "Review phase summary"
+
+If blockers:
+- "View blockers"
+- "Skip blocked task"
+</process>
+
+<success_criteria>
+- [ ] All progress calculated correctly
+- [ ] Visual dashboard displayed
+- [ ] Current state clearly shown
+- [ ] Quality metrics included
+- [ ] Actionable next steps suggested
+</success_criteria>

package/skills/vp-task/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: vp-task
+description: "Manual control over individual tasks"
+version: 0.1.0
+---
+
+<cursor_skill_adapter>
+## A. Skill Invocation
+- Skill được gọi khi user mention `vp-task`, `/vp-task`
+- Treat all user text after the skill mention as `{{VP_ARGS}}`
+
+## B. Tool Usage
+Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+</cursor_skill_adapter>
+
+<objective>
+Manual control over tasks khi cần fine-grained management.
+
+**Commands:**
+- `list` - List tasks in current phase
+- `show N` - Show task N details
+- `start N` - Manually start task N
+- `done N` - Mark task N as done
+- `skip N` - Skip task N with reason
+- `retry N` - Retry failed task N
+- `rollback N` - Rollback task N
+</objective>
+
+<process>
+
+### Parse Command
+```
+/vp-task {command} {args}
+
+Commands:
+- /vp-task list
+- /vp-task show 3
+- /vp-task start 3
+- /vp-task done 3
+- /vp-task skip 3 --reason "Not needed for MVP"
+- /vp-task retry 3
+- /vp-task rollback 3
+```
+
+### Command: list
+```bash
+# Read current phase
+cat .viepilot/TRACKER.md → current_phase
+cat .viepilot/phases/{phase}/PHASE-STATE.md
+```
+
+Display:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Phase {N}: {Name} - Tasks
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ # │ Task                      │ Status      │ Tag
+───┼───────────────────────────┼─────────────┼─────────────
+ 1 │ Create parent pom.xml     │ ✅ done     │ vp-p1-t1-done
+ 2 │ Create common module      │ ✅ done     │ vp-p1-t2-done
+ 3 │ Create tap-service        │ 🔄 progress │ vp-p1-t3
+ 4 │ Create location-service   │ ⏳ pending  │ -
+ 5 │ Docker Compose setup      │ ⏳ pending  │ -
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Command: show N
+```bash
+cat .viepilot/phases/{phase}/tasks/{N}-*.md
+```
+
+Display task file content with syntax highlighting.
+
+### Command: start N
+```yaml
+actions:
+  1. Check task not already started
+  2. Check dependencies met
+  3. Create git tag: vp-p{phase}-t{N}
+  4. Update PHASE-STATE.md: status → in_progress
+  5. Update TRACKER.md
+  6. Display task objective and acceptance criteria
+```
+
+### Command: done N
+```yaml
+actions:
+  1. Verify task exists and is in_progress
+  2. Ask: "Skip verification? (not recommended)"
+  3. If no skip:
+     - Run automated checks
+     - Check acceptance criteria
+  4. Create git tag: vp-p{phase}-t{N}-done
+  5. Update PHASE-STATE.md
+  6. Update TRACKER.md
+  7. Update CHANGELOG.md if feature/fix
+```
+
+### Command: skip N
+```yaml
+actions:
+  1. Ask for skip reason (required)
+  2. Update task status → skipped
+  3. Log skip reason in PHASE-STATE.md
+  4. Update TRACKER.md
+  5. Move to next task or phase
+```
+
+### Command: retry N
+```yaml
+actions:
+  1. Check task is failed or blocked
+  2. Reset task status → in_progress
+  3. Clear previous error state
+  4. Display: "Task {N} reset. Continue with /vp-auto or manual work."
+```
+
+### Command: rollback N
+```yaml
+actions:
+  1. Check task has been started (has tag)
+  2. Confirm with user: "This will undo all changes from task {N}. Continue?"
+  3. Git revert to task start tag:
+     git revert --no-commit $(git rev-list vp-p{phase}-t{N}..HEAD)
+  4. Reset task status → not_started
+  5. Update PHASE-STATE.md
+  6. Display rollback summary
+```
+</process>
+
+<success_criteria>
+- [ ] Command parsed correctly
+- [ ] Appropriate action taken
+- [ ] State files updated
+- [ ] Git tags managed
+- [ ] User feedback provided
+</success_criteria>

package/skills/vp-ui-components/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: vp-ui-components
+description: "Quản lý workflow sưu tầm và tái sử dụng UI components"
+version: 0.1.0
+---
+
+<cursor_skill_adapter>
+## A. Skill Invocation
+- Skill được gọi khi user mention `vp-ui-components`, `/vp-ui-components`, "ui components", "component library", "21st.dev component"
+- Treat all user text after the skill mention as `{{VP_ARGS}}`
+
+## B. User Prompting
+Prompt user conversationally với numbered list options.
+
+## C. Tool Usage
+Use Cursor tools: `Shell`, `ReadFile`, `Glob`, `rg`, `ApplyPatch`, `WebSearch`, `WebFetch`, `Subagent`
+</cursor_skill_adapter>
+
+<objective>
+Thu thập, phân loại, và lưu trữ UI components để tái sử dụng:
+- Global library: `~/.viepilot/ui-components/`
+- Project library: `.viepilot/ui-components/`
+
+Nguồn có thể đến từ prompt/link/snippet (đặc biệt 21st.dev), sau đó chuẩn hóa thành artifacts có metadata.
+
+**Creates/Updates:**
+- `~/.viepilot/ui-components/{category}/{component-id}/...`
+- `.viepilot/ui-components/{category}/{component-id}/...`
+- `INDEX.md` cho global + local store
+
+**After:** Component có thể dùng lại cho `/vp-brainstorm --ui` và `/vp-crystallize`.
+</objective>
+
+<execution_context>
+@$HOME/.cursor/viepilot/workflows/ui-components.md
+</execution_context>
+
+<context>
+Optional flags:
+- `--add` : Add/capture component mới
+- `--list` : Liệt kê component theo category
+- `--sync` : Đồng bộ global ↔ local index
+- `--from-21st` : Ưu tiên flow ingest từ 21st.dev references
+- `--approve` : Mark component status thành approved
+</context>
+
+<process>
+Execute workflow from `@$HOME/.cursor/viepilot/workflows/ui-components.md`
+
+Key steps:
+1. Prepare global + local component stores
+2. Collect source input (prompt/link/snippet + intent)
+3. Classify component taxonomy
+4. Write standardized artifacts (README, SOURCE, html/css, metadata)
+5. Update indexes
+6. Connect selected IDs to brainstorm/crystallize context
+</process>
+
+<success_criteria>
+- [ ] Component stored with taxonomy + metadata
+- [ ] Global and local indexes updated
+- [ ] Source provenance documented
+- [ ] Reuse-ready for next brainstorm and crystallize runs
+</success_criteria>

package/templates/phase/PHASE-STATE.md

@@ -0,0 +1,35 @@
+# Phase {{PHASE_NUMBER}}: {{PHASE_NAME}} - State
+
+## Overview
+- **Started**: {{START_DATE}}
+- **Status**: not_started | in_progress | complete
+- **Progress**: 0/{{TASK_COUNT}} tasks (0%)
+- **Current Task**: -
+
+## Task Status
+
+| # | Task | Status | Started | Completed | Git Tag |
+|---|------|--------|---------|-----------|---------|
+{{TASK_TABLE}}
+
+## Blockers
+_None currently_
+
+## Decisions Made (This Phase)
+| Decision | Rationale | Task |
+|----------|-----------|------|
+
+## Files Changed
+
+List **every file individually** — run `git diff vp-p{N}-t{M}..HEAD --name-status` to get actual list. Do NOT use glob patterns.
+
+| File | Action | Task |
+|------|--------|------|
+
+## Quality Metrics
+- Tests written: 0
+- Tests passing: 0
+- Code coverage: N/A
+- Linting errors: 0
+
+## Notes

package/templates/phase/SPEC.md

@@ -0,0 +1,40 @@
+# Phase {{PHASE_NUMBER}}: {{PHASE_NAME}} - Specification
+
+## Overview
+- **Goal**: {{PHASE_GOAL}}
+- **Dependencies**: {{DEPENDENCIES}}
+- **Estimated Tasks**: {{TASK_COUNT}}
+
+## Objective
+
+{{PHASE_OBJECTIVE}}
+
+## Scope
+
+### In Scope
+{{IN_SCOPE}}
+
+### Out of Scope
+{{OUT_OF_SCOPE}}
+
+## Requirements
+
+### Functional
+{{FUNCTIONAL_REQUIREMENTS}}
+
+### Non-Functional
+{{NON_FUNCTIONAL_REQUIREMENTS}}
+
+## Acceptance Criteria
+
+{{ACCEPTANCE_CRITERIA}}
+
+## Technical Notes
+
+{{TECHNICAL_NOTES}}
+
+## References
+
+- Architecture: `.viepilot/ARCHITECTURE.md`
+- Context: `.viepilot/PROJECT-CONTEXT.md`
+- Rules: `.viepilot/SYSTEM-RULES.md`

package/templates/phase/SUMMARY.md

@@ -0,0 +1,67 @@
+# Phase {{PHASE_NUMBER}}: {{PHASE_NAME}} - Summary
+
+## Overview
+- **Started**: {{START_DATE}}
+- **Completed**: {{END_DATE}}
+- **Duration**: {{DURATION}}
+- **Status**: Complete ✅
+
+## Completed Tasks
+
+| # | Task | Commits | Notes |
+|---|------|---------|-------|
+{{COMPLETED_TASKS}}
+
+## Skipped Tasks
+
+| # | Task | Reason |
+|---|------|--------|
+{{SKIPPED_TASKS}}
+
+## Key Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+{{DECISIONS}}
+
+## Files Changed
+
+> Populate by running: `git diff vp-p{{PHASE_NUMBER}}-t1..HEAD --name-status | sort`
+> List every file individually. Do NOT use glob patterns or summarize groups.
+
+### Created
+| File | Task |
+|------|------|
+{{CREATED_FILES}}
+
+### Modified
+| File | Task |
+|------|------|
+{{MODIFIED_FILES}}
+
+### Deleted
+| File | Task |
+|------|------|
+{{DELETED_FILES}}
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+| Tasks completed | {{COMPLETED_COUNT}} |
+| Tasks skipped | {{SKIPPED_COUNT}} |
+| Commits | {{COMMIT_COUNT}} |
+| Lines added | {{LINES_ADDED}} |
+| Lines removed | {{LINES_REMOVED}} |
+| Test coverage | {{COVERAGE}} |
+
+## Lessons Learned
+
+{{LESSONS}}
+
+## Notes
+
+{{NOTES}}
+
+---
+Git Tag: `vp-p{{PHASE_NUMBER}}-complete`

package/templates/phase/TASK.md

@@ -0,0 +1,101 @@
+# Task {{TASK_NUMBER}}: {{TASK_NAME}}
+
+## Meta
+- **Phase**: {{PHASE_NUMBER}}-{{PHASE_SLUG}}
+- **Status**: not_started | in_progress | blocked | done | skipped
+- **Complexity**: {{COMPLEXITY}}
+- **Dependencies**: {{DEPENDENCIES}}
+- **Git Tag**: vp-p{{PHASE_NUMBER}}-t{{TASK_NUMBER}}
+
+## Objective
+
+{{TASK_OBJECTIVE}}
+
+## Pre-execution documentation gate (doc-first; BUG-001)
+
+**Complete before any implementation commits** (see `workflows/autonomous.md`). Read-only research and editing *this task file* to fill the plan are allowed.
+
+- [ ] Task contract fields below are filled with **real** paths and intent (no literal `{{PLACEHOLDER}}` rows left in Paths / File-Level Plan).
+- [ ] `## Paths` lists every file/dir to create or modify for this task.
+- [ ] `## File-Level Plan` **or** `## Implementation Notes` explains *what* and *why* per path.
+- [ ] `.viepilot/phases/{{PHASE_NUMBER}}-{{PHASE_SLUG}}/PHASE-STATE.md` marks this task `in_progress` before the first implementation commit.
+
+If any box is unchecked when coding starts → **blocked**; finish the plan first.
+
+## Paths
+```yaml
+files_to_create:
+  - {{NEW_FILE_PATH_1}}
+files_to_modify:
+  - {{MODIFIED_FILE_PATH_1}}
+```
+
+## File-Level Plan
+- `{{FILE_PATH}}`: {{WHAT_TO_CHANGE_AND_WHY}}
+- `{{FILE_PATH_2}}`: {{WHAT_TO_CHANGE_AND_WHY}}
+
+## Context Required
+```yaml
+files_to_read:
+  - .viepilot/ARCHITECTURE.md#{{RELEVANT_SECTION}}
+  - .viepilot/SYSTEM-RULES.md#coding_rules
+  {{ADDITIONAL_CONTEXT}}
+```
+
+## Acceptance Criteria
+- [ ] {{CRITERIA_1}}
+- [ ] {{CRITERIA_2}}
+- [ ] {{CRITERIA_3}}
+
+## Best Practices to Apply
+- [ ] {{STACK_SPECIFIC_PRACTICE_1}}
+- [ ] {{CODE_QUALITY_PRACTICE_1}}
+- [ ] {{TESTING_OR_VERIFICATION_PRACTICE}}
+
+## Do / Don't
+### Do
+- {{DO_ITEM_1}}
+- {{DO_ITEM_2}}
+
+### Don't
+- {{DONT_ITEM_1}}
+- {{DONT_ITEM_2}}
+
+## Implementation Notes
+```
+(AI ghi lại notes trong quá trình implement)
+- Decisions made:
+- Issues encountered:
+- Deviations from plan:
+```
+
+## Verification
+```yaml
+automated:
+  - command: "{{VERIFY_COMMAND}}"
+    expected: "{{EXPECTED_OUTPUT}}"
+  - command: "{{VERIFY_COMMAND_2}}"
+    expected: "{{EXPECTED_OUTPUT_2}}"
+  {{ADDITIONAL_CHECKS}}
+
+manual:
+  - description: "{{MANUAL_CHECK}}"
+    required: {{REQUIRED}}
+```
+
+## State Update Checklist
+- [ ] Update `.viepilot/phases/{{PHASE_NUMBER}}-{{PHASE_SLUG}}/PHASE-STATE.md` after each PASS sub-task
+- [ ] Update `.viepilot/TRACKER.md` with current task/progress
+- [ ] Update `.viepilot/HANDOFF.json` to exact resume point
+- [ ] Update `.viepilot/ROADMAP.md` if phase progress/status changed
+
+## Files Changed
+```
+(Auto-populated after completion)
+```
+
+## Rollback
+```bash
+# If need to undo this task:
+git revert --no-commit $(git rev-list vp-p{{PHASE_NUMBER}}-t{{TASK_NUMBER}}..vp-p{{PHASE_NUMBER}}-t{{TASK_NUMBER}}-done)
+```

package/templates/phase/VERIFICATION.md

@@ -0,0 +1,49 @@
+# Phase {{PHASE_NUMBER}}: {{PHASE_NAME}} - Verification
+
+## Overview
+- **Verified At**: {{TIMESTAMP}}
+- **Status**: passed | partial | failed
+
+## Task Verification
+
+{{#TASKS}}
+### Task {{TASK_NUMBER}}: {{TASK_NAME}}
+**Status**: {{STATUS}}
+
+#### Automated Checks
+| Check | Result | Output |
+|-------|--------|--------|
+{{AUTOMATED_CHECKS}}
+
+#### Manual Checks
+| Check | Result | Verified By |
+|-------|--------|-------------|
+{{MANUAL_CHECKS}}
+
+{{/TASKS}}
+
+## Quality Gate
+
+| Criteria | Required | Result |
+|----------|----------|--------|
+| All acceptance criteria met | ✅ | {{RESULT}} |
+| Automated tests pass | ✅ | {{RESULT}} |
+| No lint errors | ✅ | {{RESULT}} |
+| Code review (if required) | ⚪ | {{RESULT}} |
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Total checks | {{TOTAL}} |
+| Passed | {{PASSED}} |
+| Failed | {{FAILED}} |
+| Skipped | {{SKIPPED}} |
+
+## Issues Found
+
+{{ISSUES}}
+
+## Next Action
+
+{{NEXT_ACTION}}