anchi-kit 1.1.2

package/docs/PROJECT.md

@@ -0,0 +1,143 @@
+# Project Overview & Requirements (PDR)
+
+> 📋 **Purpose:** PLANNING document - WHY & WHAT we're building
+>
+> **For technical details (HOW):** See [CODEBASE.md](./CODEBASE.md)
+
+> [!NOTE] > **Template File:** Đây là file template được copy vào dự án đích khi cài đặt anchi-kit.
+> Bạn cần điền thông tin dự án thực tế vào các placeholder `[...]`.
+
+---
+
+## 🎯 Preset Đang Dùng
+
+- [ ] 🚀 **Rapid MVP** - Demo nhanh, prototype, < 2 tuần
+- [ ] 🏢 **Professional** - Sản phẩm thương mại, 1-6 tháng
+- [ ] 🏛️ **Enterprise** - Dự án lớn, DDD architecture, > 6 tháng
+
+---
+
+## 📌 Thông Tin Dự Án
+
+| Field             | Value        |
+| ----------------- | ------------ |
+| **Project Name**  | [Tên dự án]  |
+| **Version**       | 0.1.0        |
+| **Start Date**    | [DD/MM/YYYY] |
+| **Target Launch** | [DD/MM/YYYY] |
+| **Team**          | [Tên team]   |
+
+---
+
+## 🎯 Problem & Solution
+
+### Vấn Đề Cần Giải Quyết
+
+[Mô tả pain points, problems mà dự án giải quyết]
+
+### Giải Pháp
+
+[Mô tả cách dự án giải quyết vấn đề]
+
+---
+
+## 👥 Target Users
+
+| User Type | Đặc điểm | Needs   |
+| --------- | -------- | ------- |
+| [User 1]  | [Mô tả]  | [Needs] |
+| [User 2]  | [Mô tả]  | [Needs] |
+
+---
+
+## ✅ Features & Requirements
+
+### MVP Features (Phase 1)
+
+| Feature     | Priority | Description |
+| ----------- | -------- | ----------- |
+| [Feature 1] | P0       | [Mô tả]     |
+| [Feature 2] | P0       | [Mô tả]     |
+| [Feature 3] | P1       | [Mô tả]     |
+
+### Future Features (Phase 2+)
+
+| Feature     | Priority | Description |
+| ----------- | -------- | ----------- |
+| [Feature 4] | P2       | [Mô tả]     |
+
+---
+
+## 🔄 User Flows
+
+### Flow 1: [Tên Flow]
+
+```
+1. User vào trang home
+2. User click button X
+3. System hiển thị Y
+4. User submit form
+5. Done
+```
+
+### Flow 2: [Tên Flow]
+
+```
+[Mô tả flow]
+```
+
+---
+
+## 📊 Success Metrics
+
+| Metric     | Target  | How to Measure |
+| ---------- | ------- | -------------- |
+| [Metric 1] | [Value] | [Method]       |
+| [Metric 2] | [Value] | [Method]       |
+
+---
+
+## 📅 Timeline
+
+| Phase                | Duration | Goals   |
+| -------------------- | -------- | ------- |
+| Phase 1: MVP         | [X tuần] | [Goals] |
+| Phase 2: Enhancement | [X tuần] | [Goals] |
+
+---
+
+## ⚠️ Constraints & Risks
+
+### Constraints
+
+- **Budget:** [Constraint]
+- **Timeline:** [Constraint]
+- **Team Size:** [Constraint]
+
+### Risks
+
+| Risk     | Impact | Mitigation |
+| -------- | ------ | ---------- |
+| [Risk 1] | High   | [Solution] |
+| [Risk 2] | Medium | [Solution] |
+
+---
+
+## 👥 Team
+
+| Role      | Name   | Responsibilities   |
+| --------- | ------ | ------------------ |
+| Team Lead | [Name] | [Responsibilities] |
+| Developer | [Name] | [Responsibilities] |
+
+---
+
+## 🔗 References
+
+- [Design Files - Figma/etc]
+- [API Docs]
+- [Related Projects]
+
+---
+
+> 💡 **Note:** File này focus vào PLANNING. Xem [CODEBASE.md](./CODEBASE.md) cho technical details.

package/docs/ROADMAP.md

