viepilot 1.0.0

package/templates/project/README.md

@@ -0,0 +1,197 @@
+# {{PROJECT_NAME}}
+
+**{{PROJECT_DESCRIPTION}}**
+
+[![Version](https://img.shields.io/badge/version-{{VERSION}}-blue.svg)](CHANGELOG.md)
+[![License: {{LICENSE}}](https://img.shields.io/badge/License-{{LICENSE}}-green.svg)](LICENSE)
+[![Built with ViePilot](https://img.shields.io/badge/Built%20with-ViePilot-purple.svg)](https://github.com/0-CODE/viepilot)
+
+{{PROJECT_DESCRIPTION_LONG}}
+
+---
+
+## Quy mô dự án / Project Scale
+
+| Chỉ số / Metric | Giá trị / Value |
+|-----------------|-----------------|
+| Version | {{VERSION}} |
+| Phases | {{PHASE_COUNT}} |
+| Status | {{STATUS}} |
+| Started | {{INCEPTION_YEAR}} |
+
+---
+
+## Tính năng / Features
+
+{{FEATURES_LIST}}
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+{{TECH_STACK_TABLE}}
+
+---
+
+## Bắt đầu nhanh / Quick Start
+
+### Prerequisites / Yêu cầu
+
+{{PREREQUISITES}}
+
+### Installation / Cài đặt
+
+```bash
+# Clone repository
+git clone {{REPOSITORY_URL}}
+cd {{ARTIFACT_ID}}
+
+# Install dependencies
+{{INSTALL_COMMAND}}
+
+# Setup environment
+cp .env.example .env
+
+# Run
+{{RUN_COMMAND}}
+```
+
+### Using Makefile (if available)
+
+```bash
+make setup    # Setup environment
+make dev      # Start development
+make test     # Run tests
+make build    # Build for production
+make help     # Show all commands
+```
+
+---
+
+## Cấu trúc dự án / Project Structure
+
+```
+{{ARTIFACT_ID}}/
+├── {{PROJECT_STRUCTURE}}
+```
+
+---
+
+## Development / Phát triển
+
+### Development Workflow
+
+Dự án này được phát triển với [ViePilot](https://github.com/0-CODE/viepilot) framework.
+
+```bash
+# Xem tiến độ / Check progress
+/vp-status
+
+# Tiếp tục phát triển / Continue development
+/vp-auto
+
+# Thêm feature mới / Add new feature
+/vp-request --feature
+
+# Report bug
+/vp-request --bug
+```
+
+### Current Progress
+
+```
+{{PROGRESS_BAR}}
+```
+
+Xem chi tiết tại / See details at: [.viepilot/TRACKER.md](.viepilot/TRACKER.md)
+
+---
+
+## API Documentation / Tài liệu API
+
+{{API_DOCS_SECTION}}
+
+---
+
+## Testing / Kiểm thử
+
+```bash
+# Run all tests
+{{TEST_COMMAND}}
+
+# Run specific tests
+{{TEST_SPECIFIC_COMMAND}}
+```
+
+---
+
+## Deployment / Triển khai
+
+{{DEPLOYMENT_SECTION}}
+
+---
+
+## Tài liệu / Documentation
+
+| Tài liệu / Document | Nội dung / Content |
+|---------------------|-------------------|
+| [Architecture](.viepilot/ARCHITECTURE.md) | Kiến trúc hệ thống / System architecture |
+| [API Reference](docs/api/) | Tài liệu API / API documentation |
+| [Developer Guide](docs/dev/) | Hướng dẫn phát triển / Developer guide |
+| [CHANGELOG](CHANGELOG.md) | Lịch sử thay đổi / Version history |
+| [CONTRIBUTING](CONTRIBUTING.md) | Hướng dẫn đóng góp / How to contribute |
+
+---
+
+## Roadmap
+
+{{ROADMAP_SUMMARY}}
+
+Xem chi tiết tại / See details at: [.viepilot/ROADMAP.md](.viepilot/ROADMAP.md)
+
+---
+
+## Đóng góp / Contributing
+
+Chúng tôi hoan nghênh mọi đóng góp! / We welcome contributions!
+
+Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết chi tiết.
+
+---
+
+## Team / Đội ngũ
+
+### Maintainers
+
+| Name | Role | Contact |
+|------|------|---------|
+| {{LEAD_DEVELOPER_NAME}} | Project Lead | [@{{LEAD_DEVELOPER_GITHUB}}](https://github.com/{{LEAD_DEVELOPER_GITHUB}}) |
+
+### Contributors
+
+Xem danh sách đầy đủ tại / See full list at: [CONTRIBUTORS.md](CONTRIBUTORS.md)
+
+---
+
+## License / Giấy phép
+
+{{LICENSE}} License - Xem [LICENSE](LICENSE) để biết chi tiết.
+
+---
+
+## Acknowledgments / Ghi nhận
+
+- Built with [ViePilot](https://github.com/0-CODE/viepilot) - Autonomous Vibe Coding Framework
+{{ACKNOWLEDGMENTS}}
+
+---
+
+<p align="center">
+  <strong>{{PROJECT_NAME}}</strong>
+  <br>
+  {{TAGLINE}}
+  <br><br>
+  Copyright © {{INCEPTION_YEAR}} {{ORGANIZATION_NAME}}
+</p>

package/templates/project/ROADMAP.md

@@ -0,0 +1,56 @@
+# {{PROJECT_NAME}} - Roadmap
+
+## Milestone: {{MILESTONE_NAME}}
+
+### Overview
+- **Version**: {{VERSION}}
+- **Goal**: {{MILESTONE_GOAL}}
+- **Phases**: {{PHASE_COUNT}}
+- **Status**: Not Started
+
+---
+
+### Phase 1: {{PHASE_1_NAME}}
+**Goal**: {{PHASE_1_GOAL}}
+**Estimated Tasks**: {{PHASE_1_TASK_COUNT}}
+**Dependencies**: None
+
+| Task | Description | Acceptance Criteria | Complexity |
+|------|-------------|---------------------|------------|
+| 1.1 | {{TASK_1_1}} | {{CRITERIA_1_1}} | S |
+| 1.2 | {{TASK_1_2}} | {{CRITERIA_1_2}} | M |
+
+**Verification**:
+- [ ] {{VERIFICATION_1}}
+- [ ] {{VERIFICATION_2}}
+
+---
+
+### Phase 2: {{PHASE_2_NAME}}
+**Goal**: {{PHASE_2_GOAL}}
+**Estimated Tasks**: {{PHASE_2_TASK_COUNT}}
+**Dependencies**: Phase 1
+
+| Task | Description | Acceptance Criteria | Complexity |
+|------|-------------|---------------------|------------|
+| 2.1 | {{TASK_2_1}} | {{CRITERIA_2_1}} | M |
+| 2.2 | {{TASK_2_2}} | {{CRITERIA_2_2}} | L |
+
+**Verification**:
+- [ ] {{VERIFICATION_1}}
+- [ ] {{VERIFICATION_2}}
+
+---
+
+## Progress Summary
+
+| Phase | Status | Tasks | Completed | Progress |
+|-------|--------|-------|-----------|----------|
+| 1. {{PHASE_1_NAME}} | Not Started | {{COUNT}} | 0 | 0% |
+| 2. {{PHASE_2_NAME}} | Not Started | {{COUNT}} | 0 | 0% |
+
+---
+
+## Notes
+- Created: {{DATE}}
+- Last Updated: {{DATE}}

package/templates/project/SYSTEM-RULES.md

@@ -0,0 +1,368 @@
+# {{PROJECT_NAME}} - System Rules
+
+## Table of Contents
+1. [Architecture Rules](#architecture_rules)
+2. [Coding Rules](#coding_rules)
+3. [Comment Standards](#comment_standards)
+4. [Versioning](#versioning)
+5. [Git Conventions](#git_conventions)
+6. [Changelog Standards](#changelog_standards)
+7. [Contributor Standards](#contributor_standards)
+8. [Quality Gates](#quality_gates)
+9. [Forbidden Patterns](#do_not)
+
+---
+
+<architecture_rules>
+## Architecture Rules
+
+### Layer Structure
+```
+src/main/java/{{PACKAGE_PATH}}/
+├── controller/    # REST/GraphQL endpoints
+├── service/       # Business logic
+├── mapper/        # Data access (MyBatis/JPA)
+├── model/         # Entities, DTOs
+├── config/        # Spring configs
+└── util/          # Helpers
+```
+
+### Dependency Rules
+- Controller → Service (never reverse)
+- Service → Mapper/Repository (never reverse)
+- No circular dependencies between modules
+
+### Service Boundaries
+{{SERVICE_BOUNDARIES}}
+</architecture_rules>
+
+<coding_rules>
+## Coding Rules
+
+### General
+- Follow project naming conventions
+- Use meaningful variable/method names
+- Keep methods small (< 30 lines preferred)
+- Single responsibility principle
+
+### Language Specific
+{{LANGUAGE_SPECIFIC_RULES}}
+
+### Testing
+- Unit tests for all service methods
+- Integration tests for API endpoints
+- Test naming: `should_expectedBehavior_when_condition()`
+- Minimum coverage: {{COVERAGE_THRESHOLD}}%
+</coding_rules>
+
+<comment_standards>
+## Comment Standards
+
+### Philosophy
+> "Code tells you HOW, comments tell you WHY"
+
+### Good Comments ✅
+
+#### 1. Explain WHY (Intent/Rationale)
+```java
+// ✅ GOOD: Explains why this specific value
+// Use 5-second timeout because external API may have latency spikes.
+// Tested with production data showing 3-4s avg response.
+private static final int API_TIMEOUT_MS = 5000;
+```
+
+#### 2. Explain Business Rules
+```java
+// ✅ GOOD: Documents business rule
+// Orders over $1000 require manager approval per company policy.
+// See POLICY-2024-03 for details.
+if (order.getTotal() > 1000) {
+    requireManagerApproval(order);
+}
+```
+
+#### 3. Warn About Non-Obvious Behavior
+```java
+// ✅ GOOD: Warning about side effect
+// WARNING: This method also updates the cache.
+// Do not call in read-only contexts.
+public Data fetchData(String id) {
+    updateCache(id); // Side effect
+    return repository.findById(id);
+}
+```
+
+#### 4. Document Workarounds/Hacks
+```java
+// ✅ GOOD: Explains temporary workaround
+// HACK: Library X has bug with null values.
+// Using empty string as workaround until v2.0 release.
+// Tracking issue: https://github.com/lib/x/issues/123
+// TODO: Remove after upgrading to v2.0
+private String sanitize(String input) {
+    return input == null ? "" : input;
+}
+```
+
+#### 5. Explain Complex Algorithms
+```java
+// ✅ GOOD: Explains the algorithm
+/**
+ * Calculates discount using tiered pricing:
+ * - 0-100 units: no discount
+ * - 101-500 units: 10% discount
+ * - 500+ units: 20% discount
+ * 
+ * @see PricingPolicy for tier definitions
+ */
+public BigDecimal calculateDiscount(int quantity) {
+    // Implementation
+}
+```
+
+### Bad Comments ❌
+
+#### 1. Stating the Obvious
+```java
+// ❌ BAD: Obvious from code
+// Increment counter
+counter++;
+
+// Get the user
+User user = userRepository.findById(id);
+```
+
+#### 2. Commented-Out Code
+```java
+// ❌ BAD: Delete dead code, use git history
+public void process() {
+    // oldMethod();
+    // if (flag) { doSomething(); }
+    newMethod();
+}
+```
+
+#### 3. Journal/Changelog Comments
+```java
+// ❌ BAD: Use git history
+/**
+ * Change history:
+ * 2024-01-01: Created by John
+ * 2024-01-15: Fixed bug - Jane
+ */
+```
+
+#### 4. Noise Comments
+```java
+// ❌ BAD: Adds no value
+/**
+ * Default constructor.
+ */
+public MyClass() {}
+
+/**
+ * Gets the id.
+ * @return the id
+ */
+public Long getId() { return id; }
+```
+
+#### 5. Misleading Comments
+```java
+// ❌ BAD: Comment lies about what method does
+// Returns the user (but actually modifies database!)
+public User getUser(Long id) {
+    User user = repository.find(id);
+    user.setLastAccess(now()); // Not mentioned in comment!
+    repository.save(user);
+    return user;
+}
+```
+
+### TODO/FIXME Format
+```java
+// TODO(username): Brief description - TICKET-123
+// FIXME: Description of bug - TICKET-456
+// HACK: Temporary workaround - remove after TICKET-789
+// WARNING: Important caution
+// NOTE: Important context
+```
+
+### Comment Language
+- Code comments: English
+- Commit messages: English
+</comment_standards>
+
+<versioning>
+## Semantic Versioning
+
+Format: `MAJOR.MINOR.PATCH[-PRERELEASE]`
+
+| Bump | When | Example |
+|------|------|---------|
+| MAJOR | Breaking changes | 1.x.x → 2.0.0 |
+| MINOR | New features (backward compatible) | 1.1.x → 1.2.0 |
+| PATCH | Bug fixes (backward compatible) | 1.1.1 → 1.1.2 |
+
+### Pre-release Labels
+- `alpha` : Feature incomplete
+- `beta` : Feature complete, may have bugs
+- `rc` : Release candidate
+
+### Version Bump Triggers
+```yaml
+patch:
+  - Bug fix
+  - Documentation update
+  - Dependency patch
+
+minor:
+  - New feature
+  - New API endpoint
+  - Deprecation (not removal)
+
+major:
+  - Breaking API change
+  - Removed feature
+  - Breaking schema change
+```
+
+Reference: https://semver.org/
+</versioning>
+
+<git_conventions>
+## Git Conventions
+
+### Commit Message Format
+```
+<type>(<scope>): <subject>
+
+[optional body]
+
+[optional footer]
+```
+
+### Types
+| Type | Description | Version |
+|------|-------------|---------|
+| `feat` | New feature | MINOR |
+| `fix` | Bug fix | PATCH |
+| `docs` | Documentation | - |
+| `style` | Formatting | - |
+| `refactor` | Code change, no feature/fix | - |
+| `perf` | Performance | PATCH |
+| `test` | Tests | - |
+| `build` | Build system | - |
+| `ci` | CI config | - |
+| `chore` | Maintenance | - |
+
+### Scopes
+{{GIT_SCOPES}}
+
+### Breaking Changes
+```
+feat(api)!: change endpoint response format
+
+BREAKING CHANGE: Response now includes nested object
+```
+
+### Examples
+```bash
+feat(user): add email verification
+fix(auth): resolve token expiration issue
+docs(readme): update installation steps
+refactor(service): extract validation logic
+```
+
+Reference: https://www.conventionalcommits.org/
+</git_conventions>
+
+<changelog_standards>
+## Changelog Standards
+
+Format: [Keep a Changelog](https://keepachangelog.com/)
+
+### Categories (in order)
+1. **Added** - New features
+2. **Changed** - Changes in existing functionality
+3. **Deprecated** - Soon-to-be removed features
+4. **Removed** - Removed features
+5. **Fixed** - Bug fixes
+6. **Security** - Vulnerability fixes
+
+### Entry Format
+```markdown
+- Brief description ([#123](link))
+```
+
+### Auto-update Mapping
+```yaml
+feat → Added
+fix → Fixed
+BREAKING CHANGE → Changed
+deprecate → Deprecated
+remove → Removed
+security → Security
+```
+</changelog_standards>
+
+<contributor_standards>
+## Contributor Standards
+
+### Attribution
+- All contributors in CONTRIBUTORS.md
+- Commit co-authors for pair programming
+- Release notes credit
+
+### Contribution Types
+| Emoji | Type |
+|-------|------|
+| 💻 | Code |
+| 📖 | Documentation |
+| 🐛 | Bug Reports |
+| 💡 | Ideas |
+| 🔍 | Review |
+| 🧪 | Testing |
+</contributor_standards>
+
+<quality_gates>
+## Quality Gates
+
+### Task Completion
+- [ ] All acceptance criteria met
+- [ ] Automated tests pass
+- [ ] No lint errors
+- [ ] Code review (for L/XL tasks)
+
+### Phase Completion
+- [ ] All tasks done or skipped (with reason)
+- [ ] Phase verification pass
+- [ ] No active blockers
+- [ ] Documentation updated
+
+### Milestone Completion
+- [ ] All phases complete
+- [ ] E2E tests pass
+- [ ] Security scan clean
+- [ ] Documentation complete
+</quality_gates>
+
+<do_not>
+## Forbidden Patterns
+
+### Code
+- ❌ Do NOT hardcode credentials
+- ❌ Do NOT catch generic Exception
+- ❌ Do NOT use Thread.sleep() in production
+- ❌ Do NOT ignore compiler warnings
+- ❌ Do NOT commit commented-out code
+
+### Architecture
+{{FORBIDDEN_ARCHITECTURE_PATTERNS}}
+
+### Security
+- ❌ Do NOT log sensitive data
+- ❌ Do NOT store plain-text passwords
+- ❌ Do NOT expose internal IDs in APIs
+- ❌ Do NOT trust user input without validation
+</do_not>

package/templates/project/TRACKER.md

@@ -0,0 +1,50 @@
+# {{PROJECT_NAME}} - Tracker
+
+## Current State
+- **Milestone**: {{MILESTONE_NAME}}
+- **Current Phase**: {{CURRENT_PHASE}}
+- **Current Task**: {{CURRENT_TASK}}
+- **Last Activity**: {{LAST_ACTIVITY}}
+
+## Progress Overview
+```
+Phase 1: {{PHASE_1_NAME}}     [░░░░░░░░░░] 0%
+Phase 2: {{PHASE_2_NAME}}     [░░░░░░░░░░] 0%
+Phase 3: {{PHASE_3_NAME}}     [░░░░░░░░░░] 0%
+─────────────────────────────────────────────
+Overall:                      [░░░░░░░░░░] 0%
+```
+
+## Version Info
+
+### Current Version
+```
+{{VERSION}}
+```
+
+### Version History
+| Version | Date | Milestone | Notes |
+|---------|------|-----------|-------|
+| {{VERSION}} | {{DATE}} | {{MILESTONE_NAME}} | Initial setup |
+
+### Next Version
+```
+Pending changes in [Unreleased]:
+- 0 features
+- 0 fixes
+- 0 breaking changes
+
+Suggested next version: {{VERSION}}
+```
+
+## Decision Log
+
+| Date | Decision | Rationale | Phase |
+|------|----------|-----------|-------|
+| {{DATE}} | Initial architecture | From brainstorm | Setup |
+
+## Blockers
+_None currently_
+
+## Next Action
+**Start Phase 1**: Run `/vp-auto` to begin autonomous execution

package/ui-components/INDEX.md

@@ -0,0 +1,9 @@
+# UI Components Stock Index
+
+Baseline components shipped with ViePilot installation.
+
+| ID | Category | Status | Path |
+|----|----------|--------|------|
+| `base-button-primary` | base | approved | `ui-components/base/button/` |
+| `base-card-elevated` | base | approved | `ui-components/base/card/` |
+| `base-input-text` | base | approved | `ui-components/base/input/` |

package/ui-components/base/button/README.md

@@ -0,0 +1,8 @@
+# base-button-primary
+
+Reusable base button component for directional UI prototypes and quick MVP screens.
+
+## Usage
+- Primary CTA in hero sections
+- Form submit buttons
+- Dialog confirmation actions

package/ui-components/base/button/metadata.json

@@ -0,0 +1,8 @@
+{
+  "id": "base-button-primary",
+  "category": "base",
+  "source": "viepilot-stock",
+  "tags": ["button", "cta", "base"],
+  "stack_notes": "Use semantic <button> and visible focus state.",
+  "status": "approved"
+}

package/ui-components/base/card/README.md

@@ -0,0 +1,8 @@
+# base-card-elevated
+
+Container card for grouping related content blocks in dashboard and landing layouts.
+
+## Usage
+- Feature cards
+- Stats modules
+- Settings sections

package/ui-components/base/card/metadata.json

@@ -0,0 +1,8 @@
+{
+  "id": "base-card-elevated",
+  "category": "base",
+  "source": "viepilot-stock",
+  "tags": ["card", "container", "base"],
+  "stack_notes": "Keep spacing tokenized and radius consistent with design system.",
+  "status": "approved"
+}