Di Chuyển Ngữ Cảnh (Context Migration)

# Câu Lệnh Bảo Toàn & Di Chuyển Ngữ Cảnh (Context Preservation & Migration Prompt)

[ for AGENT.MD pass THE `## SECTION` if NOT APPLICABLE ]

Hãy tạo một hồ sơ ngữ cảnh (context artifact) toàn diện giúp bảo toàn toàn bộ ngữ cảnh hội thoại, tiến độ công việc, các quyết định và cấu trúc dự án để tiếp tục công việc một cách liền mạch giữa các phiên làm việc AI, các nền tảng hoặc các tác nhân (agents) khác nhau. Hồ sơ này đóng vai trò như một chiếc "USB ngữ cảnh" giúp bất kỳ AI nào cũng có thể ngay lập tức nắm bắt tình hình và tiếp tục công việc mà không cần lặp lại hay bị đứt gãy ngữ cảnh.

## Các Mục Tiêu Cốt Lõi

Thu thập và cấu trúc hóa toàn bộ các yếu tố ngữ cảnh từ phiên làm việc hiện tại nhằm cho phép:
1. **Duy Trì Tính Liên Tục Của Phiên (Session Continuity)** - Tiếp tục cuộc trò chuyện trên các nền tảng AI khác nhau mà không cần giải thích lại từ đầu
2. **Bàn Giao Giữa Các Tác Nhân (Agent Handoff)** - Chuyển giao các tác vụ đang dang dở cho các tác nhân mới kèm theo tài liệu ghi nhận tiến độ đầy đủ
3. **Di Chuyển Dự Án (Project Migration)** - Sao chép toàn bộ văn hóa làm việc của dự án, quy trình (workflows) và cấu trúc quản trị

## Các Danh Mục Nội Dung Cần Bảo Toàn

### Ngữ Cảnh Hội Thoại (Conversational Context)
- Các yêu cầu ban đầu và câu chuyện người dùng (user stories) được phát triển qua trao đổi
- Các ý tưởng được khởi tạo trong những phiên động não (brainstorming)
- Các quyết định đã đưa ra kèm theo chuỗi lý giải nguyên nhân đầy đủ
- Các thỏa thuận đã đạt được và trạng thái xác nhận của chúng
- Các đề xuất và khuyến nghị kèm theo ngữ cảnh bổ trợ
- Các giả định đã thiết lập và trạng thái hiệu lực hiện tại của chúng
- Các góc nhìn sâu sắc (key insights) và những khoảnh khắc đột phá
- Các điểm mấu chốt đóng vai trò là nền tảng cấu trúc

### Tài Liệu Hóa Tiến Độ (Progress Documentation)
- Trạng thái hiện tại của tất cả các luồng công việc (work streams)
- Các tác vụ và sản phẩm bàn giao đã hoàn thành
- Các hạng mục đang chờ xử lý và các bước tiếp theo
- Các điểm nghẽn (blockers) gặp phải kèm chiến lược giảm thiểu/tháo gỡ
- Các giới hạn tốc độ (rate limits) đã chạm phải và giải pháp khắc phục tạm thời
- Dòng thời gian của các cột mốc quan trọng

### Kiến Trúc Dự Án (khi áp dụng)
- Phương pháp luận SDLC và các giai đoạn phát triển
- Hệ sinh thái tác nhân (tác nhân chính, tác nhân phụ, tác nhân ngang hàng, tác nhân quan sát giám sát)
- Các quy tắc, chính sách quản trị và chiến lược
- Cấu trúc kho lưu trữ mã nguồn (.github workflows, các mẫu templates)
- Các biểu mẫu câu lệnh tái sử dụng (phân rã epic, PRD, kế hoạch kiến trúc, thiết kế hệ thống)
- Các mẫu quy ước chuẩn (định dạng commit, câu lệnh bộ nhớ memory prompts, cấu trúc ghi log)
- Phân cấp hướng dẫn (các biến thể ở cấp dự án, cấp sprint, cấp epic)
- Cấu hình CI/CD (kiểm thử, định dạng mã, trích xuất commit)
- Điều phối đa tác nhân (nối chuỗi câu lệnh prompt chaining, chạy song song, tác nhân định tuyến router agents)
- Tiêu chuẩn định dạng đầu ra và các biến thể

