Artifacts

Artifacts là thuật ngữ chung cho các outputs mà Agent tạo ra trong quá trình làm việc.

Artifacts là gì?

Artifacts bao gồm tất cả các tài liệu và media được Agent tạo:

• Documents (markdown files)
• Diagrams
• Screenshots
• Browser recordings
• Implementation plans
• Walkthroughs

Các loại Artifacts

📋 Task List (task.md)

Checklist theo dõi tiến độ công việc:

# Feature: User Authentication

## Database
- [x] Create User model
- [x] Add migrations
- [ ] Seed test data

## Backend
- [x] Register endpoint
- [/] Login endpoint
- [ ] JWT authentication

## Frontend
- [ ] Login form
- [ ] Register form
- [ ] Auth state

Ký hiệu:

• [ ] - Chưa hoàn thành
• [/] - Đang thực hiện
• [x] - Hoàn thành

📝 Implementation Plan (implementation_plan.md)

Kế hoạch chi tiết trước khi code:

# User Authentication Implementation

## Tổng quan
Triển khai hệ thống authentication với JWT.

## Proposed Changes

### Database
- Tạo User model với fields: id, email, password_hash
- Migration cho bảng users

### Backend
- POST /api/auth/register
- POST /api/auth/login
- Middleware xác thực JWT

## Verification Plan
- Unit tests cho auth functions
- Integration tests cho API endpoints

📖 Walkthrough (walkthrough.md)

Tổng kết sau khi hoàn thành:

# Authentication Implementation Walkthrough

## Những gì đã làm
- Tạo User model với Prisma
- Implement register và login APIs
- Thêm JWT middleware

## Testing
- Tất cả 15 unit tests passed
- Integration tests cho happy path
- Manual testing trên localhost

## Screenshots
![Login page](./screenshots/login.png)

## Recordings
![Demo flow](./recordings/auth_demo.webp)

📸 Screenshots

Chụp màn hình từ:

• Browser (via Browser Subagent)
• UI components
• Error states

🎬 Browser Recordings

Video recordings (WebP format) của:

• Browser automation sessions
• UI testing flows
• Demo user journeys

Lưu trữ Artifacts

Artifacts được lưu trong:

<appDataDir>/brain/<conversation-id>/
├── task.md
├── implementation_plan.md
├── walkthrough.md
├── screenshots/
│   └── login_page.png
└── recordings/
    └── auth_flow.webp

Sử dụng Artifacts

Trong Conversation

Agent tự động tạo và cập nhật artifacts. Bạn có thể:

• View artifacts trong side panel
• Edit nếu cần điều chỉnh
• Reference trong conversation

Review Flow

graph TD
    A[Agent tạo implementation_plan.md] --> B{User review}
    B -->|Approve| C[Agent thực thi]
    B -->|Request changes| D[Agent update plan]
    D --> B
    C --> E[Agent update task.md]
    E --> F[Agent tạo walkthrough.md]

Best Practices

✅ Review Implementation Plans

Luôn đọc kỹ implementation_plan.md trước khi approve:

• Có đúng approach không?
• Có thiếu edge cases không?
• Verification plan có đủ không?

✅ Check Task Progress

Theo dõi task.md để:

• Biết tiến độ hiện tại
• Phát hiện tasks bị stuck
• Plan cho phần còn lại

✅ Save Important Artifacts

Artifacts theo conversation có thể bị xóa. Nên:

• Copy artifacts quan trọng vào project
• Commit vào Git
• Export screenshots/recordings

✅ Use Walkthroughs for Documentation

walkthrough.md là nguồn tốt để:

• Document changes cho team
• Onboard new team members
• Reference cho future work

Embedding Artifacts

Images

![Description](/path/to/image.png)

Recordings

![Demo video](/path/to/recording.webp)

File Links

[View file](file:///absolute/path/to/file.ts)

Knowledge Integration

Artifacts có thể trở thành Knowledge:

• Insights từ conversations
• Patterns phát hiện được
• Best practices cho project

Xem thêm: Knowledge (Coming soon)