Di chuyển bối cảnh

# Lời nhắc bảo tồn và di chuyển bối cảnh

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

Tạo một tạo phẩm bối cảnh toàn diện giúp duy trì tất cả bối cảnh hội thoại, tiến trình, quyết định và cấu trúc dự án để tiếp tục liền mạch trên các phiên, nền tảng hoặc tác nhân AI. Tạo tác này đóng vai trò như một "USB ngữ cảnh" cho phép bất kỳ AI nào hiểu ngay lập tức và tiếp tục hoạt động mà không bị lặp lại hoặc mất ngữ cảnh.

## Mục tiêu cốt lõi

Nắm bắt và cấu trúc tất cả các yếu tố theo ngữ cảnh từ phiên hiện tại để kích hoạt:
1. **Tính liên tục của phiên** - 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
2. **Bàn giao đại lý** - Chuyển các nhiệm vụ chưa hoàn thành cho đại lý mới với tài liệu tiến độ đầy đủ
3. **Di chuyển dự án** - Tái tạo toàn bộ văn hóa dự án, quy trình làm việc và cơ cấu quản trị

## Danh mục nội dung cần bảo tồn

### Bối cảnh hội thoại
- Yêu cầu ban đầu và câu chuyện phát triển của người dùng
- Ý tưởng nảy sinh trong quá trình động não
- Các quyết định được đưa ra với chuỗi lý do hoàn chỉnh
- Thỏa thuận đạt được và trạng thái xác nhận của họ
- Đề xuất và khuyến nghị với bối cảnh hỗ trợ
- Các giả định được thiết lập và tình trạng hiện tại của chúng
- Những hiểu biết quan trọng và những khoảnh khắc đột phá
- Các điểm then chốt đóng vai trò là nền tảng cấu trúc

### Tài liệu tiến độ
- Trạng thái hiện tại của tất cả các luồng công việc
- Các nhiệm vụ và sản phẩm đã hoàn thành
- Các mục đang chờ xử lý và các bước tiếp theo
- Trình chặn gặp phải với các chiến lược giảm thiểu
- Tỷ lệ trúng giới hạn và giải pháp khắc phục
- Dòng thời gian của các cột mốc quan trọng

### Kiến trúc dự án (nếu có)
- Phương pháp và giai đoạn SDLC
- Hệ sinh thái tác nhân (tác nhân chính, tác nhân phụ, tác nhân anh em, tác nhân quan sát)
- Các quy tắc, chính sách và chiến lược quản trị
- Cấu trúc kho lưu trữ (quy trình làm việc .github, mẫu)
- Biểu mẫu nhắc nhở có thể tái sử dụng (phân tích sử thi, PRD, sơ đồ kiến trúc, thiết kế hệ thống)
- Các mẫu thông thường (định dạng cam kết, lời nhắc bộ nhớ, cấu trúc nhật ký)
- Phân cấp hướng dẫn (các biến thể cấp dự án, cấp độ chạy nước rút, cấp độ sử thi)
- Cấu hình CI/CD (kiểm tra, định dạng, trích xuất cam kết)
- Phối hợp nhiều tác nhân (chuỗi nhắc nhở, song song hóa, tác nhân định tuyến)
- Tiêu chuẩn và biến thể định dạng đầu ra

### Quy tắc & Giao thức
- Hướng dẫn được thiết lập với các định nghĩa phạm vi
- Hướng dẫn bổ sung được thêm vào trong phiên
- Các ràng buộc và ranh giới được thiết lập
- Tiêu chuẩn chất lượng và tiêu chí chấp nhận
- Cơ chế điều chỉnh để đảm bảo công việc đi đúng hướng

# bước

1. **Quét lịch sử hội thoại** - Xem lại toàn bộ chuỗi/phiên để tìm tất cả các 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 từng danh mục nội dung ở trên
3. **Trạng thái tiến trình tài liệu** - Ghi lại những gì đã hoàn thành, đang thực hiện và đang chờ xử lý
4. **Duy trì chuỗi quyết định** - Bao gồm lý do đằng sau tất cả các lựa chọn quan trọng
5. **Cấu trúc cho tính di động** - Sắp xếp theo định dạng có thể hiểu được trên toàn cầu
6. **Thêm hướng dẫn chuyển giao** - Bao gồm hướng dẫn rõ ràng cho AI/tác nhân/phiên tiếp theo

# Định dạng đầu ra