### Quy Tắc & Giao Thức (Rules & Protocols)
- Các nguyên tắc hướng dẫn đã thiết lập kèm định nghĩa phạm vi áp dụng
- Các chỉ dẫn bổ sung được thêm vào trong suốt phiên làm việc
- Các ràng buộc và ranh giới đã đặt ra
- Tiêu chuẩn chất lượng và tiêu chí nghiệm thu (acceptance criteria)
- Cơ chế căn chỉnh nhằm giữ cho công việc luôn đi đúng quỹ đạo

# Các Bước Thực Hiện

1. **Quét Lịch Sử Hội Thoại** - Rà soát toàn bộ luồng trò chuyện/phiên làm việc để nắm bắt mọi tương tác và ngữ cảnh
2. **Trích Xuất Các Yếu Tố Cốt Lõi** - Xác định và phân loại thông tin theo các danh mục nội dung nêu trên
3. **Lập Tài Liệu Trạng Thái Tiến Độ** - Ghi nhận rõ những gì đã hoàn thành, đang thực hiện và đang chờ xử lý
4. **Bảo Toàn Chuỗi Quyết Định** - Đưa vào lý do đằng sau tất cả các lựa chọn quan trọng
5. **Cấu Trúc Hóa Để Dễ Di Chuyển** - Sắp xếp theo định dạng chuẩn mà mọi hệ thống đều có thể đọc hiểu
6. **Thêm Hướng Dẫn Bàn Giao** - Bao gồm hướng dẫn tường minh dành cho AI/tác nhân/phiên làm việc tiếp theo

# Định Dạng Đầu Ra

Tạo một tài liệu markdown có cấu trúc gồm các phần sau:

```
# CONTEXT ARTIFACT: [Session/Project Title]
**Generated**: [Date/Time]
**Source Platform**: [AI Platform Name]
**Continuation Priority**: [Critical/High/Medium/Low]

## SESSION OVERVIEW
[2-3 sentence summary of primary goals and current state]

## CORE CONTEXT
### Original Requirements
[Initial user requests and goals]

### Evolution & Decisions
[Key decisions made, with rationale - bulleted list]

### Current Progress
- Completed: [List]
- In Progress: [List with % complete]
- Pending: [List]
- Blocked: [List with blockers and mitigations]

## KNOWLEDGE BASE
### Key Insights & Agreements
[Critical discoveries and consensus points]

### Established Rules & Protocols
[Guidelines, constraints, standards set during session]

### Assumptions & Validations
[What's been assumed and verification status]

## ARTIFACTS & DELIVERABLES
[List of files, documents, code created with descriptions]

## PROJECT STRUCTURE (if applicable)
### Architecture Overview
[SDLC, workflows, repository structure]

### Agent Ecosystem
[Description of agents, their roles, interactions]

### Reusable Components
[Prompt templates, workflows, automation scripts]

### Governance & Standards
[Instructions hierarchy, conventional patterns, quality gates]

## HANDOFF INSTRUCTIONS
### For Next Session/Agent
[Explicit steps to continue work]

### Context to Emphasize
[What the next AI must understand immediately]

### Potential Challenges
[Known issues and recommended approaches]

## CONTINUATION QUERY
[Suggested prompt for next AI: "Given this context artifact, please continue by..."]
```

# Các Ví Dụ

**Ví dụ 1: Duy Trì Tính Liên Tục Của Phiên (Bàn Giao Phiên Động Não)**

Đầu vào: "Chúng ta đã động não về một ứng dụng di động suốt 2 tiếng rồi. Giờ tôi cần chuyển sang dùng Claude. Hãy tạo hồ sơ ngữ cảnh."

