Giai đoạn Thiết kế (Design)

Thiết kế kiến trúc hệ thống và API trước khi code.

Mục đích

• Định nghĩa kiến trúc tổng thể
• Thiết kế data models
• Xác định API contracts
• Ghi lại quyết định thiết kế

Cách thực hiện

1. Review yêu cầu trước

/review-requirements

2. Tạo design document

Điền docs/agent/design/feature-{name}.md

3. Vẽ sơ đồ Mermaid

graph TD
    A[Client] --> B[API Gateway]
    B --> C[Service A]
    B --> D[Service B]
    C --> E[(Database)]

Template nội dung

---
phase: design
title: Feature Name Design
---

# Thiết kế: [Tên Tính năng]

## Tổng quan kiến trúc
[Mô tả high-level]

## Sơ đồ

\`\`\`mermaid
graph TD
    A[Component A] --> B[Component B]
\`\`\`

## Data Models

### Entity Name
| Field | Type | Description |
|-------|------|-------------|
| id | UUID | Primary key |
| name | String | Tên |

## API Design

### POST /api/resource
**Request**:
\`\`\`json
{ "name": "string" }
\`\`\`

**Response**:
\`\`\`json
{ "id": "uuid", "name": "string" }
\`\`\`

## Quyết định thiết kế

| Quyết định | Lý do | Alternatives |
|------------|-------|--------------|
| Dùng REST | Đơn giản | GraphQL |

## Xem xét bảo mật
- [ ] Authentication
- [ ] Authorization
- [ ] Input validation

Review

/review-design

Tiếp theo

→ Giai đoạn Lập kế hoạch