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.
- package/.ai-audit/README.md +53 -0
- package/.ai-memory/README.md +137 -0
- package/.ai-memory/context.json +26 -0
- package/.ai-memory/decisions.json +3 -0
- package/.antigravity/agent-skill-index.yaml +24 -0
- package/.antigravity/anchi-toolkit.config.yaml +12 -0
- package/.antigravity/docs/README.md +9 -0
- package/.antigravity/skills/_template.md +30 -0
- package/.antigravity/team.yaml +154 -0
- package/.antigravity/workflows/config.md +144 -0
- package/.antigravity/workflows/demo.md +50 -0
- package/.antigravity/workflows/help.md +11 -4
- package/.antigravity/workflows/skill-learn.md +48 -0
- package/.antigravity/workflows/start.md +38 -117
- package/.antigravity/workflows/status.md +8 -8
- package/.antigravity/workflows/undo.md +7 -7
- package/.cursor/agent-skill-index.yaml +39 -0
- package/.cursor/agents/graph-architect.md +30 -0
- package/.cursor/agents/trend-watcher.md +24 -0
- package/.cursor/commands/config.md +144 -0
- package/.cursor/commands/demo.md +50 -0
- package/.cursor/commands/do.md +127 -90
- package/.cursor/commands/help.md +23 -16
- package/.cursor/commands/skill-learn.md +48 -0
- package/.cursor/commands/start.md +38 -117
- package/.cursor/commands/status.md +19 -19
- package/.cursor/commands/undo.md +19 -19
- package/.cursor/orchestration.yaml +18 -0
- package/.cursor/skills/_template.md +30 -0
- package/ANTIGRAVITY.md +84 -0
- package/CURSOR.md +50 -157
- package/LICENSE +17 -14
- package/README.md +64 -89
- package/docs/ALL_COMMANDS.md +31 -73
- package/docs/CI_CD.md +44 -0
- package/docs/COMPARISON.md +65 -0
- package/docs/ROADMAP.md +45 -161
- package/docs/WORKFLOW.md +56 -317
- package/package.json +9 -2
- package/presets/ci-cd/ai-review.yml +49 -0
- package/scripts/install-hooks.ps1 +21 -7
- package/scripts/install-hooks.sh +18 -3
- package/src/cli.js +111 -59
- package/src/commands/clean.js +87 -0
- package/src/commands/doctor.js +88 -21
- package/src/commands/init.js +22 -2
- package/src/commands/uninstall.js +17 -2
- package/src/lib/configManager.js +20 -5
- package/src/lib/memoryManager.js +7 -4
- package/docs/CODEBASE.md +0 -178
- package/docs/COMMAND_MAPPING.md +0 -217
- package/docs/FAQ.md +0 -174
- package/docs/ONBOARDING.md +0 -111
- package/docs/ORCHESTRATION_RUNTIME.md +0 -173
- package/docs/WALKTHROUGH.md +0 -192
- /package/.cursor/{anchi-kit.config.yaml → anchi-toolkit.config.yaml} +0 -0
package/README.md
CHANGED
|
@@ -1,132 +1,107 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 💎 Anchi Toolkit
|
|
2
2
|
|
|
3
|
-
**
|
|
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
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/anchi-toolkit)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
7
|
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
##
|
|
10
|
+
## 🌟 Tại sao lại cần Anchi Toolkit?
|
|
10
11
|
|
|
11
|
-
|
|
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
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
27
|
-
# Cursor AI - Cài tất cả
|
|
28
|
-
npx anchi-toolkit install
|
|
24
|
+
---
|
|
29
25
|
|
|
30
|
-
|
|
31
|
-
npx anchi-toolkit antigravity
|
|
32
|
-
```
|
|
26
|
+
## 🚀 Tính Năng Nổi Bật (v1.1.0)
|
|
33
27
|
|
|
34
|
-
###
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
-
##
|
|
53
|
+
## � Cài Đặt & Sử Dụng
|
|
58
54
|
|
|
59
|
-
|
|
55
|
+
### Cài đặt vào dự án có sẵn
|
|
60
56
|
|
|
61
57
|
```bash
|
|
62
|
-
|
|
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
|
-
|
|
63
|
+
**1. Bắt đầu ngày làm việc:**
|
|
74
64
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
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
|
-
|
|
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
|
-
|
|
77
|
+
**3. Xem Demo:**
|
|
88
78
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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
|
-
## 📚
|
|
86
|
+
## 📚 Tài Liệu Chi Tiết
|
|
98
87
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
97
|
+
Anchi Toolkit is Open Source. PRs are welcome!
|
|
117
98
|
|
|
118
|
-
|
|
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
|
-
|
|
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.**
|
package/docs/ALL_COMMANDS.md
CHANGED
|
@@ -1,94 +1,52 @@
|
|
|
1
|
-
# 📖 anchi-toolkit
|
|
1
|
+
# 📖 anchi-toolkit Command Reference (v1.1.0)
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> **Philosophy:** "Less but Quality" - 3 Main Commands rule them all.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## 💎 The Core Trinity (User Interface)
|
|
8
8
|
|
|
9
|
-
|
|
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
|
-
|
|
20
|
-
|
|
21
|
-
|
|
|
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
|
-
##
|
|
19
|
+
## ⚡ Power User Utilities
|
|
32
20
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
|
|
|
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
|
-
##
|
|
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
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
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
|
-
##
|
|
44
|
+
## 🗑️ Legacy Commands (Deprecated)
|
|
86
45
|
|
|
87
|
-
|
|
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
|
-
|
|
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
|
-
|
|
3
|
+
## ✅ v1.0 - Foundation (Completed)
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
74
|
-
**Goal:** [Mục tiêu chính]
|
|
10
|
+
## ✅ v1.1 - Performance (Completed)
|
|
75
11
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
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
|
-
##
|
|
19
|
+
## 🚧 v2.0 - The "Deep Tech" Era (Planned)
|
|
92
20
|
|
|
93
|
-
###
|
|
21
|
+
### 1. 🖥️ Interactive CLI (UX Upgrade)
|
|
94
22
|
|
|
95
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
###
|
|
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
|
-
|
|
42
|
+
Hệ thống tự động cập nhật kiến thức công nghệ.
|
|
121
43
|
|
|
122
|
-
|
|
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
|
-
|
|
125
|
-
- [New feature 1]
|
|
126
|
-
- [New feature 2]
|
|
51
|
+
### 4. ☁️ CI/CD Integration (Cloud Brain)
|
|
127
52
|
|
|
128
|
-
|
|
129
|
-
- [Change 1]
|
|
53
|
+
Mang trí tuệ nhân tạo lên Cloud (GitHub Actions).
|
|
130
54
|
|
|
131
|
-
**
|
|
132
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
67
|
+
- Voice Command Interface?
|
|
68
|
+
- VS Code Extension Integration?
|