Đầu ra:
```
# CONTEXT ARTIFACT: FitTrack Mobile App Planning
**Generated**: 2026-01-07 14:30
**Source Platform**: Google Gemini
**Continuation Priority**: High

## SESSION OVERVIEW
Đã động não ý tưởng ứng dụng di động theo dõi thể chất dành cho giới chuyên gia bận rộn. Quyết định chọn thiết kế tối giản tích hợp huấn luyện viên AI. Sẵn sàng bước sang giai đoạn thiết kế kiến trúc kỹ thuật.

## CORE CONTEXT
### Original Requirements
- Người dùng mục tiêu: Người đi làm chuyên nghiệp từ 25-40 tuổi, có ít thời gian đến phòng tập
- Bắt buộc đồng bộ với Apple Watch và Fitbit
- Ngân sách: $50k cho bản MVP
- Tiến độ: 3 tháng để ra mắt

### Evolution & Decisions
- ✓ Tên gọi: "FitTrack Pro" (đã loại: "QuickFit", "PowerHour")
- ✓ Tính năng cốt lõi: Các bài tập 15 phút được cá nhân hóa bằng AI (không dùng giáo án đại trà)
- ✓ Mô hình kiếm tiền: Freemium (gói cao cấp $9.99/tháng)
- ✓ Ngăn xếp công nghệ: React Native (phát triển đồng thời cho cả iOS+Android)

### Current Progress
- Completed: Phân loại ưu tiên tính năng, chân dung người dùng (user personas), mô hình doanh thu
- In Progress: Chưa bắt đầu
- Pending: Kiến trúc kỹ thuật, lược đồ cơ sở dữ liệu (database schema), thiết kế API
- Blocked: Không có

## KNOWLEDGE BASE
### Key Insights & Agreements
- Người dùng muốn "ngắn gọn thông minh" hơn là "dài dòng đầy đủ" - sự cô đọng chính là tính năng cao cấp
- Huấn luyện viên AI phải mang lại cảm giác trò chuyện tự nhiên, không ra lệnh cứng nhắc như máy móc
- Các tính năng mạng xã hội được lùi sang bản v2 để tránh phình to phạm vi dự án (scope creep)

(... phần còn lại của cấu trúc tiếp tục bên dưới)

## CONTINUATION QUERY
"Dựa trên hồ sơ ngữ cảnh lập kế hoạch ứng dụng FitTrack Pro này, vui lòng thiết kế kiến trúc kỹ thuật bao gồm lược đồ cơ sở dữ liệu, các API endpoints và chiến lược tích hợp bên thứ ba cho Apple Watch và Fitbit."
```

**Ví dụ 2: Bàn Giao Giữa Các Tác Nhân (Tác Vụ Tự Động Hóa Chạm Giới Hạn Tốc Độ)**

Đầu vào: "Tác nhân trình duyệt (Browser agent) đã chạm giới hạn tốc độ khi đang thu thập dữ liệu giá của đối thủ. Hãy tạo tài liệu bàn giao."

Đầu ra:
```
# CONTEXT ARTIFACT: Competitor Pricing Automation (Incomplete)
**Generated**: 2026-01-07 09:15
**Source Platform**: Browser Agent v2.1
**Continuation Priority**: Critical

## SESSION OVERVIEW
Thu thập dữ liệu tự động trên 50 trang web của đối thủ cạnh tranh để so sánh giá. Đã hoàn thành 32/50 trang trước khi bị chặn giới hạn tốc độ (rate limiting). Cần tiếp tục ngay lập tức để kịp hạn chót vào Thứ Sáu.

## CORE CONTEXT
### Original Requirements
- Thu thập giá mặt hàng "tai nghe không dây dưới $100" từ 50 trang thương mại điện tử
- Trích xuất: tên sản phẩm, giá, điểm đánh giá, số lượng nhận xét
- Đầu ra: Một tệp CSV duy nhất để phân tích
- Hạn chót: 5 giờ chiều Thứ Sáu

### Evolution & Decisions
- ✓ Đã thêm logic thử lại (retry) sau những lần thất bại ban đầu trên các trang web dùng nhiều JS
- ✓ Đã chuyển sang dùng headless Chrome (thay vì thư viện requests) để tương thích tốt hơn
- ✓ Đã áp dụng độ trễ 3 giây giữa các yêu cầu trên mỗi tên miền
- ✓ Người dùng đã thêm chỉ dẫn: "Bỏ qua các trang web bắt buộc đăng nhập"

### Current Progress
- Completed: Đã thu thập thành công 32/50 trang web (2,847 sản phẩm)
- In Progress: Không có (đã tạm dừng tại thời điểm chạm giới hạn tốc độ)
- Pending: Còn lại 18 trang web (danh sách nằm trong mục "Continuation Query" bên dưới)
- Blocked: Bị giới hạn tốc độ trên các tên miền: amazon.com, walmart.com, target.com (cần chờ hạ nhiệt 2 giờ)

## KNOWLEDGE BASE
### Established Rules & Protocols
- Tuân thủ nghiêm ngặt tệp robots.txt không có ngoại lệ
- Tối đa 1 yêu cầu mỗi 3 giây trên từng tên miền
- Bỏ qua các sản phẩm không có đánh giá nào (gây nhiễu dữ liệu)
- Xử lý phân trang tối đa đến 5 trang cho mỗi website

### Challenges & Mitigations
- Thách thức: Giá biến động linh hoạt (thay đổi ngay trong quá trình thu thập)
  Giải pháp: Gắn nhãn thời gian (timestamp) cho từng bản ghi
- Thách thức: Mã xác thực chống bot CAPTCHA trên 3 trang web
  Giải pháp: Người dùng đã đồng ý tự nhập dữ liệu thủ công cho 3 trang này
- Thách thức: Bị giới hạn tốc độ truy cập (Rate limiting)
  Giải pháp: Triển khai thời gian chờ tăng dần theo cấp số nhân (exponential backoff), xoay vòng chuỗi định danh trình duyệt (user agents)

## CONTINUATION QUERY
"Tiếp tục quy trình tự động hóa thu thập dữ liệu giá. Còn lại 18 trang web: [bestbuy.com, newegg.com, ebay.com...]. Sử dụng tệp CSV hiện có 'pricing_data_partial.csv' (2,847 bản ghi). Các tên miền bị giới hạn tốc độ cần chờ đủ 2 giờ. Ưu tiên chạy các trang không bị chặn trước. Áp dụng toàn bộ các quy tắc đã thiết lập: độ trễ 3 giây, bỏ qua sản phẩm không có đánh giá, giới hạn phân trang 5 trang. Bàn giao tệp CSV hoàn chỉnh trước 5 giờ chiều Thứ Sáu."
```

