Claude 101

Playbook outsource: 6 tình huống thật

6 tình huống thật khi làm outsource — onboard codebase lạ, fix bug, refactor, tăng test coverage, migration, sinh tài liệu.

  1. Onboard vào codebase legacy của khách (ngày 1): claude → /init → "Vẽ sơ đồ kiến trúc tổng thể (Mermaid): module chính, luồng request, external service. Sau đó liệt kê 5 khu vực rủi ro nhất khi sửa." → lưu output làm tài liệu onboard cho người sau.
  2. Fix bug từ ticket: (có MCP Jira) "Đọc BUG-1234, tái hiện bằng test, vào plan mode đề xuất fix tối thiểu, implement, chạy toàn bộ test liên quan."
  3. Refactor an toàn: "Plan mode: tách logic [X] khỏi controller thành service riêng, giữ nguyên hành vi. Điều kiện hoàn thành: test hiện có pass 100%."
  4. Tăng test coverage trước khi bàn giao: "Liệt kê file trong src/services chưa có test, ưu tiên theo độ phức tạp, viết test cho 3 file đầu theo style hiện có."
  5. Migration/upgrade: (vd Vue 2→3, PHP 7.4→8.x) "Kiểm kê các breaking change ảnh hưởng repo này, xuất bảng file-thay đổi cần thiết-độ rủi ro, đề xuất thứ tự migrate." → migrate theo lô nhỏ, mỗi lô một nhánh + test.
  6. Sinh tài liệu bàn giao: "Từ source trong src/api, sinh tài liệu endpoint: method, path, params, response mẫu, auth. Xuất Markdown vào docs/api.md."