Using spec-driven development with Claude Code

TL;DR

Tác giả là solutions architect, xài AI (Claude Code) để build trên AWS thay vì tự gõ code. Bài này chia sẻ cách dùng spec-driven development — nghĩa là viết spec trước rồi mới code — để tăng tốc mà không thêm tech debt.

Bài này dành cho ai?

1. Người muốn build sản phẩm bằng AI nhưng sợ tech debt

Vấn đề: AI viết code nhanh nhưng dễ sai, khó maintain, sửa đi sửa lại nhiều lần.

Khi nào cần: Khi bạn muốn tận dụng tốc độ của AI mà không muốn cuối dự án phải refactor lại từ đầu.

Được gì: Cách viết spec trước để AI theo, giảm thời gian sửa sai.

2. Người đang xài Claude Code hoặc AI coding tools

Vấn đề: Chưa biết cách tối ưu workflow với AI, hay bị context window limit, chọn model không đúng.

Khi nào cần: Khi bạn muốn dùng AI hiệu quả hơn, build nhanh hơn mà không tốn nhiều tokens.

Được gì: Tips cụ thể về context window, chọn Sonnet thay vì Opus, cách dùng clarifying questions.

Các điểm chính

1. Viết spec trước khi code, không phải sau Spec buộc mình nghĩ kỹ requirements trước. Khi AI generate code, mình có roadmap để kiểm tra. Spec-first chỉ là bước đầu, còn spec-anchored buộc mình quay lại cập nhật spec thường xuyên. → Làm gì: Trước khi prompt AI, viết 1 file spec.md có mục tiêu, architecture, và các bước implementation.

2. Chia project thành các phase nhỏ, dễ test từng cái Tác giả chia project thành 2 sub-projects, mỗi cái lại chia thành các stack nhỏ. Stack 1 tạo interceptor (Lambda), Stack 2 tạo MCP server, Stack 3 tạo Gateway. Mỗi phase đều deploy và test riêng được. → Làm gì: Chia task thành các module nhỏ, mỗi module deploy được và verify được trước khi làm tiếp.

3. 200k tokens context window đủ cho hầu hết task Tác giả dùng Claude Code Pro, thấy 200k tokens không thiếu. Lưu ý là muốn 1M tokens phải dùng Bedrock với custom header, nhưng Claude Code chưa support. → Làm gì: Đừng lo context window, tập trung vào việc chia nhỏ task thay vì nhồi hết vào 1 prompt.

4. Dùng Sonnet thay vì Opus để tiết kiệm usage limit Opus 4.6 hết usage limit nhanh — tác giả gặp limit trong 45-60 phút. Sonnet 4.6 dùng vài tiếng vẫn OK. → Làm gì: Dùng Sonnet cho task thường, để Opus cho task cần reasoning phức tạp.

5. Hỏi AI bằng selectable inputs thay vì开放式 câu hỏi Thay vì để AI hỏi linh tinh, mình cho sẵn các lựa chọn. AI sẽ hiển thị menu, mình chọn rồi nó tiếp tục. Nhanh và dễ hơn nhiều. → Làm gì: Trong prompt, thêm “Use selectable inputs for clarifying questions” để AI đưa options thay vì hỏi tự do.

6. Thêm security sớm, đừng để cuối Tác giả thêm OAuth 2 cho Gateway vào cuối, phải redeploy lại cả stack vì AuthorizerType không thể change in place. → Làm gì: Xác định security requirements từ đầu, include trong spec luôn.

7. Tạo custom skills để tăng tốc project sau Sau project này, tác giả tạo SKILL.md cho riêng mình. Lần sau xài lại sẽ nhanh hơn nhiều. → Làm gì: Sau mỗi project, tạo 1 file skill hoặc cập nhật CLAUDE.md để lưu lại cách làm.

Quick Start

1. Tuần này: Viết spec trước khi prompt AI. Spec phải có: mục tiêu, architecture overview, các bước implementation.

2. Bước tiếp theo: Chia task thành 3-5 phase nhỏ. Mỗi phase phải deploy được và test được riêng.

3. Tuần tới: Cập nhật spec mỗi khi design thay đổi. Không để spec lạc hậu so với code.