Requirements and Design with Skills (Stage 2: Design)

1. Những thay đổi: Requirements & Design với Skills

Một khi Product Owner chấp thuận intent.md, Claude tiếp nhận và tạo ra tài liệu đặc tả yêu cầu và thiết kế (requirements and design spec - spec.md). Quá trình này được định hướng bởi các Skills của tổ chức về thương hiệu (brand), bảo mật (security), tuân thủ (compliance) và trải nghiệm người dùng (UX).

Product Owner rà soát bản đặc tả đó, nhưng không tự tay viết nó. Mục tiêu của quy trình này là tạo ra một bản spec mà đội ngũ kỹ thuật (engineering team) có thể lập kế hoạch (plan) dựa trên đó, kèm theo các điểm vướng mắc được gắn cờ (flagged areas of concern).

Claude nhận intent.md từ originator (người khởi xướng ý tưởng như Product Owner, chuyên viên nghiệp vụ), đối chiếu các Skills của tổ chức và tự động gắn cờ các flagged concerns (điểm vướng mắc giữa tính năng và quy chuẩn) để con người xử lý trước khi chuyển giao sang engineering.

2. Sơ đồ tương tác Design Session & Policy Skills

Luồng tương tác trong Design Session: đầu vào intent.md được nạp vào Claude cùng với các Policy Skills của tổ chức (Brand, Security, Compliance, UX). Claude đối chiếu các chính sách và sinh ra spec.md, đồng thời chủ động gắn cờ flagged concerns (điểm vướng mắc giữa tính năng và quy chuẩn):

Công việc giao diện (Front-end) là ví dụ trực quan nhất: Một khi intent.md được chấp thuận, Product Owner dựng mockup thiết kế trong Claude Design (beta) trực tiếp từ intent.md, lặp lại tinh chỉnh trên mockup (iterate on the mock), sau đó xuất (export) sang Claude Code để tiến hành xây dựng (build).

3. Bắt đầu: Điều kiện tiên quyết & Hạ tầng

Để khởi động giai đoạn Requirements and Design theo phương thức AI-Native, tổ chức chỉ cần chuẩn bị hai điều kiện thiết yếu:

4. Các bước thực thi

Quy trình thực thi gồm 6 bước tuần tự bám sát 100% nguyên tác Anthropic, với sự tiến hóa tự động hóa ở bước 2:

1. Product Owner mở một session với các Skills của tổ chức sẵn có và đính kèm tệp intent.md.
2. Prompt của Product Owner trỏ vào intent, nêu rõ các ràng buộc và yêu cầu gắn cờ các điểm vướng mắc (flagged concerns). Ban đầu hãy chạy thủ công bằng tay, sau đó chuẩn hóa thành slash command ở cấp tổ chức. Từ đó, biến việc chấp thuận intent.md trong kho lưu trữ intent (intent home) thành trigger kích hoạt, với một non-interactive job chạy khi merge, thực hiện lượt rà soát với các Skills của tổ chức được nạp sẵn, và commit spec.md dưới dạng một pull request (bài thực hành CI/CD trong Stage 5: Deploy sẽ bao quát phần kết nối này). Kể từ điểm đó, sự tham gia đầu tiên của Product Owner chính là bước rà soát (review).
3. Cùng Product Owner đó rà soát bản spec đối chiếu với ý tưởng: Bản spec có giải quyết bài toán đã nêu không, và các câu hỏi mở từ intent.md đã được giải đáp hay tiếp tục được chuyển tiếp (carried forward)?
4. Xử lý các flagged concerns (điểm vướng mắc giữa tính năng và quy chuẩn) trước tiên, vì đây là những điểm mà một chuyên viên phân tích (analyst) thông thường sẽ phải báo cáo leo thang (escalate). Product Owner giải quyết từng điểm vướng mắc với chính policy owner (chủ sở hữu chính sách: Security, UX, Compliance) của điểm đó trước khi đội ngũ kỹ thuật (engineering) nhìn thấy spec.
5. Commit spec.md bên cạnh intent.md. Cặp tệp này ghi lại đầy đủ những gì đã được yêu cầu và những gì đã được quyết định.
6. Product Owner quyết định xem bản spec và intent có được chuyển sang giai đoạn build hay không, tham vấn Technical Lead đối với bất kỳ nội dung nào mà tổ chức phân loại là có rủi ro cao hơn. Một thành viên con người luôn đưa ra quyết định này, và việc chấp thuận spec chính là điều kiện khởi động bài thực hành Plan Mode trong Stage 3: Build.

5. Mẫu Prompt chuẩn cho Design Session

Prompt mẫu từ nguyên tác Anthropic để khởi động Design Session kèm theo các Policy Skills:

Read the attached intent.md and produce a requirements and design spec for integrating it into our existing codebase. Apply the skills available to you so the plan conforms to our brand guidelines, security policies and UX standards. Document the spec fully as spec.md, ready to hand to the engineering team. Describe clearly any areas of concern, especially where you cannot satisfy contradicting policies.

6. Kiểm soát & Đo lường hiệu quả

Thay vì các xung đột chính sách bị phát hiện muộn trong đợt review sau nhiều tuần, chính sách thực tế (live policy) được đọc và áp dụng ngay trong khi bản spec đang được viết. Các Skills của tổ chức được áp dụng như những ràng buộc trên bản spec. Bản spec, prompt đã sinh ra nó, và phiên bản của các Skills đang có hiệu lực đều được lưu vết trong hệ thống quản lý phiên bản (version control). Product Owner ký duyệt bản spec, và điều phối các flagged concerns (điểm vướng mắc giữa tính năng và quy chuẩn) tới các policy owner (chủ sở hữu chính sách: Security, UX, Compliance) được chỉ định.