Tạo một tài liệu đánh dấu có cấu trúc với 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..."]
```

# Ví dụ

**Ví dụ 1: Tính liên tục của phiên (Brainstorming Handoff)**

Đầu vào: "Chúng tôi đã nghĩ ra một ứng dụng dành cho thiết bị di động trong 2 giờ. Tôi cần chuyển sang Claude. Tạo tạo phẩm bối 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
Brainstormed fitness tracking mobile app for busy professionals. Decided on minimalist design with AI coaching. Ready for technical architecture phase.

## CORE CONTEXT
### Original Requirements
- Target users: Working professionals 25-40, limited gym time
- Must sync with Apple Watch and Fitbit
- Budget: $50k for MVP
- Timeline: 3 months to launch

### Evolution & Decisions
- ✓ Name: "FitTrack Pro" (rejected: "QuickFit", "PowerHour")
- ✓ Core feature: 15-min AI-personalized workouts (not generic plans)
- ✓ Monetization: Freemium ($9.99/mo premium)
- ✓ Tech stack: React Native (for iOS+Android simultaneously)

### Current Progress
- Completed: Feature prioritization, user personas, monetization model
- In Progress: None yet
- Pending: Technical architecture, database schema, API design
- Blocked: None

## KNOWLEDGE BASE
### Key Insights & Agreements
- Users want "smart short" over "long complete" - brevity is premium feature
- AI coaching must feel conversational, not robotic commands
- Social features deferred to v2 to avoid scope creep

(... rest of structure follows)

## CONTINUATION QUERY
"Given this context artifact for FitTrack Pro app planning, please design the technical architecture including database schema, API endpoints, and third-party integration strategy for Apple Watch and Fitbit."
```

**Ví dụ 2: Chuyển giao tác nhân (Tự động hóa có giới hạn tốc độ)**

Đầu vào: "Tác nhân trình duyệt đạt giới hạn tốc độ trong khi thu thập giá của đối thủ cạnh tranh. 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
Automated scraping of 50 competitor websites for pricing comparison. Completed 32/50 before rate limiting. Need immediate continuation to meet Friday deadline.

## CORE CONTEXT
### Original Requirements
- Scrape pricing for "wireless earbuds under $100" from 50 e-commerce sites
- Extract: product name, price, rating, review count
- Output: Single CSV for analysis
- Deadline: Friday 5pm

### Evolution & Decisions
- ✓ Added retry logic after initial failures on JS-heavy sites
- ✓ Switched to headless Chrome (from requests library) for better compatibility
- ✓ Implemented 3-second delays between requests per domain
- ✓ User added instruction: "Skip sites requiring login"

### Current Progress
- Completed: 32/50 sites successfully scraped (2,847 products)
- In Progress: None (halted at rate limit)
- Pending: 18 sites remaining (list in "Continuation Query" below)
- Blocked: Rate limited on domains: amazon.com, walmart.com, target.com (need 2-hour cooldown)

## KNOWLEDGE BASE
### Established Rules & Protocols
- Respect robots.txt without exception
- Max 1 request per 3 seconds per domain
- Skip products with no reviews (noise in data)
- Handle pagination up to 5 pages max per site

### Challenges & Mitigations
- Challenge: Dynamic pricing (changes during scraping)
  Mitigation: Timestamp each entry
- Challenge: Anti-bot CAPTCHAs on 3 sites
  Mitigation: User approved manual data entry for these 3
- Challenge: Rate limiting
  Mitigation: Implement exponential backoff, rotate user agents

## CONTINUATION QUERY
"Continue pricing scraping automation. 18 sites remaining: [bestbuy.com, newegg.com, ebay.com...]. Use existing CSV 'pricing_data_partial.csv' (2,847 entries). Rate-limited domains need 2hr wait. Prioritize non-blocked sites first. Apply all established rules: 3-sec delays, skip no-reviews, 5-page pagination limit. Deliver final CSV by Friday 5pm."
```

**Ví dụ 3: Di chuyển dự án (Chuyển giao văn hóa toàn diện)**

(Bối cảnh đầu vào: Toàn bộ kho dự án có SDLC, tác nhân, quản trị)

Đầu ra: *(Ví dụ cô đọng hiển thị cấu trúc - đầu ra thực tế sẽ toàn diện)*
```
# CONTEXT ARTIFACT: "SmartInventory" Project Culture & Architecture
**Generated**: 2026-01-07 16:00
**Source Platform**: GitHub Copilot + Multi-Agent System
**Continuation Priority**: Medium (onboarding new AI agent framework)

## SESSION OVERVIEW
Enterprise inventory management system using AI-driven development culture. Need to replicate entire project structure, agent ecosystem, and governance for new autonomous AI agent setup.

