anchi-toolkit 1.2.0 → 1.2.1

package/dist/.cursor/workflows/documentation-management.md

@@ -0,0 +1,121 @@
+# Project Documentation Management
+
+### Roadmap & Changelog Maintenance
+- **Project Roadmap** (`./docs/development-roadmap.md`): Living document tracking project phases, milestones, and progress
+- **Project Changelog** (`./docs/project-changelog.md`): Detailed record of all significant changes, features, and fixes
+- **System Architecture** (`./docs/system-architecture.md`): Detailed record of all significant changes, features, and fixes
+- **Code Standards** (`./docs/code-standards.md`): Detailed record of all significant changes, features, and fixes
+
+### Automatic Updates Required
+- **After Feature Implementation**: Update roadmap progress status and changelog entries
+- **After Major Milestones**: Review and adjust roadmap phases, update success metrics
+- **After Bug Fixes**: Document fixes in changelog with severity and impact
+- **After Security Updates**: Record security improvements and version updates
+- **Weekly Reviews**: Update progress percentages and milestone statuses
+
+### Documentation Triggers
+The `project-manager` agent MUST update these documents when:
+- A development phase status changes (e.g., from "In Progress" to "Complete")
+- Major features are implemented or released
+- Significant bugs are resolved or security patches applied
+- Project timeline or scope adjustments are made
+- External dependencies or breaking changes occur
+
+### Update Protocol
+1. **Before Updates**: Always read current roadmap and changelog status
+2. **During Updates**: Maintain version consistency and proper formatting
+3. **After Updates**: Verify links, dates, and cross-references are accurate
+4. **Quality Check**: Ensure updates align with actual implementation progress
+
+### Plans
+
+### Plan Location
+Save plans in `./plans` directory with timestamp and descriptive name.
+
+**Format:** `plans/YYYYMMDD-HHmm-your-plan-name/`
+
+**Example:** `plans/20251101-1505-authentication-and-profile-implementation/`
+
+#### File Organization
+
+```
+plans/
+├── 20251101-1505-authentication-and-profile-implementation/
+    ├── research/
+    │   ├── researcher-XX-report.md
+    │   └── ...
+│   ├── reports/
+│   │   ├── scout-report.md
+│   │   ├── researcher-report.md
+│   │   └── ...
+│   ├── plan.md                                # Overview access point
+│   ├── phase-01-setup-environment.md          # Setup environment
+│   ├── phase-02-implement-database.md         # Database models
+│   ├── phase-03-implement-api-endpoints.md    # API endpoints
+│   ├── phase-04-implement-ui-components.md    # UI components
+│   ├── phase-05-implement-authentication.md   # Auth & authorization
+│   ├── phase-06-implement-profile.md          # Profile page
+│   └── phase-07-write-tests.md                # Tests
+└── ...
+```
+
+#### File Structure
+
+##### Overview Plan (plan.md)
+- Keep generic and under 80 lines
+- List each phase with status/progress
+- Link to detailed phase files
+- Key dependencies
+
+##### Phase Files (phase-XX-name.md)
+Fully respect the `./docs/development-rules.md` file.
+Each phase file should contain:
+
+**Context Links**
+- Links to related reports, files, documentation
+
+**Overview**
+- Priority
+- Current status
+- Brief description
+
+**Key Insights**
+- Important findings from research
+- Critical considerations
+
+**Requirements**
+- Functional requirements
+- Non-functional requirements
+
+**Architecture**
+- System design
+- Component interactions
+- Data flow
+
+**Related Code Files**
+- List of files to modify
+- List of files to create
+- List of files to delete
+
+**Implementation Steps**
+- Detailed, numbered steps
+- Specific instructions
+
+**Todo List**
+- Checkbox list for tracking
+
+**Success Criteria**
+- Definition of done
+- Validation methods
+
+**Risk Assessment**
+- Potential issues
+- Mitigation strategies
+
+**Security Considerations**
+- Auth/authorization
+- Data protection
+
+**Next Steps**
+- Dependencies
+- Follow-up tasks

package/dist/.cursor/workflows/feature.yaml

