Có sáu bước làm xương sống, cộng thêm bốn nhánh chỉ chạy khi bạn cần đến. Các bước được đánh số vì đây thật sự là một thứ tự, chứ không phải để cho đẹp: bước sau đọc lại chính những file mà bước trước đã sinh ra.
Sản phẩm - làm gì trước, làm gì sau
Nhóm này chỉ chạy một lần ở đầu dự án, lúc bạn còn phải quyết định làm gì trước làm gì sau. Nếu bạn đã được giao thẳng một feature cụ thể rồi thì cứ bỏ qua cả ba.
/prd/roadmap/discoverLàm rõ - từ ý tưởng thô thành thứ có cấu trúc
Ở bước này, AI sẽ phỏng vấn ngược lại bạn để đào cho rõ ý tưởng. Đây chính là chỗ nên chốt phạm vi, trước khi bạn bỏ công viết tài liệu.
/brainstorm/meetĐặc tả - chốt feature làm gì, luật ra sao
/srs là file trung tâm của cả bộ, bởi gần như mọi bước phía sau đều đọc lại từ nó. Còn /urd, /brd và /prd-epic thì chỉ nên viết khi công ty bạn thật sự yêu cầu.
/srs/urd/brd/prd-epicDiễn đạt - sơ đồ và use case
Với mỗi mục đích, bạn chỉ nên chọn đúng một loại sơ đồ. Đừng vẽ cả bốn kiểu cho cùng một nội dung, vì sau này sửa một chỗ là phải sửa lại cả bốn.
/usecase/sequence/activity/state/erd/bpmnMàn hình - từ nghiệp vụ ra giao diện
/user-flow bắt buộc phải chạy đầu tiên, vì nó là nguồn chia flow dùng chung mà mọi skill wireframe phía sau đều đọc lại. Những skill còn lại xếp theo độ chi tiết tăng dần từ trái sang phải, và bạn dừng ở đâu là tuỳ vào việc cần đưa cho ai xem.
/user-flow/wireframe-ascii/wireframe-html/figma/prototype-htmlBàn giao - backlog cho dev, gói cho stakeholder
Đây là điểm kết của cả chuỗi. Nhưng bạn nhớ giúp rằng một story chưa có AC được xác nhận thì vẫn chưa đủ để dev nhận việc.
/userstory/ac/jira/export/previewNhánh tích hợp API - khi phải nối hệ thống ngoài
Bảy skill trong nhánh này chạy theo một thứ tự cố định, không đảo được. Nếu API là của chính dự án bạn chứ không phải của đối tác, bạn có thể bỏ qua hai bước đầu.
/api-assess/api-doc/api-design/api-map/api-checklist/api-test/api-readinessNhánh kiểm thử
Bạn bắt buộc phải có checklist trước rồi mới sinh được test case. Thứ tự này cố ý như vậy, để bạn kịp review kịch bản trước khi tốn công viết chi tiết từng ca.
/test-checklist/test-cases/playwright-genChạy xen kẽ - kiểm và bảo trì
Nhóm này không có chỗ cố định nào trong chuỗi. Bạn gọi chúng bất cứ lúc nào cần soi lại hoặc sửa tài liệu đã viết xong.
/gap/ask/cr/doc-drift/dashboard/kgDự án cũ không có tài liệu - dựng ngược
Trường hợp này bạn vào chuỗi từ giữa: dựng lại bộ SRS từ những nguồn đang có trong tay, rồi chuyển sang /srs để hình thức hoá lại cho chuẩn.
/reverse-doc/code-to-srs/reverse-preview