anchi-kit 1.1.2

package/CHANGELOG.md

@@ -0,0 +1,346 @@
+# 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.1] - 2025-12-28
+
+### 🔧 Patch Release: Stability & UX Improvements
+
+#### ✨ Added
+
+- **`-v, --version`** flag - Hiển thị version (`anchi-kit v1.0.0`)
+- **Command aliases:**
+  - `b` → `brain`
+  - `dash` → `dashboard`
+  - `pat` → `patterns`
+- **`--no-open`** flag - Dashboard không tự động mở browser
+- **`patterns` CLI command** - Phát hiện code patterns trong dự án
+- **Sensitive data sanitization** - Tự động mask passwords, API keys trong audit logs
+- **Memory version migration** - Tự động migrate memory file khi format thay đổi
+
+#### 🔄 Changed
+
+- **Dashboard default port:** `3000` → `4567` (tránh xung đột với React/Vite/Next.js)
+- **Audit log location:** Di chuyển từ root `.ai-audit/` vào `.cursor/.ai-audit/`
+
+#### 🐛 Fixed
+
+- **ReadLine interface leak** - Thêm try/finally cho clean.js và uninstall.js
+- **TUI null-check** - Không crash khi project name là undefined
+- **Missing CLI commands** - Đăng ký dashboard, tui, analytics, patterns vào CLI
+
+---
+
+## [2.0.0] - 2025-12-27
+
+### 🚀 Major Release: 100% Dynamic Orchestration
+
+**"Zero Static Mappings, Pure Intelligence"**
+
+### ⚡ Breaking Changes
+
+**INTERNAL ONLY** - No breaking changes for end users. Command behavior remains the same but internal agent selection logic completely rewritten.
+
+- `agent-skill-index.yaml` structure changed from v1.x to v2.0
+- All command mappings now use conditionals instead of static agents
+- Existing projects will continue to work with improved intelligence
+
+### ✨ Added
+
+#### New Command
+
+- **`/clean`** - Self-healing system maintenance
+  - Memory cleanup with archival (>30 days)
+  - Audit log management
+  - Config validation and healing
+  - Cache optimization
+  - Rollback capability via `/undo`
+  - Multiple modes: `--memory`, `--audit`, `--config`, `--all`, `--dry-run`
+
+#### Dynamic Orchestration (ALL COMMANDS)
+
+- **100% dynamic agent selection** across all 22 commands
+- **Context-based routing** using keywords, files, packages, project structure
+- **Auto-escalation** for security-sensitive tasks (payment, auth)
+- **Multi-skill activation** - tasks can activate multiple skills simultaneously
+- **Smart conditionals** in every command (e.g., `/demo` detects Docker, Vercel, K8s, AWS)
+
+#### New Agent Utilization
+
+- `journal-writer` - Progress tracking and daily logs
+- `mcp-manager` - External tool integration
+- `graph-architect` - Dependency analysis
+- All 21 agents now actively utilized (was 17/21 in v1.x)
+
+### 🔄 Changed
+
+#### Command Intelligence Upgrades
+
+**`/demo`:**
+
+- Before: Always used `devops-engineer` (static)
+- Now: Detects project type → selects appropriate agent
+  - Has `docker-compose.yml`? → devops-engineer
+  - Has `vercel.json`? → devops-engineer
+  - Has `k8s/`? → devops-engineer
+  - Otherwise? → fullstack-developer
+
+**`/commit`:**
+
+- Before: Always used `git-manager` (static)
+- Now: Smart detection
+  - `BREAKING:` commit? → + changelog-generator
+  - > 20 files? → code-reviewer (review first)
+  - Auth/payment files? → security-auditor (review first)
+
+**`/config`, `/help`, `/memory`, `/status`:**
+
+- All upgraded with conditional logic
+- Context-aware agent selection
+- Dynamic skill activation
+
+#### Skill System
+
+- All 55 skills mapped with activation triggers
+- Auto-detection based on:
+  - Keywords (e.g., "payment" → payment-integration)
+  - File patterns (e.g., `*.csv` → csv-data-analyzer)
+  - Package detection (e.g., `stripe` → payment-integration + security)
+  - Folder structure (e.g., `domain/` → ddd-modular-monolith)
+
+#### Agent-Skill Mapping
+
+- Complete rewrite of `agent-skill-index.yaml`
+- 834 lines (was 500 lines)
+- Zero static mappings (eliminated all 7 hardcoded commands)
+- Full coverage: 21 agents, 55 skills, 22 commands
+
+### 📊 Stats
+
+| Metric               | v1.x         | v2.0         | Change      |
+| -------------------- | ------------ | ------------ | ----------- |
+| **Commands**         | 21           | 22           | +1 (/clean) |
+| **Static Mappings**  | 7 (33%)      | 0 (0%)       | -100% ✅    |
+| **Dynamic Commands** | 14 (67%)     | 22 (100%)    | +50% ✅     |
+| **Skills Mapped**    | ~35 (64%)    | 55 (100%)    | +57% ✅     |
+| **Agents Utilized**  | 17/21 (81%)  | 21/21 (100%) | +24% ✅     |
+| **Overall Grade**    | B+ (8.25/10) | A (9.8/10)   | +18.8% ✅   |
+
+### 📚 Documentation
+
+#### New Docs
+
+- **README.md** - Complete rewrite for v2.0 with dynamic orchestration examples
+- **docs/ALL_COMMANDS.md** - Full 22-command reference with smart routing examples
+- **docs/ORCHESTRATION.md** - Complete v2.0 guide with end-to-end examples
+- **Migration Guide** - Upgrade path from v1.x (zero breaking changes)
+
+#### Updated Docs
+
+- All command `.md` files now include "Dynamic Orchestration" section
+- Clear examples of conditional agent selection
+- Skill activation patterns documented
+
+### 🔍 Under the Hood
+
+#### Orchestration Engine
+
+- Risk-based execution chains (low, medium, high, critical)
+- Automatic security escalation for sensitive operations
+- Multi-agent workflow coordination
+- Parallel skill activation
+- Confidence-based decision making
+
+#### Explainability
+
+- `/why` command shows complete decision tree
+- Agent selection rationale
+- Skill activation triggers
+- Risk assessment details
+- Rules applied
+
+#### Safety Features
+
+- Auto-backup before critical operations
+- Security checklists for payment/auth
+- Failure mode detection
+- Self-restraint rules
+- Manual confirmation for destructive operations
+
+### 🎯 Migration from v1.x
+
+**No user action required!** All changes are internal.
+
+**Benefits you get automatically:**
+
+- ✅ Smarter agent selection
+- ✅ Better skill matching
+- ✅ Improved security (auto-escalation)
+- ✅ New `/clean` command
+- ✅ Better `/why` explanations
+
+**Recommended actions:**
+
+1. Try `/clean --dry-run` to preview system optimization
+2. Use `/why` after tasks to see improved decision-making
+3. Test security escalation with `/do "add payment"`
+4. Explore multi-skill activation with `/do "3D chart dashboard"`
+
+### 🏆 Achievement: Zero Static Mappings
+
+**v2.0 = 100% Intelligent Orchestration**
+
+Every command now:
+
+- ✅ Analyzes context before choosing agents
+- ✅ Detects project structure and tools
+- ✅ Activates skills based on needs
+- ✅ Auto-escalates security concerns
+- ✅ Adapts to your specific codebase
+
+### 🙏 Credits
+
+- Comprehensive testing and validation
+- Community feedback incorporated
+- Backward compatibility maintained
+- Documentation fully updated
+
+---
+
+## [1.4.0] - 2025-12-27
+
+### ✨ Added - Phase 2: Full Claude Skills Integration (15 skills)
+
+**Core Development (3):** subagent-driven-development, test-fixing, review-implementing  
+**Data & Analysis (3):** csv-data-analyzer, d3-visualization, kaizen  
+**Cloud (1):** aws-deployment  
+**Productivity (4):** file-organizer, article-extractor, brainstorming, content-research-writer  
+**UI/UX (4):** artifacts-builder, theme-factory, canvas-design, pypict-testing
+
+**New Skill Packs (6):** sadd, dataAnalysis, cloud, productivity, quality, uiux  
+**New Agents (2):** data-analyst, code-reviewer
+
+### 📊 Stats
+
+- Skills: 55 (+15)
+- Packs: 17 (+6)
+- Agents: 21 (+2)
+
+---
+
+## [1.3.0] - 2025-12-27
+
+### ✨ Added - Claude Skills Integration
+
+**Integrated curated skills from awesome-claude-skills repository**
+
+#### New Skills (7 skills)
+
+- ✅ **test-driven-development** - TDD workflow with red-green-refactor cycle
+- ✅ **playwright-testing** - Browser automation and E2E testing
+- ✅ **software-architecture** - Clean Architecture, SOLID, design patterns
+- ✅ **prompt-engineering** - Advanced AI prompting techniques
+- ✅ **changelog-generator** - Automated changelog from git commits
+- ✅ **git-automation** - Git workflows, worktrees, branch management
+- ✅ **root-cause-analysis** - Systematic debugging methodology
+
+#### New Skill Packs (4 packs)
+
+- 🧪 **testing** - TDD, Playwright, debugging (3 skills)
+- 🏗️ **architecture** - Software architecture, DDD, planning (3 skills)
+- ⚡ **automation** - Git automation, changelog, CI/CD (3 skills)
+- 🔍 **analysis** - Root cause analysis, debugging (2 skills)
+
+### 🔄 Changed
+
+- Updated **ai** skill pack to include `prompt-engineering`
+- Enhanced skill system with progressive disclosure pattern
+- Improved skill documentation structure
+
+### 📚 Documentation
+
+- Added skill reference documents for TDD patterns, testing strategies
+- Added SOLID principles guide with practical examples
+- Added Anthropic best practices for prompt engineering
+- Added git workflow guides and branch finishing checklists
+- Updated SKILLS_INDEX.md with new skill categories
+
+### 🔧 Technical
+
+- Total skills: **40** (merged debugging + root-cause-analysis, removed template-skill)
+- Total skill packs: **11** (7 existing + 4 new)
+- All skills follow Cursor Agent Skills spec
+- Zero breaking changes - fully backward compatible
+
+### 🔄 Skill Organization Improvements
+
+- ✅ Fixed skill name casing: `debugging` (was Debugging), `problem-solving` (was Problem-Solving Techniques)
+- ✅ Merged `root-cause-analysis` into `debugging` skill with expanded RCA methods
+- ✅ Removed `template-skill` from production
+- ✅ Clarified boundaries: `chrome-devtools` (manual debugging) vs `playwright-testing` (automated testing)
+- ✅ Updated agent assignments: 6 agents now mapped to new Claude Skills
+
+---
+
+## [1.0.0] - 2025-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.1   | 2025-12-28 | Stability & UX: --version, aliases, dashboard port, bug fixes    |
+| 2.0.0   | 2025-12-27 | 100% Dynamic Orchestration, /clean command, zero static mappings |
+| 1.4.0   | 2025-12-27 | Phase 2 full integration: +15 skills, +6 packs, +2 agents        |
+| 1.3.0   | 2025-12-27 | Claude Skills integration: +7 skills, +4 skill packs             |
+| 1.0.0   | 2025-12-26 | Initial release with 18 commands, 19 agents, 35 skills           |