@@ -0,0 +1,112 @@
+# 🗺️ Project Roadmap
+
+> Lộ trình phát triển của Anchi Kit
+
+---
+
+## ✅ v1.0.0 - The Foundation (Current Release)
+
+Official release of Anchi Kit v1.0.0 với Dynamic Orchestration v2.0.
+
+### Core Features
+
+- [x] **Core Command Trinity**: `/start`, `/do`, `/clean`
+- [x] **22 Chat Commands** - Full dynamic orchestration
+- [x] **21 AI Agents** - Specialized personas
+- [x] **55 Skills** - Domain knowledge packs
+
+### Intelligence
+
+- [x] **Dynamic Orchestration v2.0**: 100% conditional routing, zero static mappings
+- [x] **Risk-based Execution**: Auto-escalation cho security-sensitive tasks
+- [x] **Multi-skill Activation**: Tasks có thể activate nhiều skills cùng lúc
+
+### UI/UX
+
+- [x] **Web Dashboard** (`npx anchi-kit dashboard`): Biểu đồ năng suất, phân tích xu hướng
+- [x] **Terminal UI** (`npx anchi-kit tui`): Interactive split-pane interface
+- [x] **Brain Dashboard** (`npx anchi-kit brain`): Tổng quan Memory, Learning & Audit
+
+### Memory System
+
+- [x] **Project Recall**: Knowledge Graph với `analyze` command
+- [x] **Multi-project Learning**: Cross-project suggestions
+- [x] **Session Snapshots**: Time-travel cho memory
+
+### Engineering Discipline
+
+- [x] **AI Contract**: Rule-driven execution với 3 priority levels
+- [x] **Audit Trail**: Full decision logging
+
+### Secure Install & Handover (v1.1.1) ✅
+
+- [x] **Smart Installation**: Auto-detect IDE (Cursor/Antigravity).
+- [x] **Security Hardening**: Auto `.gitignore` for secrets & memory.
+- [x] **Policy Declaration**: `LOCAL_ONLY_POLICY.md` assurance.
+- [x] **Auto-Dependency**: Auto `npm/yarn/pnpm install`.
+
+---
+
+## 🚧 v1.1 - Cloud & CI/CD (Upcoming)
+
+### CI/CD Integration
+
+- [ ] `anchi-action`: GitHub Actions integration cho automated PR review
+- [ ] GitLab CI/CD support
+- [ ] Webhook notifications khi AI hoàn thành task
+
+### Team Collaboration
+
+- [x] **Remote Memory Sync**: Share context giữa team members (Basic via `sync` command)
+- [x] **Shared Brain**: Cloud-based semantic memory (Partial via `team.yaml`)
+- [ ] Slack/Discord Webhook Integration (Enhanced)
+
+### Advanced Team Scaling (Enterprise)
+
+- [x] **Hive Mind (Git-native Sync)**: Sync `.ai-memory` qua hidden git branch (Tối ưu cho Team < 5).
+- [ ] **Federated Teams**: Hỗ trợ multiple `team.yaml` cho từng module (Backend/Frontend).
+- [ ] **Granular RBAC**: Phân quyền AI level file (VD: Junior cấm sửa `src/core`).
+- [ ] **Governance Pipelines**: AI Review chặn merge nếu sai kiến trúc.
+
+### Performance
+
+- [ ] Caching optimizations cho large codebases
+- [ ] Incremental indexing
+
+---
+
+## 🔮 v1.2+ - Future Concepts
+
+### Advanced Features
+
+- [ ] Voice Command Interface
+- [ ] VS Code Native Extension
+- [ ] Multi-repo orchestration
+
+### Community
+
+- [ ] Skill Marketplace - Community-contributed skills
+- [ ] Custom Agent Templates
+- [ ] Plugin architecture
+
+### AI Improvements
+
+- [ ] Auto-learning từ success/failure patterns
+- [ ] MCP auto-detection và dynamic tool discovery
+- [ ] Performance metrics và decision quality tracking
+
+---
+
+## 📊 Version Summary
+
+| Version | Status      | Highlights                                                    |
+| ------- | ----------- | ------------------------------------------------------------- |
+| v1.0.0  | ✅ Released | 22 commands, 21 agents, 55 skills, Dynamic Orchestration v2.0 |
+| v1.1.0  | ✅ Released | Team Support, Hive Mind (Git Sync)                            |
+| v1.1.1  | ✅ Released | Secure Install, IDE Auto-Detect, Policy Assurance             |
+| v1.1.2  | ✅ Released | Fix: npm register conflict resolution (Hotfix)                |
+| v1.2+   | 🔮 Future   | Voice commands, VS Code extension, Multi-repo                 |
+
+---
+
+> **Philosophy:** "Don't just code. Orchestrate." 🚀

