🧠 THE ULTIMATE AI AGENT BRAIN (Bộ Não AI Siêu Cấp)

"Đừng để AI code thay bạn, hãy để AI code cùng bạn như một Senior Engineer thực thụ." "Don't let AI code for you, let AI code with you like a true Senior Engineer."

🇻🇳 TIẾNG VIỆT: BIẾN AI THÀNH ĐỒNG ĐỘI "CHẤT CHƠI"

Bạn có mệt mỏi khi AI (Cursor, Windsurf, Trae...) hay quên trước quên sau? Code lúc thì ngon, lúc thì "ngáo"? Chào mừng bạn đến với HỆ ĐIỀU HÀNH dành cho AI Agent. Đây không chỉ là prompt, đây là LINH HỒN giúp AI có kỷ luật, có trí nhớ và có... lương tâm.

🚀 TÍNH NĂNG NỔI BẬT

1. Kỷ Luật Thép: AI sẽ không dám any lung tung, không dám sửa code mà không hiểu.
2. Trí Nhớ Dai: Với cơ chế SESSION_HISTORY và BRAIN_SYNC, AI sẽ nhớ dai như người yêu cũ.
3. Lương Tâm (Conscience): AI biết sợ sai nhờ lesson_learned và TRUST_SCORE.
4. Smart Build (Zero-Config): Tự động nhận diện Framework (Next.js, React...), Database và Ngành nghề để cấu hình chỉ trong 1 giây.
5. Domain Mastery: Hỗ trợ 10+ ngành nghề chuyên biệt (Fintech, Healthcare, GameDev, Storytelling...) với bộ kỹ năng và quy trình riêng.
6. Phong Cách Riêng:
   • 🇻🇳 Tiếng Việt: Hài hước, tận tụy, gọi "Sếp" xưng "Em".
   • 🇺🇸 English: Professional, Strict, Engineering-focused.

🛠️ HƯỚNG DẪN CÀI ĐẶT (QUICK START)

Bước 1: Chuẩn bị

• Mở Terminal (CMD, PowerShell, hoặc terminal trong VS Code).
• Di chuyển vào thư mục dự án của bạn (nơi bạn muốn cài Agent Brain):

  cd path/to/your-project

Bước 2: Chạy lệnh khởi tạo Bạn KHÔNG cần tải repo này về. Chỉ cần đứng tại dự án của bạn và chạy:

npx meowbaby-agent-brain

(Hoặc node path/to/this/repo/index.js nếu bạn đang dùng bản local)

💡 CÁC BƯỚC THỰC HIỆN

1. Chạy CLI: Chọn ngôn ngữ và chế độ (Smart Build hoặc Manual).
2. Kích hoạt Agent: Mở AI chat (Cursor, Trae, Windsurf...) và gõ:

   "Hãy đọc file .agent/AGENTS.md và nạp Hiến pháp để bắt đầu."

3. Sử dụng Workflow: Gõ /recap để đồng bộ não hoặc /debug khi gặp lỗi.

📸 CLI PREVIEW

• Menu tương tác: Chọn ngôn ngữ, Framework, Database.
• Tự động điền: Tên dự án, tên Agent, Style guide.
• Học hỏi: Chế độ "Deep Dive" giúp bạn hiểu rõ từng file cấu hình trước khi cài.

📂 CẤU TRÚC KHO TÀNG (FOLDER .agent)

Sau khi chạy CLI, bạn sẽ có cấu trúc thư mục chuẩn cơm mẹ nấu:

| File | Chức năng (Role) | Mô tả "Chợ Búa" | |------|------------------|-----------------| | AGENTS.md | Hiến Pháp | Luật rừng. AI đọc xong là ngoan như cún. | | brain/lesson_learned.md | Lương Tâm | Cuốn sổ ghi thù. Ghi lại mấy cái ngu để không lặp lại. | | brain/session_history.md | Trí Nhớ | Nhật ký đời tôi. Để mai làm tiếp không bị ngáo. | | brain/trust_sentinel.md | Ví Tiền | Điểm tín nhiệm. Làm sai trừ điểm, làm tốt cộng điểm. |

🔄 QUY TRÌNH "PRO" (WORKFLOWS)

Sử dụng các lệnh đặc biệt để điều khiển AI cực kỳ chuyên nghiệp:

• /recap: Nạp lại toàn bộ trí nhớ vào đầu ngày.
• /plan: Lên kế hoạch chi tiết trước khi code.
• /debug: Phân tích nguyên nhân gốc rễ (5 Whys) thay vì sửa mò.
• /audit: Kiểm định chất lượng toàn dự án.
• /auto_optimize: Tự động tối ưu hiệu năng/SEO.
• /evolve: Protocol cho AI tự nâng cấp kiến trúc hệ thống.

⭐ Nếu thấy hay, hãy cho repo này 1 Star để AI bớt "ngáo" nhé!

🇺🇸 ENGLISH: THE PROFESSIONAL AI AGENT FRAMEWORK

Tired of AI losing context? Generating buggy code? Breaking your production build? Welcome to the EXTERNAL BRAIN for AI Agents. This framework provides Structure, Memory, and Conscience to your LLM-based coding assistants (Cursor, Windsurf, Trae).

🚀 WHY DO YOU NEED THIS?

1. Enforced Discipline: AI follows strict engineering standards (Atomic Edits, No any, RPM).
2. Persistent Context: Mechanisms like SESSION_HISTORY ensure the AI remembers past decisions.
3. Self-Correction: The lesson_learned system prevents the AI from repeating the same mistakes.
4. Smart Build (Zero-Config): Auto-detects Frameworks, DBs, and Domains for instant setup.
5. Industry Mastery: 10+ tailored presets for Fintech, Healthcare, Data Science, etc.
6. Professional Workflow: Based on real-world Senior Engineering practices (Post-Mortems, RFCs, Architecture Reviews).

🛠️ INSTALLATION GUIDE (QUICK START)

Step 1: Preparation

• Open your Terminal (CMD, PowerShell, or VS Code terminal).
• Navigate to your project's root directory:

  cd path/to/your-project

Step 2: Run the Command You DON'T need to download this repository manually to use it. Just run this inside your project:

npx meowbaby-agent-brain

(Or node path/to/this/repo/index.js if you are using a local copy)

💡 HOW TO USE

1. Run the CLI: Choose Smart Build (Auto-detect) or Manual configuration.
2. Activate Agent: Open your AI chat (Cursor, Trae...) and type:

   "Read .agent/AGENTS.md and load the Constitution to get started."

3. Execute Workflows: Use /recap to sync context or /debug for diagnostics.

�📂 THE ARSENAL (FOLDER .agent)

| File | Role | Description | |------|------|-------------| | AGENTS.md | Constitution | The core laws and persona of the Agent. | | brain/lesson_learned.md | Conscience | A log of anti-patterns and past failures to avoid. | | brain/session_history.md | Memory | Session logs to maintain context across days. | | brain/trust_sentinel.md | Resources | Tracks "Trust Score" and API usage/limits. |

🛠️ PRO WORKFLOWS

Command your AI using specialized SOPs:

• /recap: Sync context at the start of a session.
• /plan: Create technical specs before implementation.
• /debug: Root Cause Analysis using the 5 Whys method.
• /audit: Full project quality and security audit.
• /auto_optimize: Automated performance and SEO tuning.
• /evolve: Recursive self-improvement for the system architecture.

⭐ Star this repo if you want your AI to code like a Pro!