viepilot 1.0.0

package/templates/project/AI-GUIDE.md

@@ -0,0 +1,114 @@
+# {{PROJECT_NAME}} - AI Navigation Guide
+
+> **Đọc file này TRƯỚC KHI làm bất kỳ task nào**
+> File này giúp bạn tìm đúng context mà không cần load tất cả
+
+## Quick Lookup
+
+| Tôi cần... | Đọc file | Section |
+|------------|----------|---------|
+| Hiểu project làm gì | `PROJECT-CONTEXT.md` | `<domain_knowledge>` |
+| Biết tech stack | `ARCHITECTURE.md` | `## Technology Decisions` |
+| Xem service nào làm gì | `ARCHITECTURE.md` | `## Services` |
+| Biết đang ở phase nào | `TRACKER.md` | `## Current State` |
+| Xem task tiếp theo | `ROADMAP.md` | Tìm phase đang `In Progress` |
+| Coding conventions | `SYSTEM-RULES.md` | `<coding_rules>` |
+| Những gì KHÔNG được làm | `SYSTEM-RULES.md` | `<do_not>` |
+| Database schema | `schemas/database-schema.sql` | - |
+| API contracts | `schemas/api-contracts.yaml` | - |
+| Decisions đã quyết định | `TRACKER.md` | `## Decision Log` |
+| Resume công việc dở | `HANDOFF.json` | - |
+| Package structure | `PROJECT-META.md` | `## Package Structure` |
+| File headers | `PROJECT-META.md` | `## File Headers` |
+
+## Context Loading Strategy
+
+### Minimal Context (cho quick tasks)
+```
+Chỉ đọc:
+1. AI-GUIDE.md (file này)
+2. TRACKER.md → Current State
+3. File cụ thể liên quan đến task
+```
+
+### Standard Context (cho coding tasks)
+```
+Đọc theo thứ tự:
+1. AI-GUIDE.md (file này)
+2. TRACKER.md → biết đang ở đâu
+3. ROADMAP.md → task hiện tại
+4. SYSTEM-RULES.md → coding rules
+5. Schema file nếu cần
+```
+
+### Full Context (cho architecture decisions)
+```
+Đọc thêm:
+1. Standard Context +
+2. ARCHITECTURE.md
+3. PROJECT-CONTEXT.md
+4. Brainstorm session gốc (nếu cần rationale)
+```
+
+## File Relationships
+
+```
+AI-GUIDE.md (đọc đầu tiên)
+     │
+     ├── TRACKER.md (state hiện tại)
+     │      └── points to → current phase in ROADMAP.md
+     │
+     ├── ROADMAP.md (what to do)
+     │      └── tasks reference → schemas/
+     │
+     ├── SYSTEM-RULES.md (how to code)
+     │      └── rules reference → ARCHITECTURE.md
+     │
+     ├── ARCHITECTURE.md (system design)
+     │      └── decisions from → PROJECT-CONTEXT.md
+     │
+     └── PROJECT-CONTEXT.md (domain knowledge)
+            └── extracted from → docs/brainstorm/
+```
+
+## When Creating New Files
+
+1. Read `PROJECT-META.md#file-headers` for correct header
+2. Use package from `PROJECT-META.md#package-structure`
+3. Add @author tag from `PROJECT-META.md#lead-developer`
+4. Follow `SYSTEM-RULES.md#coding_rules`
+5. Follow `SYSTEM-RULES.md#comment_standards`
+
+## Comment Rules Quick Reference
+
+| ✅ DO | ❌ DON'T |
+|-------|----------|
+| Explain WHY | State the obvious |
+| Document business rules | Comment out dead code |
+| Warn about side effects | Write misleading comments |
+| Explain complex logic | Add noise comments |
+| Add TODO with ticket | Write journal comments |
+
+Full guidelines: `SYSTEM-RULES.md#comment_standards`
+
+## Khi Nào Cần Đọc Lại
+
+| Trigger | Cần refresh |
+|---------|-------------|
+| Bắt đầu session mới | `TRACKER.md`, `HANDOFF.json` |
+| Chuyển phase | `ROADMAP.md` section của phase mới |
+| Gặp lỗi architecture | `ARCHITECTURE.md`, `SYSTEM-RULES.md` |
+| Không rõ business rule | `PROJECT-CONTEXT.md` |
+| Cần quyết định mới | `TRACKER.md` → Decision Log |
+
+## Commands Reference
+
+| Command | Dùng khi |
+|---------|----------|
+| `/vp-status` | Xem progress nhanh |
+| `/vp-auto` | Chạy autonomous |
+| `/vp-pause` | Dừng, lưu state |
+| `/vp-resume` | Tiếp tục từ pause |
+| `/vp-evolve` | Thêm features/milestone mới |
+| `/vp-docs` | Generate documentation |
+| `/vp-task` | Quản lý task thủ công |