package/docs/TEAM_GUIDE.md

@@ -0,0 +1,100 @@
+# 👥 Team Collaboration Guide
+
+> Hướng dẫn sử dụng anchi-kit cho team development.
+
+---
+
+## 1. Setup Team Project
+
+Để bắt đầu làm việc nhóm, bạn cần khởi tạo cấu hình team:
+
+```bash
+npx anchi-kit team init
+```
+
+Lệnh này sẽ tạo file `.cursor/team.yaml` với template chuẩn.
+
+### Cấu hình `team.yaml`
+
+File này chứa thông tin team, roles, và permissions. Quan trọng nhất là phần **Members** và **Sync Settings**.
+
+```yaml
+team:
+  name: "My Project Team"
+
+members:
+  - name: "Alice"
+    role: lead
+    permissions: [approve_pr, deploy_prod]
+
+sync:
+  shared:
+    - .cursorrules
+    - .cursor/agents/
+```
+
+---
+
+## 2. Quản lý Thành viên
+
+Thêm thành viên mới vào team:
+
+```bash
+npx anchi-kit team add "Bob" "developer"
+```
+
+Các role hỗ trợ:
+
+- `lead`: Full quyền quản trị, deploy production.
+- `senior`: Review code, deploy staging.
+- `developer`: Tạo PR, deploy dev environment.
+- `junior`: Read-only, tạo PR.
+
+---
+
+## 3. Đồng bộ Context (Sync)
+
+Khi làm việc nhóm, việc đồng bộ "trí tuệ" của AI là rất quan trọng.
+
+```bash
+npx anchi-kit team sync
+```
+
+Lệnh này sẽ:
+
+1. Pull các rule chung từ `.cursorrules`
+2. Update agents/skills nếu có thay đổi từ team
+3. Đồng bộ hóa conventions
+
+---
+
+## 4. Workflow chuẩn cho Team
+
+### Bước 1: Khởi động ngày làm việc
+
+```bash
+git pull
+npx anchi-kit team sync
+```
+
+### Bước 2: Thực hiện Task
+
+Sử dụng `/plan` để AI hiểu context team:
+
+```bash
+/plan "Implement payment feature per team conventions"
+```
+
+### Bước 3: Code & Review
+
+Trước khi commit, AI sẽ kiểm tra `.cursor/team.yaml` để đảm bảo user có quyền thực hiện thay đổi (ví dụ: junior không được sửa config core).
+
+---
+
+## 5. Troubleshooting
+
+**Q: Tôi không chạy được lệnh team?**
+A: Đảm bảo bạn đã update lên version >= 1.1.0 và chạy `team init`.
+
+**Q: Config bị conflict?**
+A: `team.yaml` được quản lý bởi git. Hãy giải quyết conflict như file code bình thường.

package/docs/UX_MODES.md