**Ví dụ 3: Di Chuyển Dự Án (Chuyển Giao Toàn Bộ Văn Hóa Làm Việc)**

(Ngữ cảnh đầu vào: Toàn bộ kho lưu trữ dự án bao gồm SDLC, hệ thống tác nhân và cơ chế quản trị)

Đầu ra: *(Ví dụ rút gọn thể hiện cấu trúc - kết quả thực tế sẽ chi tiết và toàn diện hơn)*
```
# CONTEXT ARTIFACT: "SmartInventory" Project Culture & Architecture
**Generated**: 2026-01-07 16:00
**Source Platform**: GitHub Copilot + Multi-Agent System
**Continuation Priority**: Medium (tích hợp sang khung tác nhân AI mới)

## SESSION OVERVIEW
Hệ thống quản lý kho hàng cấp doanh nghiệp sử dụng văn hóa phát triển phần mềm dẫn dắt bởi AI. Cần tái tạo toàn bộ cấu trúc dự án, hệ sinh thái tác nhân và cơ chế quản trị cho thiết lập tác nhân AI tự hành mới.

## PROJECT STRUCTURE
### SDLC Framework
- Phương pháp luận: Agile với các sprint kéo dài 2 tuần
- Các giai đoạn: Lập kế hoạch Epic → Phát triển → Tác nhân Quan sát Đánh giá → CI/CD → Triển khai
- Mọi hoạt động đều do AI thực hiện: sinh mã nguồn, kiểm thử, viết tài liệu, tạo mạch chuyện giải thích cho các bản commit

### Agent Ecosystem
**Các Tác Nhân Chính (Main Agents):**
- DevAgent: Sinh mã nguồn và triển khai tính năng
- TestAgent: Kiểm thử tự động và đảm bảo chất lượng
- DocAgent: Khởi tạo và duy trì tài liệu

**Tác Nhân Quan Sát - Observer Agent (Người Bảo Vệ Dự Án):**
- Vai trò: Thực thi việc căn chỉnh chuẩn mực xuyên suốt tất cả các tác nhân
- Chức năng: Phản hồi đánh giá PR, xác thực đường dẫn, kiểm tra tuân thủ tiêu chuẩn
- Điều kiện kích hoạt: Mỗi lần commit, tạo PR và khi hoàn thành một epic

**Các Tác Nhân CI/CD:**
- FormatterAgent: Thực thi quy chuẩn định dạng mã nguồn
- ReflectionAgent: Trích xuất các bản commit → tổng hợp thành bài chiêm nghiệm có cấu trúc, mạch chuyện phát triển và báo cáo tường thuật
- DeployAgent: Các đường ống triển khai tự động

**Các Tác Nhân Phụ - Sub-Agents (chia theo miền tính năng):**
- InventorySubAgent, UserAuthSubAgent, ReportingSubAgent

**Điều Phối (Orchestration):**
- Phối hợp đa tác nhân thông qua các tệp sổ tay .ipynb
- Các mẫu điều phối: Nối chuỗi câu lệnh (Prompt chaining), thực thi song song, tác nhân định tuyến (router agents)

### Repository Structure (.github)
```
.github/
├── workflows/
│   ├── epic_breakdown.yml
│   ├── epic_generator.yml
│   ├── prd_template.yml
│   ├── architectural_plan.yml
│   ├── system_design.yml
│   ├── conventional_commit.yml
│   ├── memory_prompt.yml
│   └── log_prompt.yml
├── AGENTS.md (danh bạ đăng ký tác nhân)
├── copilot-instructions.md (quy tắc cấp độ toàn dự án)
└── sprints/
    ├── sprint_01_instructions.md
    └── epic_variations/
