Quản lý Project Context

Sử dụng tệp project-context.md để đảm bảo các agent AI tuân theo ưu tiên kỹ thuật và quy tắc triển khai của dự án trong suốt mọi workflow. Để đảm bảo tệp này luôn sẵn có, bạn cũng có thể thêm dòng Important project context and conventions are located in [path to project context]/project-context.md vào file context của công cụ hoặc file always rules của bạn (như AGENTS.md).

Khi nào nên dùng

Bạn có các ưu tiên kỹ thuật rõ ràng trước khi bắt đầu làm kiến trúc
Bạn đã hoàn thành kiến trúc và muốn ghi lại các quyết định để phục vụ triển khai
Bạn đang làm việc với một codebase hiện có có những pattern đã ổn định
Bạn thấy các agent đưa ra quyết định không nhất quán giữa các story

Bước 1: Chọn cách tiếp cận

Tự tạo bằng tay - Phù hợp nhất khi bạn biết rõ cần tài liệu hóa quy tắc nào

Tạo sau kiến trúc - Phù hợp để ghi lại các quyết định đã được đưa ra trong giai đoạn solutioning

Tạo cho dự án hiện có - Phù hợp để khám phá pattern trong các codebase đã tồn tại

Bước 2: Tạo tệp

Lựa chọn A: Tạo thủ công

Tạo tệp tại _bmad-output/project-context.md:

mkdir -p _bmad-output
touch _bmad-output/project-context.md

Thêm stack công nghệ và các quy tắc triển khai của bạn:

---
project_name: 'MyProject'
user_name: 'YourName'
date: '2026-02-15'
sections_completed: ['technology_stack', 'critical_rules']
---

# Project Context for AI Agents

## Technology Stack & Versions

- Node.js 20.x, TypeScript 5.3, React 18.2
- State: Zustand
- Testing: Vitest, Playwright
- Styling: Tailwind CSS

## Critical Implementation Rules

**TypeScript:**
- Strict mode enabled, no `any` types
- Use `interface` for public APIs, `type` for unions

**Code Organization:**
- Components in `/src/components/` with co-located tests
- API calls use `apiClient` singleton — never fetch directly

**Testing:**
- Unit tests focus on business logic
- Integration tests use MSW for API mocking

Lựa chọn B: Tạo sau khi hoàn thành kiến trúc

Chạy workflow trong một phiên chat mới:

bmad-generate-project-context

Workflow sẽ quét tài liệu kiến trúc và tệp dự án để tạo tệp context ghi lại các quyết định đã được đưa ra.

Lựa chọn C: Tạo cho dự án hiện có

Với các dự án hiện có, chạy:

bmad-generate-project-context

Workflow sẽ phân tích codebase để nhận diện quy ước, sau đó tạo tệp context để bạn xem lại và chỉnh sửa.

Bước 3: Xác minh nội dung

Xem lại tệp được tạo và đảm bảo nó ghi đúng:

Các phiên bản công nghệ chính xác
Đúng các quy ước thực tế của bạn (không phải các best practice chung chung)
Các quy tắc giúp tránh những lỗi thường gặp
Các pattern đặc thù framework

Chỉnh sửa thủ công để thêm phần còn thiếu hoặc loại bỏ những chỗ không chính xác.

Bạn nhận được gì

Một tệp project-context.md sẽ:

Đảm bảo tất cả agent tuân theo cùng một bộ quy ước
Ngăn các quyết định không nhất quán giữa các story
Ghi lại các quyết định kiến trúc cho giai đoạn triển khai
Làm tài liệu tham chiếu cho các pattern và quy tắc của dự án

Mẹo

Bước tiếp theo

Giải thích về Project Context - Tìm hiểu sâu hơn cách nó hoạt động
Bản đồ workflow - Xem workflow nào sử dụng project context