@@ -0,0 +1,173 @@
+# UX Mode System
+
+> **Command mode → Command owns the UI
+> Prompt mode → AI Agent owns the UI**
+
+Hai mode **loại trừ nhau**, không bao giờ hiển thị song song.
+
+---
+
+## 📜 Rule #1: Mode Decides the Voice
+
+```
+IF user_input = command (starts with /)
+→ Command owns the UI
+
+ELSE (free text prompt)
+→ AI Agent owns the UI
+```
+
+**Không có ngoại lệ.**
+
+---
+
+## 1️⃣ Command Mode
+
+### Khi nào?
+User gõ command bắt đầu bằng `/`:
+```
+/do "Add login"
+/commit
+/test
+```
+
+### Hiển thị:
+- ✅ Command log (summary, files, status, risk)
+- ✅ Structured output
+- ✅ Governance indicators
+
+### Không hiển thị:
+- ❌ Agent progress narration
+- ❌ "AI decided…"
+- ❌ "User approved…"
+- ❌ Raw execution text
+
+> 👉 AI agent **im lặng hoàn toàn** ở UI.
+
+### Output Format:
+```
+📋 /do "Add user login"
+
+═══════════════════════════════════════════════
+📊 Analysis:
+├── Agent: fullstack-developer (0.85)
+├── Skills: better-auth, databases
+└── Risk: medium
+
+📋 Plan:
+1. Create AuthService
+2. Create login page
+3. Add session middleware
+
+⏱️ Estimated: 5-8 minutes
+═══════════════════════════════════════════════
+
+[Progress bar or status updates only]
+
+✅ Completed: 4 files created
+```
+
+---
+
+## 2️⃣ Prompt Mode (Chat Mode)
+
+### Khi nào?
+User gõ free text (không có `/`):
+```
+Create a walkthrough documentation for new users
+Can you help me understand the auth flow?
+```
+
+### Hiển thị:
+- ✅ AI agent narration
+- ✅ Progress updates
+- ✅ Explanations
+- ✅ "I'll create these files..."
+
+### Không hiển thị:
+- ❌ Command log format
+- ❌ Governance summary
+- ❌ Risk assessment
+
+> 👉 Đây là mode **exploratory**, không governance.
+
+### Output Format:
+```
+I'll help you create a walkthrough documentation for new users.
+
+Let me create the documentation file...
+
+[Creates docs/WALKTHROUGH.md]
+
+I've created the walkthrough with the following sections:
+- Day 1: Setup
+- Day 2: First feature
+...
+
+Would you like me to add anything else?
+```
+
+---
+
+## 📊 Comparison Table
+
+| Aspect | Command Mode | Prompt Mode |
+|--------|--------------|-------------|
+| **Purpose** | Controlled execution | Exploration |
+| **Narrator** | Command | AI Agent |
+| **UX** | Clean, tool-like | Rich, conversational |
+| **Log shown** | Command log | Agent narration |
+| **Best for** | Long-term, team | Quick trial, personal |
+| **Governance** | Yes | No |
+
+---
+
+## 🚨 Absolute Rules
+
+### ❌ Never Do:
+1. Show agent chat while in command mode
+2. Merge base log into command log
+3. Auto-switch to command log during free chat
+4. Mix narration styles
+
+### ✅ Always Do:
+1. Clear mode indicator
+2. Consistent log format per mode
+3. Let mode determine narrator
+4. Respect user's mode choice
+
+---
+
+## 🎯 Mode Indicator (Optional Enhancement)
+
+Display current mode to user:
+```
+┌─────────────────────────────────────┐
+│ Mode: Command 📋                    │
+└─────────────────────────────────────┘
+
+┌─────────────────────────────────────┐
+│ Mode: Chat 💬                       │
+└─────────────────────────────────────┘
+```
+
+User **luôn biết mình đang ở đâu**.
+
+---
+
+## 🧩 Why This Works
+
+| Benefit | Reason |
+|---------|--------|
+| No log conflict | Only 1 narrator at a time |
+| No overload | User sees only what they chose |
+| Matches kit philosophy | Command = governance, Prompt = freedom |
+| Easy to teach | "Want control → command", "Want explore → prompt" |
+
+---
+
+## 🔗 Related
+
+- [docs/ORCHESTRATION.md](./ORCHESTRATION.md) - AI meta-layer
+- [docs/AI_CONTRACT.md](./AI_CONTRACT.md) - Constitutional rules
+- [CURSOR.md](../CURSOR.md) - AI behavior configuration

package/docs/WORKFLOW.md