```

### Governance & Standards
**Phân Cấp Hướng Dẫn (Instructions Hierarchy):**
1. `copilot-instructions.md` - Các quy tắc bất biến áp dụng trên toàn dự án
2. Hướng dẫn theo Sprint - Các biến thể theo từng giai đoạn thời gian của mỗi sprint
3. Hướng dẫn theo Epic - Các chỉ dẫn gọi thực thi gắn với mục tiêu cụ thể

**Các Mẫu Quy Ước Chuẩn (Conventional Patterns):**
- Commits: `type(scope): description` tuân theo đặc tả Conventional Commits
- Câu lệnh bộ nhớ (Memory prompt): Mẫu bảo toàn trạng thái phiên làm việc
- Câu lệnh ghi nhật ký (Log prompt): Định dạng theo dõi hoạt động có cấu trúc

(... các phần tiếp theo: Thành phần Tái sử dụng, Cổng Kiểm soát Chất lượng, Hướng dẫn Tiếp tục để dựng lại hệ thống với các tác nhân AI mới...)
```

# Ghi Chú Quan Trọng

- **Tính Phổ Quát (Universality)**: Cấu trúc phải dễ dàng được đọc hiểu bởi bất kỳ nền tảng AI nào (ChatGPT, Claude, Gemini, v.v.)
- **Sự Đầy Đủ so với Tính Ngắn Gọn**: Cân bằng giữa việc lưu giữ ngữ cảnh toàn diện và khả năng đọc lướt dễ dàng - sử dụng các phần lồng nhau cho những chi tiết sâu
- **Kiểm Soát Phiên Bản**: Đưa vào nhãn thời gian và tên nền tảng nguồn để theo dõi sự tiến hóa của ngữ cảnh qua nhiều lần bàn giao liên tiếp
- **Định Hướng Hành Động**: Luôn kết thúc bằng mục "Continuation Query" rõ ràng - câu lệnh chính xác để sao chép cho AI tiếp theo sử dụng ngay
- **Thích Ứng Theo Quy Mô Dự Án**: Đối với việc di chuyển toàn bộ dự án (Trường hợp 3), hãy mở rộng đáng kể phần "Project Structure" trong khi giữ các phần khác súc tích
- **Ghi Nhận Các Thất Bại**: Ghi lại rõ ràng những cách làm nào đã không hiệu quả và lý do tại sao - điều này ngăn AI tiếp theo lặp lại vết xe đổ
- **Bảo Toàn Quy Tắc**: Khi các quy tắc/giao thức được thiết lập trong phiên làm việc, hãy kèm theo ngữ cảnh giải thích TẠI SAO chúng lại cần thiết
- **Xác Thực Giả Định**: Đánh dấu rõ các giả định là "đã xác thực (validated)", "đang chờ xác thực (pending validation)", hoặc "đã bác bỏ (invalidated)" để đảm bảo sự minh bạch

- - DÀNH CHO GEMINI / GEMINI-CLI / ANTIGRAVITY

Dưới đây là các phiên bản siêu cô đọng:

GEMINI.md
"# Tác nhân AI Gemini đa nền tảng

workflow/agent/sample.toml
"# mẫu câu lệnh antigravity


MEMORY.md
"# Bộ nhớ Gemini

**Session**: 2026-01-07 | Sprint 01 (còn 7 ngày) | Epic EPIC-001 (45%)  
**Active**: TASK-001-03 API CRUD kho hàng (GET/POST đã xong, PUT/DELETE đang chờ)  
**Decisions**: PostgreSQL + JSONB, RESTful /api/v1/, kiểm thử bằng pytest  
**Next**: Hoàn thiện các endpoint PUT/DELETE, chốt lược đồ cơ sở dữ liệu"