package/CURSOR.md

@@ -0,0 +1,85 @@
+# 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)                   |
+| 19:        | **/tui**               | **Mission Control**                             | `/tui` (Theo dõi Agent real-time) |
+
+---
+
+## 🎙️ 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Anchi Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# 💎 Anchi Kit v1.1.2
+
+> **Hệ Điều Hành Tư Duy cho AI Code Editor (Cursor, Gemini, Windsurf)**  
+> _Biến AI từ người thợ code (Coder) thành Kỹ sư trưởng (Senior Tech Lead)._
+
+[![npm version](https://img.shields.io/npm/v/anchi-kit.svg)](https://www.npmjs.com/package/anchi-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+![Orchestration](https://img.shields.io/badge/Orchestration-100%25_Dynamic-success)
+![UI](https://img.shields.io/badge/UI-Dashboard_%2B_TUI-blueviolet)
+
+---
+
+## 🌟 Tại Sao Cần Anchi Kit?
+
+Bạn có cảm thấy AI Code Editor hiện tại (Cursor/Copilot) vẫn chỉ là một **"Thợ Code" (Junior Coder)**?
+
+- Nó chỉ làm đúng cái bạn bảo.
+- Quên ngữ cảnh sau vài tin nhắn.
+- Không biết đánh giá rủi ro hay nhìn bức tranh tổng thể.
+
+**Anchi Kit** là bản nâng cấp toàn diện, biến AI thành **"Kỹ Sư Trưởng" (Senior Tech Lead)** của bạn.
+
+### 🚀 Sự Chuyển Hóa (Transformation)
+
+| Trước khi có Anchi Kit ❌                                                   | Sau khi có Anchi Kit ✅                                                                          |
+| :-------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
+| **Rời rạc:** Bạn phải nhắc AI từng bước (Tạo file -> Viết code -> Fix lỗi). | **Hệ thống:** Bạn chỉ cần nói _"Làm tính năng Login"_, AI tự lên kế hoạch, code, test và review. |
+| **Mất ngữ cảnh:** Chat quá dài, AI quên mất dự án đang làm gì.              | **Hive Mind:** Hệ thống Memory dài hạn tự động lưu trữ và truy xuất context chính xác.           |
+| **Rủi ro:** AI vui vẻ xóa luôn database nếu bạn lỡ yêu cầu.                 | **An toàn:** Cơ chế `Security Guard` tự động chặn lệnh nguy hiểm và yêu cầu xác nhận.            |
+| **Hộp đen:** Không biết AI đang nghĩ gì, làm gì bên dưới.                   | **Minh bạch:** Theo dõi từng quyết định qua **Dashboard** và **Audit Log**.                      |
+
+### 💎 Giá Trị Cốt Lõi
+
+1.  **Tự Động Hóa Quy Trình (Orchestration):** Thay vì làm quản lý vi mô (micro-manage), bạn trở thành người ra quyết định (decision maker).
+2.  **Bảo Mật & Riêng Tư (Local First):** Code và dữ liệu của bạn không bao giờ rời khỏi máy (Zero Data Leak).
+3.  **Mở Rộng Cho Team (Scaling):** Đồng bộ tư duy AI cho cả team, giúp người mới (Onboarding) hiểu dự án trong 5 phút.
+
+---
+
+## 🔥 Tính Năng Nổi Bật (v1.1.1)
+
+### 1. 100% Dynamic Orchestration (Độc Quyền)
+
+Khác với các thư viện Rules tĩnh (cứng nhắc), Anchi Kit sử dụng **Dynamic Logic**:
+
+- Nếu task dễ -> Dùng Junior Agent (Nhanh, rẻ).
+- Nếu task khó -> Dùng Senior Architect + Security Auditor (Chậm, chắc).
+- **Tự động nhận diện công nghệ:** Detect thấy Docker? Gọi DevOps Agent. Detect thấy Next.js? Gọi React Expert.
+
+### 2. Premium UI/UX (Mission Control) ✨ MỚI
+
+Biến dòng lệnh khô khan thành trung tâm điều khiển hiện đại.
+
+- **📊 Web Dashboard (`npx anchi-kit dashboard`):**
+
+  - Hiển thị biểu đồ năng suất.
+  - Phân tích xu hướng lỗi.
+  - Visual hóa Tech Stack của dự án.
+  - _Chạy trên port 4567 (tránh xung đột với React/Vite)._
+
+- **🖥️ Interactive TUI (`npx anchi-kit tui`):**
+  - Giao diện Terminal chia cột (Split-pane).
+  - Theo dõi Real-time logs.
+  - Điều hướng bằng bàn phím.
+
+### 3. Self-Healing System (Hệ Thống Tự Hồi Phục)
+
+- **Clean:** Tự động dọn dẹp bộ nhớ đệm khi AI bắt đầu "lag" hoặc "quên".
+- **Audit:** Ghi lại mọi quyết định của AI để truy vết lỗi.
+- **Rollback:** Hoàn tác thông minh dựa trên ngữ nghĩa (Semantic Undo).
+
+### 4. Team Scaling (v1.1.0) 👥
+
+- **Team Configuration:** Định nghĩa roles (Lead, Senior, Dev) và permissions qua `team.yaml`.
+- **Context Sync:** Đồng bộ "bộ não" AI giữa các thành viên qua `anchi-kit team sync`.
+- **Role-based AI:** AI tự điều chỉnh hành vi dựa trên role của bạn (Junior cần giải thích chi tiết, Senior cần tốc độ).
+
+---
+
+## 📦 Hướng Dẫn Cài Đặt (Thông Minh)
+
+Chỉ cần 1 dòng lệnh duy nhất (Yêu cầu Node.js 18+):
+
+```bash
+npx anchi-kit
+```
+
+**Hệ thống sẽ tự động:**
+
+1.  🔍 **Detect IDE:** Tự nhận diện bạn đang dùng Cursor hay Antigravity (Gemini/Windsurf).
+2.  🛡️ **Secure Install:** Tự động cấu hình `.gitignore` và chính sách bảo mật.
+3.  📦 **Dependency:** Tự động cài đặt gói vào `package.json` để dễ dàng update.
+
+---
+
+## 🎮 Hướng Dẫn Sử Dụng (Quick Start)
+
+Hãy tưởng tượng bạn là Sếp, còn Anchi Kit là đội ngũ nhân viên.
+
+### 1. Giao Việc (Command Mode)
+
+Dùng trong cửa sổ Chat của IDE:
+
+- **Bắt đầu ngày mới:**
+
+  ```bash
+  /start
+  # AI sẽ đọc lại Context hôm qua và báo cáo tình hình.
+  ```
+
+- **Làm mọi việc (Universal Command):**
+
+  ```bash
+  /do "Thêm tính năng đăng nhập bằng Google"
+  # AI sẽ tự: Lên kế hoạch -> Code Backend -> Code Frontend -> Test -> Review.
+  ```
+
+- **Kiểm tra & Sửa lỗi:**
+
+  ```bash
+  /test --fix
+  # Chạy test, nếu lỗi thì tự động debug và sửa.
+  ```
+
+- **Gửi code (Commit):**
+  ```bash
+  /commit "Hoàn thành chức năng Login"
+  # Tự động tạo Commit Message chuẩn Conventional Commits.
+  ```
+
+### 2. Giám Sát (Management Mode)
+
+Dùng trong Terminal:
+
+- **Xem bảng điều khiển:**
+
+  ```bash
+  npx anchi-kit dashboard        # Hoặc: npx anchi-kit dash
+  npx anchi-kit dash --no-open   # Không tự mở browser
+  ```
+
+- **Xem điệp viên đang làm gì (Real-time):**
+
+  ```bash
+  npx anchi-kit tui
+  ```
+
+- **Phân tích dữ liệu:**
+  ```bash
+  npx anchi-kit analytics
+  ```
+
+---
+
+## 📂 Cấu Trúc Dự Án (Sau khi cài đặt)
+
+```text
+root/
+├── .cursor/ (hoặc .antigravity/)
+│   ├── agents/       # Định nghĩa 21 "Nhân viên" AI
+│   ├── skills/       # Kho 55 kỹ năng (React, AWS, Security...)
+│   ├── workflows/    # Quy trình làm việc chuẩn (22 commands)
+│   ├── commands/     # Logic xử lý lệnh (Chat commands)
+│   ├── .ai-audit/    # Nhật ký quyết định (Blackbox)
+│   └── .ai-memory/   # Bộ nhớ dài hạn của AI
+└── presets/          # Mẫu kiến trúc (Rapid/Professional/Enterprise)
+```
+
+---
+
+## 🔬 Deep Technology (Behind The Scenes)
+
+Những công nghệ ngầm giúp Anchi Toolkit khác biệt:
+
+### 1. Context Mastery (Chống ảo giác AI)
+
+- **Active Memory:** Không ném toàn bộ dự án vào AI. Hệ thống dùng **Semantic Search** để chỉ nạp những context liên quan nhất đến task.
+- **Self-Healing:** Lệnh `/clean --archive` giúp đóng gói ký ức cũ, giữ cho đầu óc AI luôn "tươi mới" (Fresh Context Window).
+
+### 2. Team Scaling (Làm việc nhóm)
+
+- **Shared Brain:** File `.cursorrules` đóng vai trò là "Hiến pháp" của team. Bất kỳ ai join dự án đều **ngay lập tức** code theo chuẩn chung.
+- **Fast Onboarding:** Dev mới chỉ cần chạy `/scout`, AI sẽ tự học lại toàn bộ kiến trúc dự án trong 5 phút.
+
+### 3. Log Conflict Resolution
+
+- **Silence Protocol:** Tự động tắt toàn bộ log rác ("Thinking...", "Reading...").
+- **Selective Transparency:** Chỉ hiển thị báo cáo kết quả cuối cùng, giúp giao diện sạch sẽ như một CLI tool chuyên nghiệp.
+
+---
+
+## 🤝 Cộng Đồng & Đóng Góp
+
+Anchi Toolkit là dự án do ANCHI-STE phát triển. Mọi đóng góp của member đều được hoan nghênh!
+
+- **Repo:** [ANCHI-STE/anchi-webkit-dev](https://github.com/ANCHI-STE/anchi-webkit-dev)
+- **Issues:** Báo lỗi hoặc yêu cầu tính năng mới tại mục Issues.
+
+---
+
+**Anchi Kit v1.1.1 - Don't just code. Orchestrate.** 🚀

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../src/cli.js');