anchi-toolkit 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/.ai-audit/README.md +53 -0
  2. package/.ai-memory/README.md +137 -0
  3. package/.ai-memory/context.json +26 -0
  4. package/.ai-memory/decisions.json +3 -0
  5. package/.antigravity/agent-skill-index.yaml +24 -0
  6. package/.antigravity/anchi-toolkit.config.yaml +12 -0
  7. package/.antigravity/docs/README.md +9 -0
  8. package/.antigravity/skills/_template.md +30 -0
  9. package/.antigravity/team.yaml +154 -0
  10. package/.antigravity/workflows/config.md +144 -0
  11. package/.antigravity/workflows/demo.md +50 -0
  12. package/.antigravity/workflows/help.md +11 -4
  13. package/.antigravity/workflows/skill-learn.md +48 -0
  14. package/.antigravity/workflows/start.md +38 -117
  15. package/.antigravity/workflows/status.md +8 -8
  16. package/.antigravity/workflows/undo.md +7 -7
  17. package/.cursor/agent-skill-index.yaml +39 -0
  18. package/.cursor/agents/graph-architect.md +30 -0
  19. package/.cursor/agents/trend-watcher.md +24 -0
  20. package/.cursor/commands/config.md +144 -0
  21. package/.cursor/commands/demo.md +50 -0
  22. package/.cursor/commands/do.md +127 -90
  23. package/.cursor/commands/help.md +23 -16
  24. package/.cursor/commands/skill-learn.md +48 -0
  25. package/.cursor/commands/start.md +38 -117
  26. package/.cursor/commands/status.md +19 -19
  27. package/.cursor/commands/undo.md +19 -19
  28. package/.cursor/orchestration.yaml +18 -0
  29. package/.cursor/skills/_template.md +30 -0
  30. package/ANTIGRAVITY.md +84 -0
  31. package/CURSOR.md +50 -157
  32. package/LICENSE +17 -14
  33. package/README.md +64 -89
  34. package/docs/ALL_COMMANDS.md +31 -73
  35. package/docs/CI_CD.md +44 -0
  36. package/docs/COMPARISON.md +65 -0
  37. package/docs/ROADMAP.md +45 -161
  38. package/docs/WORKFLOW.md +56 -317
  39. package/package.json +9 -2
  40. package/presets/ci-cd/ai-review.yml +49 -0
  41. package/scripts/install-hooks.ps1 +21 -7
  42. package/scripts/install-hooks.sh +18 -3
  43. package/src/cli.js +111 -59
  44. package/src/commands/clean.js +87 -0
  45. package/src/commands/doctor.js +88 -21
  46. package/src/commands/init.js +22 -2
  47. package/src/commands/uninstall.js +17 -2
  48. package/src/lib/configManager.js +20 -5
  49. package/src/lib/memoryManager.js +7 -4
  50. package/docs/CODEBASE.md +0 -178
  51. package/docs/COMMAND_MAPPING.md +0 -217
  52. package/docs/FAQ.md +0 -174
  53. package/docs/ONBOARDING.md +0 -111
  54. package/docs/ORCHESTRATION_RUNTIME.md +0 -173
  55. package/docs/WALKTHROUGH.md +0 -192
  56. /package/.cursor/{anchi-kit.config.yaml → anchi-toolkit.config.yaml} +0 -0
package/README.md CHANGED
@@ -1,132 +1,107 @@
1
- # anchi-toolkit
1
+ # 💎 Anchi Toolkit
2
2
 
3
- **Cursor AI & Antigravity Toolkit** - AI Execution Framework with control, audit, and team scaling.
3
+ > **The Ultimate AI-Native Toolkit for Cursor & Gemini.** > _Biến AI Code Editor thành một Senior Tech Lead thực thụ._
4
4
 