@@ -0,0 +1,51 @@
+# Feature Workflow
+# Standard flow for new features
+# ═══════════════════════════════════════════════════════════════
+
+name: Feature Development
+description: Standard workflow for new features
+
+# Steps to follow
+steps:
+  1_plan:
+    command: /plan
+    required: true
+    auto_proceed: false
+    description: Create detailed plan
+    
+  2_approve:
+    type: approval
+    required: true
+    approvers: [lead]
+    description: Get plan approval
+    
+  3_implement:
+    command: /cook
+    required: true
+    auto_proceed: false
+    description: Implement feature
+    
+  4_test:
+    command: /test
+    required: true
+    auto_proceed: true
+    description: Run tests
+    
+  5_review:
+    command: /review
+    required: true
+    auto_proceed: false
+    description: Code review
+    
+  6_commit:
+    command: git commit
+    required: true
+    auto_proceed: false
+    description: Commit changes
+
+# Checklist before completion
+checklist:
+  - Tests passing
+  - Code reviewed
+  - Docs updated
+  - No console.log

package/dist/.cursor/workflows/hotfix.yaml

@@ -0,0 +1,35 @@
+# Hotfix Workflow
+# Fast track for critical fixes
+# ═══════════════════════════════════════════════════════════════
+
+name: Hotfix
+description: Fast workflow for critical bug fixes
+
+# Steps - minimal for speed
+steps:
+  1_fix:
+    command: /fix:fast
+    required: true
+    auto_proceed: true
+    description: Quick fix
+    
+  2_test:
+    command: /test
+    required: true
+    auto_proceed: true
+    description: Verify fix
+    
+  3_commit:
+    command: git commit
+    required: true
+    auto_proceed: false
+    description: Commit with hotfix tag
+
+# No approval needed for hotfixes
+approval:
+  required: false
+
+# Quick checklist
+checklist:
+  - Fix verified
+  - No regressions

package/dist/.cursor/workflows/orchestration-protocol.md

@@ -0,0 +1,16 @@
+# Orchestration Protocol
+
+#### Sequential Chaining
+Chain subagents when tasks have dependencies or require outputs from previous steps:
+- **Planning → Implementation → Testing → Review**: Use for feature development
+- **Research → Design → Code → Documentation**: Use for new system components
+- Each agent completes fully before the next begins
+- Pass context and outputs between agents in the chain
+
+#### Parallel Execution
+Spawn multiple subagents simultaneously for independent tasks:
+- **Code + Tests + Docs**: When implementing separate, non-conflicting components
+- **Multiple Feature Branches**: Different agents working on isolated features
+- **Cross-platform Development**: iOS and Android specific implementations
+- **Careful Coordination**: Ensure no file conflicts or shared resource contention
+- **Merge Strategy**: Plan integration points before parallel execution begins

package/dist/.cursor/workflows/primary-workflow.md

@@ -0,0 +1,45 @@
+# Primary Workflow
+
+**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
+**IMPORTANT**: Ensure token efficiency while maintaining high quality.
+
+#### 1. Code Implementation
+- Before you start, delegate to `planner` agent to create a implementation plan with TODO tasks in `./plans` directory.
+- When in planning phase, use multiple `researcher` agents in parallel to conduct research on different relevant technical topics and report back to `planner` agent to create implementation plan.
+- Write clean, readable, and maintainable code
+- Follow established architectural patterns
+- Implement features according to specifications
+- Handle edge cases and error scenarios
+- **DO NOT** create new enhanced files, update to the existing files directly.
+- **[IMPORTANT]** After creating or modifying code file, run compile command/script to check for any compile errors.
+
+#### 2. Testing
+- Delegate to `tester` agent to run tests and analyze the summary report.
+  - Write comprehensive unit tests
+  - Ensure high code coverage
+  - Test error scenarios
+  - Validate performance requirements
+- Tests are critical for ensuring code quality and reliability, **DO NOT** ignore failing tests just to pass the build.
+- **IMPORTANT:** make sure you don't use fake data, mocks, cheats, tricks, temporary solutions, just to pass the build or github actions.
+- **IMPORTANT:** Always fix failing tests follow the recommendations and delegate to `tester` agent to run tests again, only finish your session when all tests pass.
+
+#### 3. Code Quality
+- After finish implementation, delegate to `code-reviewer` agent to review code.
+- Follow coding standards and conventions
+- Write self-documenting code
+- Add meaningful comments for complex logic
+- Optimize for performance and maintainability
+
+#### 4. Integration
+- Always follow the plan given by `planner` agent
+- Ensure seamless integration with existing code
+- Follow API contracts precisely
+- Maintain backward compatibility
+- Document breaking changes
+- Delegate to `docs-manager` agent to update docs in `./docs` directory if any.
+
+#### 5. Debugging
+- When a user report bugs or issues on the server or a CI/CD pipeline, delegate to `debugger` agent to run tests and analyze the summary report.
+- Read the summary report from `debugger` agent and implement the fix.
+- Delegate to `tester` agent to run tests and analyze the summary report.
+- If the `tester` agent reports failed tests, fix them follow the recommendations and repeat from the **Step 2**.