@@ -0,0 +1,128 @@
+# 🚀 Team Pipeline Workflow
+
+Guideline cho team để phối hợp hiệu quả với Anchi Kit.
+
+---
+
+## 📋 Tổng Quan Pipeline
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        TEAM PIPELINE WORKFLOW                            │
+└─────────────────────────────────────────────────────────────────────────┘
+
+Phase 1: START          Phase 2: EXECUTE        Phase 3: VERIFY
+┌─────────────┐         ┌─────────────┐         ┌─────────────┐
+│   /start    │ ──────► │     /do     │ ──────► │ /do --careful │
+│   (Recall)  │         │ (Auto Mode) │         │ (Test/Fix)  │
+└─────────────┘         └─────────────┘         └─────────────┘
+                                                       │
+                                                       ▼
+Phase 5: DEPLOY         Phase 4: REVIEW
+┌─────────────┐         ┌─────────────┐
+│   Git Publish   │ ◄────── │ Code Review │
+│     (CI/CD)     │         │ (Manual/AI) │
+└─────────────┘         └─────────────┘
+```
+
+---
+
+## 🎯 Phase 1: PROJECT START
+
+### 1.1. Khởi Tạo / Resume
+
+```bash
+/start
+# AI sẽ tự detect project mới hoặc recall session cũ.
+```
+
+### 1.2. Setup Git Automation (Safety Net)
+
+Dev hay quên chạy test? Hãy cài "Lưới an toàn":
+
+```bash
+# Windows
+./scripts/install-hooks.ps1
+# Mac/Linux
+./scripts/install-hooks.sh
+```
+
+_Tác dụng: Tự động chặn commit nếu code lỗi hoặc chưa format._
+
+### 1.3. Đồng Bộ Team
+
+Luôn pull về trước khi làm việc:
+
+```bash
+git pull origin develop
+```
+
+---
+
+## 🔨 Phase 2: EXECUTE (The `/do` Magic)
+
+Thay vì nhớ 10 lệnh, chỉ cần nhớ `/do`.
+
+### Feature mới:
+
+> `/do "Thêm trang Dashboard có chart doanh thu"`
+
+### Fix bug:
+
+> `/do "Sửa lỗi button login không click được"`
+
+### Refactor:
+
+> `/do "Refactor file user.service.ts theo chuẩn DDD"`
+
+### ⚠️ Quy tắc Teamwork:
+
+- **Luôn dùng Branch:** Đừng làm trực tiếp trên main/develop.
+- **Tương tác:** Nếu AI hỏi xác nhận (Risk Alert), hãy đọc kỹ trước khi Yes.
+
+---
+
+## ✅ Phase 3: VERIFY & REVIEW
+
+### 3.1. Verify
+
+Chạy test và check code:
+
+```bash
+/test               # Chạy test suite
+/review --security  # Review security flaws
+```
+
+### 3.2. Tạo Pull Request
+
+Khi code đã ổn:
+
+1.  Review lại thay đổi.
+2.  Commit & Push.
+3.  Tạo PR trên GitHub/GitLab.
+
+---
+
+## 🔀 GIT WORKFLOW (Chuẩn Team)
+
+### Branch Naming
+
+- Feature: `feat/ten-chuc-nang`
+- Bugfix: `fix/ten-loi`
+- Hotfix: `hotfix/loi-gap`
+
+### Commit Message
+
+- `feat: thêm chức năng login`
+- `fix: sửa lỗi typo`
+- `docs: cập nhật readme`
+
+---
+
+## 🤝 Team Roles
+
+- **Lead:** Setup `.cursorrules` và `team.yaml`. Review PR.
+- **Dev:** Chạy `/do` để code feature. Tạo PR.
+- **Reviewer:** Check logic, merge PR.
+
+---

package/docs/engineering/core-philosophy.md

@@ -0,0 +1,37 @@
+# 🧠 Anchi Engineering Philosophy
+
+Welcome to the **Anchi Engineering Discipline**. This is not just a set of suggestions; these are the **hard rules** that govern how our AI agents (and ideally, humans) operate.
+
+We have adopted a "Safety-First" mindset, enforced through the Anchi Governance system.
+
+## 1. Planning is NOT Optional
+
+**Rule:** "Think before you act."
+Every `/do` command automatically triggers a planning phase. We do not write code until we know strategies, risks, and impact.
+
+- **Why?** Prevents "coding carefully into a dead end."
+
+## 2. Incremental Change
+
+**Rule:** "Small steps, verifying each."
+We limit AI agents to modifying small batches of files (max ~10) per step.
+
+- **Why?** Massive refactors are the root of all evil. If it breaks, we want to know _exactly_ which step broke it.
+
+## 3. Verify Before Commit
+
+**Rule:** "If it's not tested, it doesn't exist."
+The `/commit` command is gated by automated verification.
+
+- **Why?** We treat the `main` branch as sacred.
+
+## 4. Reasoning Clarity
+
+**Rule:** "Explain your trade-offs."
+When asked `/why`, we expect a decision tree, not a vague justification.
+
+- **Why?** We value _maintainability_ over _cleverness_.
+
+---
+
+> "Engineering is about discipline, not just code."