5
- > 🚀 **v1.0.0** | 18 commands | 19 agents | 35 skills | 3 presets | Complete IDE Packages
5
+ [![npm version](https://img.shields.io/npm/v/anchi-toolkit.svg)](https://www.npmjs.com/package/anchi-toolkit)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
7
 
7
8
  ---
8
9
 
9
- ## Quick Start
10
+ ## 🌟 Tại sao lại cần Anchi Toolkit?
10
11
 
11
- ### 🎯 Cài Đặt Chọn Lọc (Recommended)
12
+ Các công cụ AI hiện nay (Cursor, Copilot) rất mạnh về việc viết code, nhưng **thiếu tư duy quản lý**. Chúng thường xuyên:
12
13
 
13
- ```bash
14
- cd your-project
15
- npx anchi-toolkit init
16
- ```
14
+ - ❌ Viết code thừa, sai kiến trúc.
15
+ - ❌ Không biết sợ (xóa file config, hardcode API key).
16
+ - ❌ Mất context khi dự án quá lớn.
17
17
 
18
- Wizard sẽ:
19
- 1. 🔍 Auto-detect tech stack
20
- 2. 📋 Chọn profile (Minimal / Developer / Full)
21
- 3. 📊 Preview size trước khi cài
22
- 4. ✅ Chỉ cài những gì bạn cần
18
+ **Anchi Toolkit** giải quyết vấn đề đó bằng cách cung cấp một **Hệ điều hành tư duy (Operation System for AI)**:
23
19
 
24
- ### 📦 Cài Đặt Nhanh (Full)
20
+ 1. **Stop & Think:** AI phải lập kế hoạch (`/plan`) trước khi gõ code.
21
+ 2. **Risk Aware:** AI tự động dừng lại khi đụng vào file nhạy cảm (Auth, Payment).
22
+ 3. **Role-playing:** AI tự phân vai (Frontend, DevOps, Security) để giải quyết vấn đề.
25
23
 
26
- ```bash
27
- # Cursor AI - Cài tất cả
28
- npx anchi-toolkit install
24
+ ---
29
25
 
30
- # Antigravity (Gemini) - Cài tất cả
31
- npx anchi-toolkit antigravity
32
- ```
26
+ ## 🚀 Tính Năng Nổi Bật (v1.1.0)
33
27
 
34
- ### 🚀 Bắt Đầu
28
+ ### 1. The Core Trinity (Bộ 3 Quyền Lực)
35
29
 
36
- ```
37
- /start → Initialize project
38
- /do "..." → Universal command
39
- /commit → Git operations
40
- ```
30
+ Thay vì nhớ 100 lệnh, bạn chỉ cần 3 lệnh duy nhất:
41
31
 
42
- **That's it!** 🎉
32
+ | Command | Chức năng | Cơ chế ngầm |
33
+ | ---------- | -------------------- | ---------------------------------------------------------- |
34
+ | **/start** | **Smart Resume** | Tự động detect project context, nhắc lại việc đang làm dở. |
35
+ | **/do** | **Universal Action** | Tự động: Plan → Scout → Implement → Test → Review. |
36
+ | **/clean** | **Self-Healing** | Dọn dẹp Memory rác, sửa lỗi config, reset trạng thái AI. |
43
37
 
44
- ---
38
+ ### 2. Infinite Scalability (Mở Rộng Vô Hạn)
39
+
40
+ Project cần dùng công nghệ mới (Rust, Solidity)?
41
+
42
+ > `/skill-learn "Rust Lang"`
45
43
 
46
- ## 📦 What You Get
44
+ AI sẽ **tự động research** tài liệu mới nhất, tổng hợp thành module kiến thức, và áp dụng ngay lập tức. Không cần chờ update tool.
47
45
 
48
- | Component | Count | Description |
49
- |-----------|-------|-------------|
50
- | **Commands** | 18 | AI-powered workflows (`/do`, `/commit`, `/test`...) |
51
- | **Agents** | 19 | Specialized AI personas |
52
- | **Skills** | 35 | Domain knowledge packs |
53
- | **Presets** | 3 | Architecture templates |
46
+ ### 3. Team-Ready (Chuẩn Teamwork)
47
+
48
+ - **Shared Brain:** Toàn bộ Rules & Agents nằm trong Git (`.cursorrules`).
49
+ - **Unified Standard:** Mọi thành viên trong team đều có AI tuân thủ đúng 1 chuẩn code (Naming, Folder structure).
54
50
 
55
51
  ---
56
52
 
57
- ## 🎯 Core Command: `/do`
53
+ ## Cài Đặt & Sử Dụng
58
54
 
59
- One command for everything:
55
+ ### Cài đặt vào dự án có sẵn
60
56
 
61
57
  ```bash
62
- /do "Add user login" # AI decides approach
63
- /do "Fix checkout bug" # Auto-detects fix mode
64
- /do "Refactor API layer" # Refactor mode
65
-
66
- # Flags
67
- /do "feature" --fast # Skip reviews
68
- /do "feature" --careful # Extra validation
58
+ npx anchi-toolkit install
69
59
  ```
70
60
 
71
- ---
61
+ ### Sử dụng (Trong Cursor/Chat)
72
62
 
73
- ## 📊 18 Commands
63
+ **1. Bắt đầu ngày làm việc:**
74
64
 
75
- | Essential | Support | Specialized |
76
- |-----------|---------|-------------|
77
- | `/start` | `/scout` | `/design` |
78
- | `/do` | `/review` | `/generate` |
79
- | `/test` | `/docs` | `/theme` |
80
- | `/commit` | `/status` | `/integrate` |
81
- | `/help` | `/undo` | `/memory` |
65
+ ```bash
66
+ /start
67
+ # AI: "Chào buổi sáng! Hôm qua anh đang làm dở API Login. Có muốn tiếp tục không?"
68
+ ```
82
69
 
83
- 📖 Full reference: [QUICK_REFERENCE.md](./QUICK_REFERENCE.md)
70
+ **2. Giao việc (Đơn giản hay Phức tạp đều cân được):**
84
71
 
85
- ---
72
+ ```bash
73
+ /do "Thêm chức năng Quên Mật Khẩu"
74
+ # AI: "Ok! Tôi sẽ tạo API reset-password, sau đó làm UI, và viết Test."
75
+ ```
86
76
 
87
- ## 🏗️ Presets
77
+ **3. Xem Demo:**
88
78
 
89
- | Preset | Database | Architecture | Best For |
90
- |--------|----------|--------------|----------|
91
- | **Rapid** | SQLite | Flat | MVP, prototype |
92
- | **Professional** | PostgreSQL | Modular | Startup, team |
93
- | **Enterprise** | PostgreSQL + Redis | DDD | Large projects |
79
+ ```bash
80
+ /demo
81
+ # AI: "Server đang chạy tại localhost:3000. Click để xem!"
82
+ ```
94
83
 
95
84
  ---
96
85
 
97
- ## 📚 Documentation
86
+ ## 📚 Tài Liệu Chi Tiết
98
87
 
99
- | Doc | Purpose |
100
- |-----|---------|
101
- | [QUICK_REFERENCE.md](./QUICK_REFERENCE.md) | Command cheat sheet |
102
- | [docs/ALL_COMMANDS.md](./docs/ALL_COMMANDS.md) | Full command reference |
103
- | [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Core concepts, execution model |
104
- | [CHANGELOG.md](./CHANGELOG.md) | Version history |
88
+ - **[Hướng Dẫn Cho Team (Workflow)](docs/WORKFLOW.md)**: Quy trình Git Flow & Code Review.
89
+ - **[Hiến Pháp AI (AI Contract)](docs/AI_CONTRACT.md)**: Các quy tắc an toàn bất khả xâm phạm.
90
+ - **[Danh Sách Lệnh (Full Reference)](docs/ALL_COMMANDS.md)**: Chi tiết các lệnh mở rộng.
91
+ - **[Cấu Hình Antigravity](ANTIGRAVITY.md)**: Dành cho người dùng Gemini Advanced.
105
92
 
106
93
  ---
107
94
 
108
- ## 🌌 Cursor vs Antigravity
109
-
110
- | Aspect | Cursor AI | Antigravity |
111
- |--------|-----------|-------------|
112
- | Install | `npx anchi-toolkit install` | `npx anchi-toolkit antigravity` |
113
- | Location | `.cursor/` | `.antigravity/` |
114
- | Runtime | VS Code extension | Gemini standalone |
95
+ ## 🤝 Contributing
115
96
 
116
- **Same:** Commands, Agents, Skills, Presets, Workflow
97
+ Anchi Toolkit is Open Source. PRs are welcome!
117
98
 
118
- 📖 Details: [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md#-cursor-vs-antigravity)
99
+ 1. Fork the repo
100
+ 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
101
+ 3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
102
+ 4. Push to the branch (`git push origin feature/amazing-feature`)
103
+ 5. Open a Pull Request
119
104
 
120
105
  ---
121
106
 
122
- ## 🔗 Links
123
-
124
- - **npm:** [anchi-toolkit](https://www.npmjs.com/package/anchi-toolkit)
125
- - **GitHub:** [ANCHI-STE/anchi-webkit-dev](https://github.com/ANCHI-STE/anchi-webkit-dev)
126
- - **Issues:** [Report bugs](https://github.com/ANCHI-STE/anchi-webkit-dev/issues)
127
-
128
- ---
129
-
130
- ## 📄 License
131
-
132
- MIT © ANCHI-STE
107
+ **Built with ❤️ for the AI-Native Generation.**
@@ -1,94 +1,52 @@
1
- # 📖 anchi-toolkit Commands
1
+ # 📖 anchi-toolkit Command Reference (v1.1.0)
2
2
 
3
- > v1.0.0 - 18 Commands | Dynamic Orchestration | Cursor + Antigravity
3
+ > **Philosophy:** "Less but Quality" - 3 Main Commands rule them all.
4
4
 
5
5
  ---
6
6
 
7
- ## 🎯 Essential (5)
7
+ ## 💎 The Core Trinity (User Interface)
8
8
 
9
- | Command | Description | Flags |
10
- |---------|-------------|-------|
11
- | `/start` | Initialize project | - |
12
- | `/do "..."` | Universal command (plan, code, fix) | `--fast`, `--careful`, `--plan-only` |
13
- | `/test` | Run tests | `--unit`, `--e2e`, `--coverage` |
14
- | `/commit` | Git operations | `--push`, `--pr`, `--amend` |
15
- | `/help` | Show help | `--beginner` |
9
+ These are the ONLY commands you need to memorize:
16
10
 
17
- ---
18
-
19
- ## 🔧 Support (5)
20
-
21
- | Command | Description | Flags |
22
- |---------|-------------|-------|
23
- | `/scout "..."` | Explore codebase | `--external`, `--deep` |
24
- | `/review` | Code review | `--security`, `--performance` |
25
- | `/docs` | Documentation | `--init`, `--changelog`, `--api` |
26
- | `/status` | Project health dashboard | `--deps`, `--tests` |
27
- | `/undo` | Rollback changes | `--list`, `--force` |
11
+ | Command | Function | Internal Agent |
12
+ | ---------- | -------------------- | ----------------------- |
13
+ | **/start** | Init/Resume Project | `Planner` + `Memory` |
14
+ | **/do** | **Execute Anything** | `Dynamic Orchestration` |
15
+ | **/clean** | Maintenance | `System Cleaner` |
28
16
 
29
17
  ---
30
18
 
31
- ## 🎨 Specialized (5)
19
+ ## Power User Utilities
32
20
 
33
- | Command | Description | Flags |
34
- |---------|-------------|-------|
35
- | `/design "..."` | UI/Domain design | `--domain`, `--screenshot`, `--library` |
36
- | `/generate "..."` | Generate code | `--page`, `--api`, `--component`, `--model` |
37
- | `/theme` | Theme management | `dark`, `light`, `system` |
38
- | `/integrate "..."` | Third-party services | Service name |
39
- | `/memory` | Context management | `save`, `load`, `add` |
21
+ For specific needs:
22
+
23
+ | Command | Function |
24
+ | ---------------- | ------------------------ |
25
+ | **/demo** | Auto-preview (One-Click) |
26
+ | **/skill-learn** | Teach AI new tech |
40
27
 
41
28
  ---
42
29
 
43
- ## 📊 Command Comparison
44
-
45
- | Old (94 commands) | New (15 commands) |
46
- |-------------------|-------------------|
47
- | 8 /plan variants | `/do` handles all |
48
- | 4 /cook variants | `/do` handles all |
49
- | 10 /fix variants | `/do` handles all |
50
- | 4 /auto variants | `/do` handles all |
51
- | 4 /git variants | `/commit` |
52
- | 9 /design variants | `/design` + flags |
53
- | 4 /generate variants | `/generate` + flags |
54
- | 4 /test variants | `/test` + flags |
55
- | 4 /docs variants | `/docs` + flags |
56
- | 4 /memory variants | `/memory` + args |
30
+ ## 🧩 Internal Capabilities (Subsumed by `/do`)
57
31
 
58
- ---
32
+ The following concepts are now handled **automatically** by `/do`. You don't need to call them, but `/do` will use them:
59
33
 
60
- ## 💡 Usage Examples
61
-
62
- ### Beginner
63
- ```
64
- /start # Setup
65
- /do "Add user login" # Everything auto
66
- /commit # Save
67
- ```
68
-
69
- ### Intermediate
70
- ```
71
- /do "Add payment" --careful # With extra validation
72
- /test --coverage # Check coverage
73
- /review --security # Security review
74
- ```
75
-
76
- ### Expert
77
- ```
78
- /do "Complex feature" --plan-only # Plan first
79
- /design "API" --domain # DDD design
80
- /generate "users" --api --full # Full stack
81
- ```
34
+ | Capability | How to trigger |
35
+ | ----------- | ---------------------------------------- |
36
+ | **Testing** | `/do "Run tests"` or `--careful` flag |
37
+ | **Commit** | `/do` auto-commits (if config enabled) |
38
+ | **Design** | `/do "Design API for..."` |
39
+ | **Review** | `/do "Review this file"` |
40
+ | **Scout** | `/do` automatically scouts before acting |
82
41
 
83
42
  ---
84
43
 
85
- ## 🔄 Migration Guide
44
+ ## 🗑️ Legacy Commands (Deprecated)
86
45
 
87
- If you used old commands:
88
- - `/plan`, `/cook`, `/fix`, `/auto:*` → Use `/do`
89
- - `/git:cm`, `/git:pr` → Use `/commit`
90
- - `/design:ui`, `/design:domain` → Use `/design` with flags
91
- - `/generate:page`, `/generate:api` → Use `/generate` with flags
46
+ Do not use these directly anymore:
92
47
 
93
- > Legacy commands have been removed in v3.1.0
48
+ - `/plan`, `/cook`, `/fix` (Use `/do`)
49
+ - `/auto:*` (Use `/do`)
50
+ - `/git:*` (Use `/do`)
94
51
 
52
+ ---
package/docs/CI_CD.md ADDED
@@ -0,0 +1,44 @@
1
+ # ☁️ CI/CD Integration (Cloud Brain)
2
+
3
+ > Mang trí tuệ của Anchi Toolkit lên GitHub Actions để tự động hóa quy trình Review.
4
+
5
+ ---
6
+
7
+ ## 🚀 Setup Automated Review
8
+
9
+ Để kích hoạt "Cloud Brain" cho dự án, bạn làm như sau:
10
+
11
+ ### 1. Cài đặt Workflow
12
+
13
+ Copy file workflow mẫu vào dự án của bạn:
14
+
15
+ ```bash
16
+ mkdir -p .github/workflows
17
+ cp node_modules/anchi-toolkit/presets/ci-cd/ai-review.yml .github/workflows/
18
+ ```
19
+
20
+ _(Nếu cài từ source: copy từ `presets/ci-cd/ai-review.yml`)_
21
+
22
+ ### 2. Cấu hình Secrets (Nếu dùng tính năng AI)
23
+
24
+ Vào **Settings -> Secrets and variables -> Actions**, thêm:
25
+
26
+ - `GEMINI_API_KEY`: API Key của bạn (lấy tại Google AI Studio).
27
+
28
+ ### 3. Tận hưởng
29
+
30
+ Mỗi khi có ai đó tạo **Pull Request**, Anchi Bot sẽ:
31
+
32
+ 1. **Doctor Check:** Kiểm tra cấu trúc project.
33
+ 2. **Safety Net:** Chạy Unit Test tự động.
34
+ 3. **AI Review:** (Coming in v2.0) Đọc diff và comment góp ý trực tiếp.
35
+
36
+ ---
37
+
38
+ ## 🛠️ Customization
39
+
40
+ Bạn có thể sửa file `.github/workflows/ai-review.yml` để thêm các bước:
41
+
42
+ - Build Docker image.
43
+ - Deploy to Vercel/Netlify.
44
+ - Gửi thông báo về Slack/Discord.
@@ -0,0 +1,65 @@
1
+ # ⚔️ Anchi Toolkit vs The World
2
+
3
+ > Tại sao bạn nên chọn Anchi Toolkit thay vì các giải pháp khác?
4
+
5
+ ---
6
+
7
+ ## 📊 Bảng So Sánh Tổng Quan
8
+
9
+ | Tiêu chí | 💎 Anchi Toolkit | 📄 Standard Cursor Rules | 📦 Project Boilerplates | 🤖 Autonomous Agents (Devin) |
10
+ | :------------ | :--------------------------- | :----------------------- | :---------------------- | :--------------------------- |
11
+ | **Bản chất** | **AI Operation System** | Files text hướng dẫn | Code khung có sẵn | Kỹ sư ảo độc lập |
12
+ | **Khả năng** | Orchestration, Memory, Tools | Chỉ nhắc prompt system | Setup thư viện | Tự làm mọi thứ (chậm) |
13
+ | **Kiểm soát** | ✅ Cao (Human-in-the-loop) | ✅ Cao | ✅ Cao | ❌ Thấp (Hộp đen) |
14
+ | **Chi phí** | **Miễn phí (Open Source)** | Miễn phí | Miễn phí | Rất đắt ($500+/tháng) |
15
+ | **An toàn** | **Risk Check + Git Hooks** | Không có | Không có | Rủi ro cao |
16
+ | **Tiến hóa** | **Tự học Skill mới** | Cố định | Cố định | Có thể |
17
+
18
+ ---
19
+
20
+ ## 🔍 Phân Tích Chi Tiết
21
+
22
+ ### 1. vs. Standard Cursor Rules (`.cursorrules` đơn lẻ)
23
+
24
+ Nhiều người chỉ copy một file `.cursorrules` dài 1000 dòng vào dự án.
25
+
26
+ - **Vấn đề:**
27
+ - AI bị loạn vì prompt quá dài (Context window bị chiếm dụng).
28
+ - Không có quy trình. AI sửa code lung tung.
29
+ - **Anchi Toolkit:**
30
+ - Chia nhỏ quy tắc thành **Agents & Skills**. Chỉ load những gì cần thiết (Context Saving).
31
+ - Có **Process** (`/plan` -> `/do` -> `/check`). AI làm việc có trình tự.
32
+
33
+ ### 2. vs. Project Boilerplates (T3 App, Next.js Starter)
34
+
35
+ Các bộ starter kit giúp bạn setup project nhanh (Tailwind, Prisma...).
36
+
37
+ - **Vấn đề:**
38
+ - Chỉ giúp lúc đầu. Sau khi init xong, bạn phải tự bơi.
39
+ - Không có AI đi kèm để support maintain.
40
+ - **Anchi Toolkit:**
41
+ - Đi kèm dự án **trọn đời**.
42
+ - Là "Senior Lead" ảo: Review code, nhắc nhở test, cảnh báo bảo mật mãi mãi.
43
+
44
+ ### 3. vs. Autonomous Agents (Devin, AutoGPT)
45
+
46
+ Các tool hứa hẹn "thay thế lập trình viên".
47
+
48
+ - **Vấn đề:**
49
+ - Chậm, đắt, và hay đi vào ngõ cụt (loop).
50
+ - Khó tích hợp vào quy trình team hiện tại.
51
+ - **Anchi Toolkit:**
52
+ - Triết lý **"Iron Man Suit"**: Không thay thế bạn, mà làm bạn mạnh lên gấp 10 lần.
53
+ - Tích hợp thẳng vào VS Code/Cursor -> Không thay đổi thói quen làm việc.
54
+
55
+ ---
56
+
57
+ ## 🏆 Kết Luận
58
+
59
+ **Anchi Toolkit** là sự cân bằng hoàn hảo:
60
+
61
+ - Thông minh hơn file text thông thường.
62
+ - Kiểm soát tốt hơn Agent tự động.
63
+ - Đồng hành lâu dài hơn Boilerplate.
64
+
65
+ > **"Không chỉ là Code. Đây là cách Code Mới."**
package/docs/ROADMAP.md CHANGED
@@ -1,184 +1,68 @@
1
- # Project Roadmap
1
+ # 🗺️ Project Roadmap
2
2
 
3
- > ⚠️ **Template:** Điền lộ trình phát triển của dự án.
3
+ ## v1.0 - Foundation (Completed)
4
4
 
5
- ---
6
-
7
- ## Current Status
8
-
9
- | Phase | Status | Progress |
10
- |-------|--------|----------|
11
- | Phase 1: MVP | 🔄 In Progress | [X]% |
12
- | Phase 2: Enhancement | ⏳ Planned | 0% |
13
- | Phase 3: Scale | ⏳ Planned | 0% |
14
-
15
- **Last Updated:** [DD/MM/YYYY]
16
-
17
- ---
18
-
19
- ## Phase 1: MVP
20
-
21
- **Timeline:** [Start Date] → [End Date]
22
- **Goal:** [Mục tiêu chính của phase này]
23
-
24
- ### Features
25
-
26
- | Feature | Priority | Status | Owner | Notes |
27
- |---------|----------|--------|-------|-------|
28
- | [Feature 1] | 🔴 High | ✅ Done | [Name] | |
29
- | [Feature 2] | 🔴 High | 🔄 In Progress | [Name] | |
30
- | [Feature 3] | 🟡 Medium | ⬜ Planned | [Name] | |
31
- | [Feature 4] | 🟢 Low | ⬜ Planned | [Name] | |
32
-
33
- ### Milestones
34
-
35
- | Milestone | Target Date | Status |
36
- |-----------|-------------|--------|
37
- | Core setup complete | [Date] | ✅ Done |
38
- | Auth working | [Date] | 🔄 In Progress |
39
- | MVP Demo | [Date] | ⬜ Planned |
40
- | MVP Launch | [Date] | ⬜ Planned |
41
-
42
- ### Deliverables
43
-
44
- - [ ] [Deliverable 1]
45
- - [ ] [Deliverable 2]
46
- - [ ] [Deliverable 3]
47
-
48
- ---
49
-
50
- ## Phase 2: Enhancement
51
-
52
- **Timeline:** [Start Date] → [End Date]
53
- **Goal:** [Mục tiêu chính]
54
-
55
- ### Features
56
-
57
- | Feature | Priority | Status | Description |
58
- |---------|----------|--------|-------------|
59
- | [Feature 5] | 🔴 High | ⬜ Planned | [Mô tả] |
60
- | [Feature 6] | 🟡 Medium | ⬜ Planned | [Mô tả] |
61
-
62
- ### Technical Improvements
63
-
64
- | Improvement | Priority | Status | Description |
65
- |-------------|----------|--------|-------------|
66
- | Performance optimization | 🟡 Medium | ⬜ Planned | [Mô tả] |
67
- | Test coverage increase | 🟡 Medium | ⬜ Planned | [Mô tả] |
68
-
69
- ---
70
-
71
- ## Phase 3: Scale
5
+ - [x] Core Command Trinity (`/start`, `/do`, `/clean`)
6
+ - [x] Agent Orchestration System
7
+ - [x] Project Recall (Continuity)
8
+ - [x] Documentation Refactoring
72
9
 
73
- **Timeline:** [Start Date] [End Date]
74
- **Goal:** [Mục tiêu chính]
10
+ ## v1.1 - Performance (Completed)
75
11
 
76
- ### Features
77
-
78
- | Feature | Priority | Status | Description |
79
- |---------|----------|--------|-------------|
80
- | [Feature 7] | 🔴 High | ⬜ Planned | [Mô tả] |
81
- | [Feature 8] | 🟡 Medium | ⬜ Planned | [Mô tả] |
82
-
83
- ### Infrastructure
84
-
85
- | Task | Priority | Status | Description |
86
- |------|----------|--------|-------------|
87
- | [Scaling task] | 🔴 High | ⬜ Planned | [Mô tả] |
12
+ - [x] Personalization (`user.yaml`)
13
+ - [x] Automation Enforcer (Git Hooks)
14
+ - [x] Infinite Scalability (`/skill-learn`)
15
+ - [x] One-Click Demo (`/demo`)
88
16
 
89
17
  ---
90
18
 
91
- ## Backlog
19
+ ## 🚧 v2.0 - The "Deep Tech" Era (Planned)
92
20
 
93
- ### Features (Unscheduled)
21
+ ### 1. 🖥️ Interactive CLI (UX Upgrade)
94
22
 
95
- | Feature | Priority | Estimate | Notes |
96
- |---------|----------|----------|-------|
97
- | [Backlog item 1] | 🟢 Low | [X days] | [Notes] |
98
- | [Backlog item 2] | 🟢 Low | [X days] | [Notes] |
23
+ Biến CLI khô khan thành trải nghiệm GUI trên Terminal.
99
24
 
100
- ### Technical Debt
25
+ - **Tech:** `ink` (React for CLIs) hoặc `prompts`.
26
+ - **Features:**
27
+ - Visual Preset Selector (Mũi tên chọn).
28
+ - Animated Progress Bars.
29
+ - Interactive Dashboard cho lệnh `/status`.
101
30
 
102
- | Item | Priority | Estimate | Notes |
103
- |------|----------|----------|-------|
104
- | [Tech debt 1] | 🟡 Medium | [X days] | [Notes] |
105
- | [Tech debt 2] | 🟢 Low | [X days] | [Notes] |
31
+ ### 2. 🕸️ Knowledge Graph (Memory v2)
106
32
 
107
- ---
33
+ Nâng cấp bộ nhớ từ Text phẳng -> Đồ thị quan hệ.
108
34
 
109
- ## Completed
35
+ - **Structure:** Graph Database (JSON-based adjacency list).
36
+ - **Nodes:** File, Function, Class, Component.
37
+ - **Edges:** `imports`, `calls`, `extends`, `depends_on`.
38
+ - **Benefit:** Khi sửa A, AI biết chính xác B, C, D bị ảnh hưởng.
110
39
 
111
- ### Done
112
-
113
- | Feature | Completed Date | Notes |
114
- |---------|----------------|-------|
115
- | [Completed feature 1] | [Date] | [Notes] |
116
- | [Completed feature 2] | [Date] | [Notes] |
117
-
118
- ---
40
+ ### 3. 🔄 Self-Updater (Living Knowledge)
119
41
 
120
- ## Changelog
42
+ Hệ thống tự động cập nhật kiến thức công nghệ.
121
43
 
122
- ### [Version X.X.X] - [Date]
44
+ - **Agent:** `Trend Watcher`.
45
+ - **Trigger:** Scheduler (Weekly) hoặc Manual (`/update-skills`).
46
+ - **Action:**
47
+ - Crawl Github Release Notes của các key libraries (Next, React).
48
+ - Detect Breaking Changes.
49
+ - Cập nhật `.cursor/skills/` templates.
123
50
 
124
- **Added:**
125
- - [New feature 1]
126
- - [New feature 2]
51
+ ### 4. ☁️ CI/CD Integration (Cloud Brain)
127
52
 
128
- **Changed:**
129
- - [Change 1]
53
+ Mang trí tuệ nhân tạo lên Cloud (GitHub Actions).
130
54
 
131
- **Fixed:**
132
- - [Bug fix 1]
55
+ - **Feature:** `anchi-action`.
56
+ - **Trigger:** Pull Request.
57
+ - **Action:**
58
+ - Tự động chạy `/review`.
59
+ - Comment trực tiếp vào PR nếu thấy lỗi logic/bảo mật.
60
+ - Block merge nếu Risk Check đỏ.
61
+ - **Benefit:** Code Review tự động 24/7.
133
62
 
134
63
  ---
135
64
 
136
- ### [Version X.X.X] - [Date]
137
-
138
- **Added:**
139
- - [New feature]
140
-
141
- ---
142
-
143
- ## Dependencies & Blockers
144
-
145
- ### Current Blockers
146
-
147
- | Blocker | Impact | Owner | Resolution Plan |
148
- |---------|--------|-------|-----------------|
149
- | [Blocker 1] | High/Med/Low | [Name] | [Plan] |
150
-
151
- ### Dependencies
152
-
153
- | Dependency | Depends On | Status |
154
- |------------|------------|--------|
155
- | [Feature X] | [Feature Y] | Waiting |
156
-
157
- ---
158
-
159
- ## Resource Allocation
160
-
161
- | Phase | Team Size | Duration |
162
- |-------|-----------|----------|
163
- | Phase 1 | [X] people | [X] weeks |
164
- | Phase 2 | [X] people | [X] weeks |
165
- | Phase 3 | [X] people | [X] weeks |
166
-
167
- ---
168
-
169
- ## Legend
170
-
171
- | Symbol | Meaning |
172
- |--------|---------|
173
- | ✅ | Done |
174
- | 🔄 | In Progress |
175
- | ⬜ | Planned |
176
- | ⏳ | Waiting |
177
- | ❌ | Cancelled |
178
- | 🔴 | High Priority |
179
- | 🟡 | Medium Priority |
180
- | 🟢 | Low Priority |
181
-
182
- ---
65
+ ## 🔮 Future Concepts
183
66
 
184
- > 💡 **Tip:** Cập nhật file này mỗi tuần hoặc sau mỗi sprint. AI sẽ đọc file này khi bạn dùng `/plan` để đề xuất features phù hợp với roadmap.
67
+ - Voice Command Interface?
68
+ - VS Code Extension Integration?