package/dist/.cursor/workflows/release.yaml

@@ -0,0 +1,61 @@
+# Release Workflow
+# Structured flow for releases
+# ═══════════════════════════════════════════════════════════════
+
+name: Release
+description: Workflow for version releases
+
+# Steps
+steps:
+  1_summary:
+    command: /summary
+    required: true
+    auto_proceed: true
+    description: Update project summary
+    
+  2_changelog:
+    command: /docs:update
+    required: true
+    auto_proceed: true
+    description: Update changelog
+    
+  3_test:
+    command: /test:all
+    required: true
+    auto_proceed: false
+    description: Full test suite
+    
+  4_review:
+    command: /review:codebase
+    required: true
+    auto_proceed: false
+    description: Final review
+    
+  5_version:
+    type: manual
+    required: true
+    description: Bump version number
+    
+  6_tag:
+    command: git tag
+    required: true
+    auto_proceed: false
+    description: Create release tag
+    
+  7_publish:
+    type: manual
+    required: true
+    description: Publish/deploy
+
+# Approval required
+approval:
+  required: true
+  approvers: [lead]
+
+# Release checklist
+checklist:
+  - All tests passing
+  - Changelog updated
+  - Version bumped
+  - Tag created
+  - Docs updated

package/dist/.cursorrules