## PROJECT STRUCTURE
### SDLC Framework
- Methodology: Agile with 2-week sprints
- Phases: Epic Planning → Development → Observer Review → CI/CD → Deployment
- All actions AI-driven: code generation, testing, documentation, commit narrative generation

### Agent Ecosystem
**Main Agents:**
- DevAgent: Code generation and implementation
- TestAgent: Automated testing and quality assurance
- DocAgent: Documentation generation and maintenance

**Observer Agent (Project Guardian):**
- Role: Alignment enforcer across all agents
- Functions: PR feedback, path validation, standards compliance
- Trigger: Every commit, PR, and epic completion

**CI/CD Agents:**
- FormatterAgent: Code style enforcement
- ReflectionAgent: Extracts commits → structured reflections, dev storylines, narrative outputs
- DeployAgent: Automated deployment pipelines

**Sub-Agents (by feature domain):**
- InventorySubAgent, UserAuthSubAgent, ReportingSubAgent

**Orchestration:**
- Multi-agent coordination via .ipynb notebooks
- Patterns: Prompt chaining, parallelization, router agents

### Repository Structure (.github)
```
.github/
├── quy trình làm việc/
│ ├── epic_breakdown.yml
│ ├── epic_generator.yml
│ ├── prd_template.yml
│ ├── architecture_plan.yml
│ ├── system_design.yml
│ ├── quy ước_commit.yml
│ ├── bộ nhớ_prompt.yml
│ └── log_prompt.yml
├── AGENTS.md (đăng ký đại lý)
├── copilot-instructions.md (quy tắc cấp dự án)
└── chạy nước rút/
    ├── sprint_01_instructions.md
    └── epic_variations/
```

### Governance & Standards
**Instructions Hierarchy:**
1. `copilot-instructions.md` - Project-wide immutable rules
2. Sprint instructions - Temporal variations per sprint
3. Epic instructions - Goal-specific invocations

**Conventional Patterns:**
- Commits: `type(scope): description` per Conventional Commits spec
- Memory prompt: Session state preservation template
- Log prompt: Structured activity tracking format

(... sections continue: Reusable Components, Quality Gates, Continuation Instructions for rebuilding with new AI agents...)
```

# Ghi chú

- **Tính phổ quát**: Cấu trúc phải có thể hiểu được bằng bất kỳ nền tảng AI nào (ChatGPT, Claude, Gemini, v.v.)
- **Tính đầy đủ và ngắn gọn**: Cân bằng bối cảnh toàn diện với khả năng đọc - sử dụng các phần lồng nhau để biết chi tiết sâu sắc
- **Kiểm soát phiên bản**: Bao gồm dấu thời gian và nền tảng nguồn để theo dõi sự phát triển ngữ cảnh qua nhiều lần chuyển giao
- **Định hướng hành động**: Luôn kết thúc bằng "Truy vấn tiếp tục" rõ ràng - lời nhắc chính xác để AI tiếp theo sử dụng
- **Điều chỉnh quy mô dự án**: Để di chuyển toàn bộ dự án (Trường hợp 3), hãy mở rộng đáng kể phần "Cấu trúc dự án" trong khi vẫn giữ các phần khác ngắn gọn
- **Tài liệu về lỗi**: Nắm bắt rõ ràng những gì không hoạt động và lý do - điều này ngăn cản AI tiếp theo lặp lại sai lầm
- **Bảo toàn quy tắc**: Khi các quy tắc/giao thức được thiết lập trong phiên, hãy bao gồm bối cảnh TẠI SAO chúng lại cần thiết
- **Xác thực giả định**: Đánh dấu các giả định là "đã xác thực", "đang chờ xác thực" hoặc "không hợp lệ" cho rõ ràng

- - DÀNH CHO Song Tử / GEMINI-CLI / KHÁNG TRỌNG

Dưới đây là các phiên bản cực kỳ ngắn gọn:

GEMINI.md
"# Đại lý AI Gemini trên nền tảng

quy trình làm việc/tác nhân/sample.toml
"# mẫu nhắc nhở phản trọng lực


BỘ NHỚ.md
"# Ký ức Song Tử

**Phiên**: 2026-01-07 | Nước rút 01 (còn 7 ngày) | Sử thi EPIC-001 (45%)  
**Đang hoạt động**: API CRUD khoảng không quảng cáo TASK-001-03 (Hoàn tất GET/POST, PUT/DELETE đang chờ xử lý)  
**Quyết định**: PostgreSQL + JSONB, RESTful /api/v1/, thử nghiệm pytest  
**Tiếp theo**: Hoàn thành điểm cuối PUT/DELETE, hoàn thiện lược đồ"