anchi-toolkit 1.0.0

package/.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/.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/.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/.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/.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/.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/.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/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+Tất cả thay đổi quan trọng của anchi-toolkit sẽ được ghi lại ở đây.
+
+Format: [Semantic Versioning](https://semver.org/)
+
+---
+
+## [1.0.0] - 2024-12-26
+
+### 🎉 Initial Release
+
+**"AI Execution Framework with control, audit, and team scaling"**
+
+### Features
+
+- 🎯 **18 Commands** - Unified AI-powered workflows
+  - `/start`, `/do`, `/test`, `/commit`, `/help` (Essential)
+  - `/scout`, `/review`, `/docs`, `/status`, `/undo` (Support)
+  - `/design`, `/generate`, `/theme`, `/integrate`, `/memory` (Specialized)
+  - `/audit`, `/migrate`, `/why` (Advanced)
+
+- 🤖 **19 Agents** - Specialized AI personas
+  - Development: fullstack-developer, debugger, tester
+  - Design: ui-ux-designer, design-system-architect
+  - Architecture: ddd-architect, database-admin
+  - Management: project-manager, git-manager
+  - Research: researcher, scout, brainstormer
+  - Content: docs-manager, copywriter, journal-writer
+
+- 📚 **35 Skills** - Domain knowledge packs
+  - Frontend, Backend, Databases, DevOps
+  - AI/MCP, Payment Integration, Authentication
+  - UI Styling, Web Frameworks, Mobile Development
+
+- 🏗️ **3 Architecture Presets**
+  - Rapid MVP: SQLite, flat files, no gates
+  - Professional: PostgreSQL, modular monolith, code review
+  - Enterprise: PostgreSQL + Redis, full DDD, multi-stage gates
+
+- 🔒 **AI Execution Contract** - Rule-driven AI with priority levels
+- 📋 **Audit & Replay System** - Full decision trail for compliance
+- 💾 **Context as DATA** - Persistent AI memory
+- 👥 **Team & Role-aware AI** - Role-based permissions
+- 🔄 **Dynamic Orchestration** - Runtime agent/skill selection
+
+### Platforms
+
+- **Cursor AI**: `.cursor/` directory, VS Code extension
+- **Antigravity (Gemini)**: `.antigravity/` directory, standalone runtime
+
+---
+
+## Version Summary
+
+| Version | Date | Highlights |
+|---------|------|------------|
+| 1.0.0 | 2024-12-26 | Initial release with 18 commands, 19 agents, 35 skills |

package/CURSOR.md

@@ -0,0 +1,191 @@
+# CURSOR.md
+
+Hướng dẫn cho Cursor AI khi làm việc trong repository này.
+
+---
+
+## 🎯 Core Principle
+
+**Luôn follow rules theo thứ tự ưu tiên:**
+
+1. **`.cursorrules`** - Active preset rules (highest priority)
+2. **`.cursor/commands/`** - Command definitions
+3. **`.cursor/agents/`** - Agent behaviors
+4. **`.cursor/skills/`** - Knowledge modules
+5. **`docs/`** - Project documentation
+
+---
+
+## 📋 Trước Khi Thực Hiện Command
+
+### Bắt buộc đọc:
+
+1. ✅ Đọc `.cursorrules` để biết preset đang dùng
+2. ✅ Đọc `docs/PROJECT.md` để hiểu context
+3. ✅ Đọc command definition trong `.cursor/commands/`
+4. ✅ Activate skills phù hợp từ `.cursor/skills/`
+
+---
+
+## 🔄 Preset System
+
+Template hỗ trợ 3 presets:
+
+| Preset | .cursorrules | Setup Script |
+|--------|--------------|--------------|
+| 🚀 Rapid | `presets/rapid-mvp/.cursorrules` | `scripts/setup-rapid.ps1` |
+| 🏢 Professional | `presets/professional/.cursorrules` | `scripts/setup-professional.ps1` |
+| 🏛️ Enterprise | `presets/enterprise/.cursorrules` | `scripts/setup-enterprise.ps1` |
+
+### Khi `/use-preset` được gọi:
+
+1. Hiển thị tech stack của preset
+2. Yêu cầu xác nhận từ user
+3. Nếu xác nhận → suggest chạy setup script
+4. Script sẽ:
+   - Copy `.cursorrules` phù hợp
+   - Tạo folder structure
+   - Install dependencies
+   - Setup database
+
+---
+
+## 📂 Command Workflow
+
+### Mọi command phải:
+
+1. **Check preset** - Đọc `.cursorrules` để biết mode
+2. **Follow structure** - Tuân thủ folder structure của preset
+3. **Use conventions** - Theo naming, coding conventions
+4. **Reference docs** - Tham chiếu `docs/` khi cần context
+
+### Ví dụ:
+
+```
+User: /plan "Add authentication"
+
+AI steps:
+1. Đọc .cursorrules → Biết đang dùng Professional preset
+2. Đọc docs/PROJECT.md → Hiểu context
+3. Đọc .cursor/commands/plan.md → Biết format output
+4. Đọc .cursor/agents/planner.md → Đóng vai planner
+5. Activate skill: .cursor/skills/better-auth/
+6. Output plan theo đúng structure của Professional
+```
+
+---
+
+## 🤖 Agent Activation
+
+Khi thực hiện task, activate agents phù hợp:
+
+| Task Type | Agents |
+|-----------|--------|
+| Planning | planner, researcher |
+| UI Design | ui-ux-designer, design-system-architect |
+| Domain Design | ddd-architect |
+| Implementation | fullstack-developer |
+| Review | code-reviewer |
+| Testing | tester |
+| Documentation | docs-manager |
+| Debugging | debugger |
+
+**Agent files:** `.cursor/agents/`
+
+---
+
+## 📚 Skill Activation
+
+Activate skills khi cần kiến thức chuyên sâu:
+
+> 📖 **Xem full danh sách:** `.cursor/skills/SKILLS_INDEX.md`
+
+### Skills Theo Preset
+
+| Preset | Skills Chính |
+|--------|-------------|
+| 🚀 Rapid | frontend-development, ui-styling, databases, planning |
+| 🏢 Professional | + backend-development, better-auth, code-review |
+| 🏛️ Enterprise | + ddd-modular-monolith, devops, ui-ux-pro-max |
+
+### Utility Skills (All Presets)
+
+| Skill | Khi dùng |
+|-------|----------|
+| `ai-multimodal` | Image generation |
+| `chrome-devtools` | Browser debugging |
+| `docs-seeker` | Search documentation |
+| `research` | Technology research |
+
+---
+
+## ⚠️ Important Rules
+
+### DO:
+- ✅ Check `.cursorrules` trước mọi task
+- ✅ Follow folder structure của active preset
+- ✅ Reference `docs/` cho project context
+- ✅ Use agents và skills phù hợp
+- ✅ Confirm với user khi cần setup/install
+
+### DO NOT:
+- ❌ Ignore `.cursorrules`
+- ❌ Dùng structure khác preset
+- ❌ Skip confirmation khi setup
+- ❌ Install dependencies không cần thiết
+
+---
+
+## 📖 Documentation Management
+
+Locations:
+- `docs/PROJECT.md` - Project description
+- `docs/code-standards.md` - Coding standards
+- `docs/system-architecture.md` - Architecture
+- `docs/CODEBASE.md` - Codebase overview
+
+**Khi cần context → Đọc docs/ trước khi trả lời.**
+
+---
+
+## 🎭 UX Mode System (CRITICAL)
+
+> **Mode decides the voice - No exceptions**
+
+### Rule #1: Mode Detection
+
+```
+IF user_input starts with /
+→ COMMAND MODE (Command owns UI)
+
+ELSE
+→ PROMPT MODE (AI Agent owns UI)
+```
+
+### Command Mode
+
+When user types `/command`:
+- ✅ Show: Command log, structured output, governance
+- ❌ Hide: Agent narration, "AI decided...", raw text
+
+AI agent **im lặng hoàn toàn** ở UI.
+
+### Prompt Mode
+
+When user types free text:
+- ✅ Show: AI narration, progress, explanations
+- ❌ Hide: Command log, governance summary
+
+This is **exploratory** mode, no governance.
+
+### ❌ Never Do
+
+1. Mix command log with agent chat
+2. Show agent narration in command mode
+3. Show governance in prompt mode
+
+📖 Full documentation: [docs/UX_MODES.md](./docs/UX_MODES.md)
+
+---
+
+**CRITICAL:** Đây là file AI PHẢI ĐỌC. Mọi command PHẢI follow rules này.