Aevum Plan Manager

Aevum là hệ thống quản lý kế hoạch và ngữ cảnh dành cho AI Agent theo domain, tích hợp trực tiếp vào VS Code.

Aevum được tạo ra cho những project có tuổi thọ dài, nhiều quyết định, nhiều ngữ cảnh, và cần AI làm việc như một teammate thực sự, không phải một công cụ trả lời ngẫu nhiên.

Aevum is not about prompts. It is about memory, structure, and intent.

Vấn đề Aevum hướng tới

Khi project lớn dần, những vấn đề quen thuộc bắt đầu xuất hiện:

• AI không nắm được bối cảnh dài hạn
• Kế hoạch nằm rải rác trong issue, chat, hoặc trong đầu người viết
• Mỗi lần tương tác, AI phải “hiểu lại từ đầu”
• Quyết định giữa các domain thiếu sự liên kết

Aevum không cố gắng thay đổi cách bạn code. Aevum tổ chức lại cách project được suy nghĩ.

Aevum mang lại điều gì?

• Mỗi domain có ngữ cảnh riêng, độc lập nhưng nhất quán
• Kế hoạch được viết ra, lưu trữ, và có thể đọc lại
• AI Agent có điểm tựa để suy luận, không chỉ phản ứng
• Project có một “bộ nhớ ngoài” rõ ràng và có cấu trúc

Cách tích hợp vào VS Code

Chạy thử trong môi trường phát triển

1. Mở source Aevum trong VS Code

2. Cài đặt dependencies:

   npm install
   

3. Chạy extension bằng F5

4. Mở cửa sổ Extension Development Host Aevum sẽ xuất hiện trong Activity Bar

Cài đặt chính thức bằng file .vsix

1. Cài công cụ đóng gói:

   npm install -g @vscode/vsce
   

2. Đóng gói extension:

   vsce package
   

3. Cài đặt file .vsix vào VS Code

Sử dụng Aevum trong project

Khởi tạo

Trong project cần quản lý:

1. Mở Command Palette

2. Chạy:

   Aevum: Initialize Project
   

3. Thư mục .aevum/ sẽ được tạo ở root

Domain

Domain đại diện cho một mảng tư duy của project.

Ví dụ:

• Authentication
• Database
• Payment
• UI/UX
• AI / Agent Logic

Mỗi domain có ngữ cảnh riêng và tập kế hoạch riêng.

Plan

Plan là nơi mọi thứ trở nên cụ thể:

• Mục tiêu
• Phạm vi
• Các bước thực hiện
• Quyết định đã được đưa ra

Plan không chỉ để con người đọc. Plan được viết để AI có thể hiểu và làm việc tiếp.

Cấu trúc thư mục

.aevum/
├── index.json
├── global/
│   └── agent_rules.md
└── domains/
    └── [domain-id]/
        ├── context.md
        └── plans/

• global/ xác định cách AI nên suy nghĩ trong toàn project
• context.md lưu ngữ cảnh dài hạn của domain
• plans/ lưu các quyết định và kế hoạch có chủ đích

Triết lý

AI không thiếu khả năng. AI thiếu ngữ cảnh ổn định.

Aevum tồn tại để giải quyết đúng vấn đề đó.

Hướng phát triển

• Liên kết plan với AI Agent
• Quan hệ phụ thuộc giữa các domain
• Theo dõi tiến độ theo plan
• Hỗ trợ nhiều agent làm việc cùng một project