@@ -0,0 +1,106 @@
+# Rapid MVP - Cursor Rules
+
+> **Mode:** Rapid Development - Ưu tiên tốc độ, code đơn giản, ship nhanh.
+
+---
+
+## ⚠️ SAFETY RULES (CRITICAL)
+
+> **Toolkit này TÔN TRỌNG codebase của bạn. AI KHÔNG được tự ý thay đổi.**
+
+| Rule | Mô tả |
+|------|-------|
+| 🚫 **NEVER auto-implement** | Luôn hỏi trước khi viết code |
+| 👀 **ALWAYS preview** | Show kế hoạch/diff trước khi thực hiện |
+| 🏗️ **RESPECT structure** | Không tự ý refactor/reorganize |
+| ⚠️ **CONFIRM destructive** | Hỏi trước khi delete/overwrite/rename |
+| 🚀 **NO auto-push** | Không git push nếu không được cho phép |
+
+**Workflow bắt buộc:**
+```
+1. AI đề xuất → 2. User review → 3. User confirm → 4. AI thực hiện
+```
+
+---
+
+## Tech Stack
+
+- **Framework:** Next.js 14 (App Router)
+- **Language:** TypeScript
+- **Database:** SQLite + Prisma
+- **Auth:** NextAuth.js
+- **UI:** shadcn/ui + TailwindCSS
+- **Deploy:** Vercel
+
+---
+
+## Project Structure
+
+```
+src/
+├── app/              # Pages + API
+├── components/       # UI components
+│   ├── ui/           # shadcn/ui
+│   └── features/     # Feature components
+├── lib/              # Utilities
+├── hooks/            # Custom hooks
+└── types/            # TypeScript types
+```
+
+---
+
+## Coding Style
+
+### Keep It Simple
+- Logic trong Server Components OK
+- API routes inline validation OK
+- Không cần tách services layer
+
+### Components
+- Functional components only
+- Props interface cùng file
+- Co-locate styles với component
+
+### Data Fetching
+- Server Components cho static data
+- Route Handlers cho mutations
+- React Query nếu cần client-side
+
+---
+
+## DO NOT
+
+- ❌ Over-engineer với nhiều layers
+- ❌ Premature optimization
+- ❌ Complex state management (unless needed)
+- ❌ Microservices architecture
+
+---
+
+## DO
+
+- ✅ Ship fast, iterate later
+- ✅ Use shadcn/ui components
+- ✅ Keep files small (< 200 lines)
+- ✅ Write basic tests for critical paths
+
+---
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/plan` | Quick plan (keep simple) |
+| `/cook` | Implement feature |
+| `/design-ui` | Design component |
+
+---
+
+## Migration Ready
+
+Code được viết sẵn để dễ migrate:
+- Prisma schema → PostgreSQL compatible
+- Components → Reusable
+- Types → Shared interfaces
+
+> Khi cần scale: `/migrate-to professional`

package/dist/ANTIGRAVITY.md

@@ -0,0 +1,84 @@
+# ANTIGRAVITY.md
+
+**Hướng dẫn dành cho Gemini Antigravity** - "Simple Interface, Powerful Execution"
+
+---
+
+## 🎯 Triết Lý Cốt Lỗi
+
+**"LESS BUT QUALITY"**: User chỉ cần ra lệnh đơn giản. AI chịu trách nhiệm xử lý phức tạp bên dưới.
+
+### 3 Lệnh Chính (The Only Commands You Need)
+
+| Lệnh       | Chức năng              | Ví dụ                                           |
+| ---------- | ---------------------- | ----------------------------------------------- |
+| **/start** | Khởi tạo dự án         | `/start` (AI tự detect stack & preset)          |
+| **/do**    | **Làm tất cả mọi thứ** | `/do "Fix bug login"`, `/do "Design dashboard"` |
+| **/demo**  | Xem demo dự án         | `/demo` (Auto run localhost)                    |
+| **/clean** | Dọn dẹp bộ nhớ         | `/clean` (Khi AI mất context)                   |
+
+---
+
+## 🎙️ Professional Reporting (Giao tiếp hiệu quả)
+
+Thay vì spam log kỹ thuật ("Loading...", "Reading..."), AI sử dụng format **Selective Transparency** (Minh bạch có chọn lọc).
+
+**Mẫu Báo Cáo Chuẩn:**
+
+> **🎯 Goal:** Fix bug login fail
+>
+> **🤖 Team:** `Debugger` (Root cause) → `Fullstack Dev` (Implementation)
+> **🛡️ Risk Check:** Low (Local UI fix only)
+>
+> **📝 Changes:**
+> • `src/auth/hooks/useLogin.ts`: Thêm `try/catch` block.
+> • `src/components/LoginForm.tsx`: Hiển thị thông báo lỗi chi tiết.
+>
+> **✅ Result:** Đã fix lỗi crash khi API timeout. User giờ sẽ thấy thông báo thay vì màn hình trắng.
+
+✅ Format này giúp User hiểu **AI nào đang làm việc** và **đã thay đổi gì** mà không bị ngợp.
+
+---
+
+## 🧠 Smart Execution (Trí tuệ Ẩn)
+
+Dù giao diện đơn giản, AI phải **ngầm** thực hiện quy trình phức tạp sau (User không cần thấy):
+
+1.  **Context Loading:**
+    - Project Rule: `.antigravity/docs/PROJECT.md`
+    - User Prefs: `.antigravity/user.yaml` (Optional, gitignored)
+2.  **Orchestration:** Tự động chọn Workflow & Agents từ `.antigravity/workflows/` và `.antigravity/agents/`.
+3.  **Risk Check:** Nếu sửa file nhạy cảm (Auth/Payment), **PHẢI** dừng lại hỏi ý kiến user.
+4.  **Artifacts:** Lưu các tài liệu quan trọng vào `.antigravity/docs/artifacts/`.
+
+### 🚀 Infinite Scalability (Mở Rộng Không Giới Hạn)
+
+Bạn muốn dùng công nghệ mới chưa có trong template?
+
+> **/skill-learn "[Tech Name]"**
+>
+> _Ví dụ: `/skill-learn "Rust Lang"`, `/skill-learn "SvelteKit"`_
+
+AI sẽ tự động:
+
+1.  **Research:** Đọc tài liệu online chuẩn nhất.
+2.  **Synthesize:** Tạo module kiến thức mới vào `.antigravity/skills/`.
+3.  **Apply:** Tự động dùng kiến thức mới cho các task sau này.
+
+---
+
+## ⚠️ Quy Tắc Bắt Buộc
+
+1.  **Không Sáng Tạo Cấu Trúc:** Luôn tuân thủ folder structure của Preset.
+2.  **Hỏi Trước Khi Phá:** Nếu lệnh `/do` gây xóa dữ liệu hoặc đổi kiến trúc -> **CẢNH BÁO USER**.
+3.  **Tự Động Học:** Ghi nhận lỗi sai vào Active Memory để tránh lặp lại.
+
+---
+
+## 📂 Tài Liệu (Khi cần Context sâu)
+
+AI có thể tham khảo (User không cần đọc):
+
+- `.antigravity/docs/` (Project Docs)
+- `.antigravity/workflows/do.md` (Workflow Logic full)
+- `.antigravity/agent-skill-index.yaml` (Capabilities)

package/dist/CURSOR.md

@@ -0,0 +1,84 @@
+# CURSOR.md
+
+**Hướng dẫn dành cho Cursor AI** - "Simple Interface, Powerful Execution"
+
+---
+
+## 🎯 Triết Lý Cốt Lỗi
+
+**"LESS BUT QUALITY"**: User chỉ cần ra lệnh đơn giản. AI chịu trách nhiệm xử lý phức tạp bên dưới.
+
+### 3 Lệnh Chính (The Only Commands You Need)
+
+| Lệnh       | Chức năng              | Ví dụ                                           |
+| ---------- | ---------------------- | ----------------------------------------------- |
+| **/start** | Khởi tạo dự án         | `/start` (AI tự detect stack & preset)          |
+| **/do**    | **Làm tất cả mọi thứ** | `/do "Fix bug login"`, `/do "Design dashboard"` |
+| **/demo**  | Xem demo dự án         | `/demo` (Auto run localhost)                    |
+| **/clean** | Dọn dẹp bộ nhớ         | `/clean` (Khi AI mất context)                   |
+
+---
+
+## 🎙️ Professional Reporting (Giao tiếp hiệu quả)
+
+Thay vì spam log kỹ thuật ("Loading...", "Reading..."), AI sử dụng format **Selective Transparency** (Minh bạch có chọn lọc).
+
+**Mẫu Báo Cáo Chuẩn:**
+
+> **🎯 Goal:** Fix bug login fail
+>
+> **🤖 Team:** `Debugger` (Root cause) → `Fullstack Dev` (Implementation)
+> **🛡️ Risk Check:** Low (Local UI fix only)
+>
+> **📝 Changes:**
+> • `src/auth/hooks/useLogin.ts`: Thêm `try/catch` block.
+> • `src/components/LoginForm.tsx`: Hiển thị thông báo lỗi chi tiết.
+>
+> **✅ Result:** Đã fix lỗi crash khi API timeout. User giờ sẽ thấy thông báo thay vì màn hình trắng.
+
+✅ Format này giúp User hiểu **AI nào đang làm việc** và **đã thay đổi gì** mà không bị ngợp.
+
+---
+
+## 🧠 Smart Execution (Trí tuệ Ẩn)
+
+Dù giao diện đơn giản, AI phải **ngầm** thực hiện quy trình phức tạp sau (User không cần thấy):
+
+1.  **Context Loading:**
+    - Project Rule: `.cursor/docs/PROJECT.md`
+    - User Prefs: `.cursor/user.yaml` (Optional, gitignored) - _Để AI chiều theo gu code của riêng bạn._
+2.  **Orchestration:** Tự động chọn Agent (Dev/Designer/Debugger) dựa trên yêu cầu.
+3.  **Risk Check:** Nếu sửa file nhạy cảm (Auth/Payment), **PHẢI** dừng lại hỏi ý kiến user.
+4.  **Verification:** Tự động chạy test/lint nếu có thể.
+
+### 🚀 Infinite Scalability (Mở Rộng Không Giới Hạn)
+
+Bạn muốn dùng công nghệ mới chưa có trong template?
+
+> **/skill-learn "[Tech Name]"**
+>
+> _Ví dụ: `/skill-learn "Rust Lang"`, `/skill-learn "SvelteKit"`_
+
+AI sẽ tự động:
+
+1.  **Research:** Đọc tài liệu online chuẩn nhất.
+2.  **Synthesize:** Tạo module kiến thức mới vào `.cursor/skills/`.
+3.  **Apply:** Tự động dùng kiến thức mới cho các task sau này.
+
+---
+
+## ⚠️ Quy Tắc Bắt Buộc
+
+1.  **Không Sáng Tạo Cấu Trúc:** Luôn tuân thủ folder structure của Preset đã chọn trong `.cursorrules`.
+2.  **Hỏi Trước Khi Phá:** Nếu lệnh `/do` gây xóa dữ liệu hoặc đổi kiến trúc -> **CẢNH BÁO USER**.
+3.  **Tự Động Học:** Nếu user sửa lại code AI vừa viết -> Ghi nhớ vào "Active Memory" để không sai lại.
+
+---
+
+## 📂 Tài Liệu (Khi cần Context sâu)
+
+AI có thể tham khảo (User không cần đọc):
+
+- `.cursor/docs/` (Project Docs)
+- `.cursor/commands/do.md` (Workflow Logic full)
+- `.cursor/agent-skill-index.yaml` (Capabilities)

package/dist/MODEL_COSTS.md

@@ -0,0 +1,61 @@
+# 💰 Model Cost Guide
+
+## Model Tiers (Chi phí tăng dần)
+
+| Tier | Models | Cost | Khi dùng |
+|------|--------|------|----------|
+| 🟢 **Economy** | Auto, GPT-5.1 Codex Mini | Free/$ | Mặc định cho mọi task |
+| 🟡 **Standard** | Sonnet 4.5, Gemini 3 Flash, GPT-5.2 | $$ | Tasks phức tạp hơn |
+| 🔴 **Premium** | Opus 4.5, GPT-5.1 Codex Max, MAX Mode | $$$ | Chỉ khi thật sự cần |
+
+---
+
+## Command → Model Mapping
+
+| Command | Default 🟢 | Escalate 🟡 | Premium 🔴 |
+|---------|-----------|-------------|------------|
+| `/plan:fast` | Auto | - | - |
+| `/plan` | Auto | Sonnet 4.5 | Opus 4.5 (architecture) |
+| `/cook` | Auto | Sonnet 4.5 | - |
+| `/fix:fast` | Auto | - | - |
+| `/fix` | Auto | Sonnet 4.5 | Opus 4.5 (stuck) |
+| `/scout` | Gemini 3 Flash | Gemini 2.5 Flash | - |
+| `/generate` | GPT-5.1 Codex Mini | - | - |
+| `/review` | Auto | Sonnet 4.5 | Opus 4.5 (critical) |
+| `/design-ui` | Auto | GPT-5.2 | - |
+| `/start` | Auto | Gemini 3 Flash | - |
+
+---
+
+## Khi nào Escalate?
+
+### Auto → Sonnet 4.5
+- Output không đủ chi tiết
+- Cần giải thích sâu hơn
+- Logic phức tạp
+
+### Sonnet 4.5 → Opus 4.5
+- Architecture decisions
+- Critical bugs không fix được
+- Code review cho production
+
+### Gemini 3 Flash
+- Large codebase scanning
+- Research nhiều files
+
+---
+
+## Quick Reference
+
+```
+Task đơn giản     → Auto 🟢
+Task coding       → Auto 🟢 (upgrade Sonnet nếu cần)
+Task phức tạp     → Sonnet 4.5 🟡
+Task quan trọng   → Opus 4.5 🔴
+Scan codebase     → Gemini 3 Flash 🟡
+UI creative       → GPT-5.2 🟡
+```
+
+---
+
+> ⚠️ **Nguyên tắc:** Luôn bắt đầu với model rẻ nhất. Chỉ upgrade khi kết quả không đạt yêu cầu.