package/templates/project/ARCHITECTURE.md

@@ -0,0 +1,70 @@
+# {{PROJECT_NAME}} - Architecture
+
+## System Overview
+
+{{SYSTEM_OVERVIEW_DESCRIPTION}}
+
+```
+{{SYSTEM_DIAGRAM}}
+```
+
+## Services
+
+{{#SERVICES}}
+### {{SERVICE_NAME}}
+- **Purpose**: {{SERVICE_PURPOSE}}
+- **Inputs**: {{SERVICE_INPUTS}}
+- **Outputs**: {{SERVICE_OUTPUTS}}
+- **Dependencies**: {{SERVICE_DEPENDENCIES}}
+- **API**: {{SERVICE_API_TYPE}}
+- **Scaling**: {{SERVICE_SCALING}}
+{{/SERVICES}}
+
+## Data Flow
+
+```
+{{DATA_FLOW_DIAGRAM}}
+```
+
+## Integration Points
+
+| Service A | Service B | Protocol | Endpoint/Topic |
+|-----------|-----------|----------|----------------|
+{{INTEGRATION_POINTS}}
+
+## Technology Decisions
+
+| Decision | Choice | Rationale | Alternatives Considered |
+|----------|--------|-----------|------------------------|
+{{TECHNOLOGY_DECISIONS}}
+
+## Database Architecture
+
+### Primary Database
+- **Type**: {{DB_TYPE}}
+- **Purpose**: {{DB_PURPOSE}}
+
+### Cache
+- **Type**: {{CACHE_TYPE}}
+- **Purpose**: {{CACHE_PURPOSE}}
+
+## Security Architecture
+
+### Authentication
+{{AUTH_DESCRIPTION}}
+
+### Authorization
+{{AUTHZ_DESCRIPTION}}
+
+## Deployment Architecture
+
+```
+{{DEPLOYMENT_DIAGRAM}}
+```
+
+## Monitoring & Observability
+
+- **Logging**: {{LOGGING_SOLUTION}}
+- **Metrics**: {{METRICS_SOLUTION}}
+- **Tracing**: {{TRACING_SOLUTION}}
+- **Alerting**: {{ALERTING_SOLUTION}}

package/templates/project/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial project setup via ViePilot
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+---
+
+## [{{VERSION}}] - {{DATE}}
+
+### Added
+- Project initialization
+- Architecture documentation
+- Development roadmap
+- Coding standards and guidelines
+
+---
+
+[Unreleased]: {{REPOSITORY_URL}}/compare/v{{VERSION}}...HEAD
+[{{VERSION}}]: {{REPOSITORY_URL}}/releases/tag/v{{VERSION}}

package/templates/project/CONTRIBUTING.md

@@ -0,0 +1,154 @@
+# Contributing to {{PROJECT_NAME}}
+
+Thank you for your interest in contributing! This document provides guidelines and standards for contributing to the project.
+
+## Table of Contents
+- [Code of Conduct](#code-of-conduct)
+- [Getting Started](#getting-started)
+- [Development Workflow](#development-workflow)
+- [Commit Guidelines](#commit-guidelines)
+- [Pull Request Process](#pull-request-process)
+- [Code Standards](#code-standards)
+- [Recognition](#recognition)
+
+---
+
+## Code of Conduct
+
+We are committed to providing a welcoming and inclusive environment. Please be respectful and constructive in all interactions.
+
+---
+
+## Getting Started
+
+### Prerequisites
+{{PREREQUISITES}}
+
+### Setup
+```bash
+# Clone repository
+git clone {{REPOSITORY_URL}}
+cd {{ARTIFACT_ID}}
+
+# Setup instructions
+{{SETUP_INSTRUCTIONS}}
+```
+
+---
+
+## Development Workflow
+
+### Branch Naming
+```
+<type>/<short-description>
+
+Examples:
+- feat/user-authentication
+- fix/login-bug
+- docs/api-reference
+```
+
+### Workflow
+1. Create branch from `main` or `develop`
+2. Make changes with atomic commits
+3. Write/update tests
+4. Create Pull Request
+5. Pass CI checks
+6. Get review approval
+7. Squash and merge
+
+---
+
+## Commit Guidelines
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/).
+
+### Format
+```
+<type>(<scope>): <subject>
+
+[optional body]
+
+[optional footer]
+```
+
+### Types
+| Type | Description |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation |
+| `style` | Formatting |
+| `refactor` | Code refactoring |
+| `test` | Tests |
+| `chore` | Maintenance |
+
+### Examples
+```bash
+feat(auth): add JWT token refresh
+fix(api): resolve null pointer in user service
+docs(readme): update installation steps
+```
+
+---
+
+## Pull Request Process
+
+### PR Title Format
+Same as commit message: `<type>(<scope>): <description>`
+
+### PR Checklist
+- [ ] Code follows project style guidelines
+- [ ] Self-review performed
+- [ ] Tests added/updated
+- [ ] Documentation updated
+- [ ] No new warnings
+- [ ] All tests pass
+
+### Review Criteria
+- Code quality and readability
+- Test coverage
+- Documentation
+- Performance impact
+- Security considerations
+
+---
+
+## Code Standards
+
+Please refer to [SYSTEM-RULES.md](/.viepilot/SYSTEM-RULES.md) for complete coding standards including:
+
+- Architecture rules
+- Coding conventions
+- Comment standards
+- Testing requirements
+
+---
+
+## Recognition
+
+### How We Recognize Contributors
+
+1. **CONTRIBUTORS.md** - All contributors listed
+2. **Commit Co-authors** - For pair programming
+3. **Release Notes** - Credits for significant contributions
+
+### Contribution Types
+| Emoji | Type |
+|-------|------|
+| 💻 | Code |
+| 📖 | Documentation |
+| 🐛 | Bug Reports |
+| 💡 | Ideas |
+| 🔍 | Code Review |
+| 🧪 | Testing |
+
+---
+
+## Questions?
+
+- Open an issue for bugs/features
+- Start a discussion for questions
+- Contact: {{LEAD_DEVELOPER_EMAIL}}
+
+Thank you for contributing! 🙏

package/templates/project/CONTRIBUTORS.md

@@ -0,0 +1,41 @@
+# Contributors
+
+This project exists thanks to all the people who contribute.
+
+## Maintainers
+
+| Name | Role | GitHub | Since |
+|------|------|--------|-------|
+| {{LEAD_DEVELOPER_NAME}} | Project Lead | [@{{LEAD_DEVELOPER_GITHUB}}](https://github.com/{{LEAD_DEVELOPER_GITHUB}}) | {{INCEPTION_YEAR}} |
+
+## Contributors
+
+<!-- ALL-CONTRIBUTORS-LIST:START -->
+| Avatar | Name | Contributions |
+|--------|------|---------------|
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+## Contribution Legend
+
+| Emoji | Type |
+|-------|------|
+| 💻 | Code |
+| 📖 | Documentation |
+| 🐛 | Bug reports |
+| 💡 | Ideas & Planning |
+| 🔍 | Code Review |
+| 🧪 | Testing |
+| 🎨 | Design |
+| 🚧 | Maintenance |
+
+---
+
+## How to Add Yourself
+
+After your PR is merged, add yourself to this file:
+
+```markdown
+| <img src="your_avatar_url" width="50"> | Your Name | 💻 |
+```
+
+Or maintainers will add you during release preparation.

package/templates/project/PROJECT-CONTEXT.md

@@ -0,0 +1,74 @@
+# {{PROJECT_NAME}} - Project Context
+
+<domain_knowledge>
+## What This System Does
+
+{{SYSTEM_DESCRIPTION}}
+
+## Key Concepts
+
+| Term | Definition |
+|------|------------|
+{{KEY_CONCEPTS}}
+
+## Business Rules
+
+{{BUSINESS_RULES}}
+
+## Data Relationships
+
+{{DATA_RELATIONSHIPS}}
+</domain_knowledge>
+
+<conventions>
+## Naming Conventions
+
+### Code
+- Classes: PascalCase
+- Methods: camelCase
+- Constants: UPPER_SNAKE_CASE
+- Database tables: snake_case
+
+### Project Specific
+{{PROJECT_SPECIFIC_CONVENTIONS}}
+
+## Code Patterns
+
+### Preferred Patterns
+{{PREFERRED_PATTERNS}}
+
+### Anti-patterns to Avoid
+{{ANTI_PATTERNS}}
+</conventions>
+
+<constraints>
+## Must Have
+
+{{MUST_HAVE_CONSTRAINTS}}
+
+## Must NOT
+
+{{MUST_NOT_CONSTRAINTS}}
+
+## Performance Requirements
+
+{{PERFORMANCE_REQUIREMENTS}}
+
+## Security Requirements
+
+{{SECURITY_REQUIREMENTS}}
+</constraints>
+
+<external_dependencies>
+## Third-party Services
+
+| Service | Purpose | Documentation |
+|---------|---------|---------------|
+{{EXTERNAL_SERVICES}}
+
+## Libraries & Frameworks
+
+| Library | Version | Purpose |
+|---------|---------|---------|
+{{LIBRARIES}}
+</external_dependencies>

package/templates/project/PROJECT-META.md

@@ -0,0 +1,133 @@
+# {{PROJECT_NAME}} - Project Metadata
+
+> File này chứa thông tin cơ bản về dự án.
+> AI đọc file này để generate đúng package, headers, attribution.
+
+## Project Info
+
+| Field | Value |
+|-------|-------|
+| **Name** | {{PROJECT_NAME}} |
+| **Description** | {{PROJECT_DESCRIPTION}} |
+| **Inception Year** | {{INCEPTION_YEAR}} |
+| **License** | {{LICENSE}} |
+
+## Organization
+
+| Field | Value |
+|-------|-------|
+| **Name** | {{ORGANIZATION_NAME}} |
+| **Website** | {{ORGANIZATION_URL}} |
+
+## Package Structure
+
+| Field | Value |
+|-------|-------|
+| **Base Package** | `{{PACKAGE_BASE_ID}}` |
+| **Group ID** | `{{GROUP_ID}}` |
+| **Artifact ID** | `{{ARTIFACT_ID}}` |
+
+### Module Packages
+```
+{{PACKAGE_BASE_ID}}
+├── common          # Shared modules
+│   ├── model       # Shared entities, DTOs
+│   └── util        # Shared utilities
+├── {{MODULE_1}}    # Module 1
+│   ├── controller
+│   ├── service
+│   ├── mapper
+│   └── ...
+├── {{MODULE_2}}    # Module 2
+└── ...
+```
+
+## Developers
+
+### Lead Developer
+| Field | Value |
+|-------|-------|
+| **Name** | {{LEAD_DEVELOPER_NAME}} |
+| **Email** | {{LEAD_DEVELOPER_EMAIL}} |
+| **GitHub** | [@{{LEAD_DEVELOPER_GITHUB}}](https://github.com/{{LEAD_DEVELOPER_GITHUB}}) |
+| **Role** | Project Lead, Core Developer |
+
+### Contributors
+See [CONTRIBUTORS.md](/CONTRIBUTORS.md)
+
+## Repository
+
+| Field | Value |
+|-------|-------|
+| **URL** | {{REPOSITORY_URL}} |
+| **Issues** | {{ISSUE_TRACKER_URL}} |
+| **CI/CD** | {{CI_CD_SYSTEM}} |
+
+## File Headers
+
+### Java File Header
+```java
+/*
+ * {{PROJECT_NAME}}
+ * Copyright (c) {{INCEPTION_YEAR}} {{ORGANIZATION_NAME}}
+ *
+ * Licensed under the {{LICENSE}} License.
+ * See LICENSE file in the project root for full license information.
+ */
+```
+
+### SQL File Header
+```sql
+-- {{PROJECT_NAME}}
+-- Copyright (c) {{INCEPTION_YEAR}} {{ORGANIZATION_NAME}}
+-- Licensed under {{LICENSE}} License
+```
+
+### Configuration File Header
+```yaml
+# {{PROJECT_NAME}}
+# Copyright (c) {{INCEPTION_YEAR}} {{ORGANIZATION_NAME}}
+```
+
+### Shell Script Header
+```bash
+#!/bin/bash
+# {{PROJECT_NAME}}
+# Copyright (c) {{INCEPTION_YEAR}} {{ORGANIZATION_NAME}}
+# Licensed under {{LICENSE}} License
+```
+
+## Author Tag (for Javadoc)
+```java
+/**
+ * Description of the class.
+ *
+ * @author {{LEAD_DEVELOPER_NAME}}
+ * @since {{VERSION}}
+ */
+```
+
+## Maven POM Template
+```xml
+<groupId>{{GROUP_ID}}</groupId>
+<artifactId>{{ARTIFACT_ID}}</artifactId>
+<version>{{VERSION}}</version>
+
+<name>{{PROJECT_NAME}}</name>
+<description>{{PROJECT_DESCRIPTION}}</description>
+<url>{{REPOSITORY_URL}}</url>
+<inceptionYear>{{INCEPTION_YEAR}}</inceptionYear>
+
+<organization>
+    <name>{{ORGANIZATION_NAME}}</name>
+    <url>{{ORGANIZATION_URL}}</url>
+</organization>
+
+<developers>
+    <developer>
+        <id>{{LEAD_DEVELOPER_GITHUB}}</id>
+        <name>{{LEAD_DEVELOPER_NAME}}</name>
+        <email>{{LEAD_DEVELOPER_EMAIL}}</email>
+    </developer>
+</developers>
+```