Ai Forge

AWF Enterprise Template v4.1

🇬🇧 [English README](README.en.md)

AWF là **template workflow phát triển phần mềm bằng AI trung lập với client**. Nó cung cấp cho repository một policy vận hành chuẩn duy nhất, cấu hình cục bộ theo từng project, workflow contract, verification gate và các adapter mỏng cho những môi trường AI coding tương thích với Codex, Gemini/Antigravity và Claude.

AWF **không phải** model router, không hứa hẹn việc giao phần mềm hoàn toàn không cần giám sát, và không thay thế cơ chế an toàn native của client mà bạn đang sử dụng.

Vì sao có v4.1

Các phiên bản trước dần tích lũy nhiều giả định gắn với máy của người tạo template: command package manager bị hard-code trong rule, tên provider/model xuất hiện trong workflow, cú pháp riêng của từng client bị đưa vào shared policy, và runtime state của maintainer có thể bị mang sang project mới.

v4.1 thay đổi mô hình phân phối theo hướng **canonical core + native adapters**:

                         AWF CORE
                policy / contracts / state
                          |
                    .awf/manifest.json
                          |
                     init / sync
                          |
        ---------------------------------------
        |                  |                  |
     AGENTS.md          GEMINI.md          CLAUDE.md
   compatible clients   Gemini-family      Claude-family
        |                  |                  |
        ---------------- capabilities --------
                          |
                  project toolchain
               npm / pnpm / yarn / bun

Repository được tổ chức quanh 6 nguyên tắc:

1. Một canonical policy — .awf/policy/core.md là policy trung lập với client.
2. Cấu hình cục bộ theo project — .awf/manifest.json lưu project identity, logical commands, clients và trạng thái integrations.
3. Native adapters thay vì nhân bản policy — AGENTS.md, GEMINI.md, CLAUDE.md chứa vùng do AWF quản lý nhưng vẫn giữ