# AutoPOE2 - Atomic Instincts Engine

Hệ thống lưu trữ và tra cứu **Phản xạ Vi mô (Atomic Instincts)** cho các Tác tử AI (Antigravity & Sub-Agents) trong dự án AutoPOE2.

## 1. Triết Lý & Mục Đích
- **Tránh phình to tài liệu Hiến pháp (`AGENTS.md`)**: Thay vì mỗi khi giải quyết một lỗi kỹ thuật phức tạp lại chèn thêm đoạn văn dài vào `AGENTS.md`, các bài học kinh nghiệm được đóng gói thành các **Instinct** vi mô, độc lập và có thể tra cứu nhanh.
- **Dựa trên Thực nghiệm 100% (Empirical Validation)**: Chỉ những bài học đã được kiểm chứng thành công bằng code chạy thật trên POE2 mới được lưu thành Instinct.
- **Hệ thống Điểm Tin Cậy (Confidence Score 0.3 – 0.9)**:
  - `0.3 - 0.5`: Phát hiện ban đầu, mới thử nghiệm trong môi trường mock/sandbox.
  - `0.6 - 0.8`: Đã kiểm chứng thành công trên một tình huống game cụ thể.
  - `0.9`: Đã xác thực qua nhiều lần chạy live, vượt qua bộ test tự động và không có tác dụng phụ.

## 2. Cấu Trúc Chuẩn Của Một Tệp Instinct
Mỗi tệp trong thư mục này chứa một hoặc nhiều khối YAML Frontmatter theo mẫu:

```yaml
---
id: <ma-dinh-danh-duy-nhat>
trigger: "khi gap tinh huong X hoac tu khoa Y"
confidence: 0.85
domain: "memory_re" | "cpp_hotpath" | "python_eda" | "hardware_safety" | "build_toolchain"
scope: "project" # hoac "global"
summary: "Tom tat ngan gon bai hoc"
---
### Bối Cảnh & Hiện Tượng
...
### Nguyên Nhân Gốc Rễ (RCA)
...
### Phản Xạ Hành Động Khuyến Nghị
...
### Bằng Chứng Thực Nghiệm (Evidence)
...
```

## 3. Danh Mục Instincts Hiện Có
- [`memory_reverse_engineering.md`](./memory_reverse_engineering.md): Quét con trỏ động XYZ 16MB, kháng UI marker 778/779.
- [`windows_build_locking.md`](./windows_build_locking.md): Xử lý lỗi khóa file thực thi Windows `LNK1104` khi biên dịch C++.