Claude cho Engineering: Quản lý Tech Debt

Tech debt là thứ mọi codebase đều có nhưng ít team quản lý có hệ thống. Phần lớn team kỹ thuật ở Việt Nam rơi vào một trong hai cực: hoặc bỏ qua hoàn toàn cho đến khi codebase trở nên không thể bảo trì, hoặc dừng hết feature development để "refactor toàn bộ" — cả hai đều suboptimal. Claude có thể giúp bạn audit tech debt một cách có hệ thống, prioritize đúng chỗ, và tạo kế hoạch remediation thực tế chạy song song với feature work.

Sáu loại tech debt

Framework ưu tiên tech debt

Điểm mỗi item theo 3 chiều:

• Impact: Nó làm chậm team bao nhiêu? (1-5)
• Risk: Điều gì xảy ra nếu không fix? (1-5)
• Effort: Khó fix đến đâu? (1-5, đảo ngược — effort thấp = điểm cao)

Priority = (Impact + Risk) x (6 - Effort)

Item có Impact=5, Risk=4, Effort=2 sẽ có Priority = (5+4) x (6-2) = 36 — ưu tiên cao nhất.

Prompt mẫu: Audit tech debt từ codebase description

Hãy giúp tôi audit tech debt cho codebase Node.js
của một startup fintech 3 năm tuổi:

Tình trạng hiện tại:
- Codebase 150K LOC, bắt đầu từ 2023
- Team hiện tại: 8 engineers (3 người original)
- 60% code không có tests
- Dependencies: 40 packages, nhiều cái cũ 2+ năm
- Deployment: Script bash thủ công, không CI/CD
- Monitoring: Chỉ có Sentry, không có metrics
- Database: PostgreSQL, nhưng nhiều query N+1
- Authentication: JWT nhưng không có token rotation

Hãy:
1. Categorize theo 6 loại tech debt
2. Estimate impact/risk/effort cho mỗi loại
3. Prioritize và đề xuất kế hoạch 6 tháng
4. Identify "quick wins" trong 2 tuần đầu

Ví dụ output từ Claude

## Tech Debt Audit: Fintech Startup

### Summary
Codebase có tech debt significant nhưng manageable.
Top priorities: Security (JWT rotation), Infrastructure
(CI/CD), và Test Coverage (regressions risk cao).

### Prioritized Debt Items

| Item | Type | Impact | Risk | Effort | Score |
|------|------|--------|------|--------|-------|
| JWT không rotate | Security | 4 | 5 | 2 | 36 |
| Không có CI/CD | Infrastructure | 5 | 4 | 3 | 27 |
| Test coverage 40% | Test | 5 | 4 | 4 | 27 |
| N+1 queries | Code | 4 | 3 | 2 | 28 |
| Dependencies cũ | Dependency | 3 | 4 | 2 | 28 |
| Không monitoring | Infrastructure | 4 | 4 | 3 | 24 |
| Deploy thủ công | Infrastructure | 4 | 3 | 3 | 21 |

### Kế hoạch 6 tháng

**Tháng 1-2: Foundation (Security + CI/CD)**
- Implement JWT token rotation + refresh tokens
- Setup GitHub Actions CI/CD
- Update 10 dependencies có CVE known
- Quick wins: Fix top 5 N+1 queries

**Tháng 3-4: Reliability (Testing + Monitoring)**
- Test coverage từ 40% -> 60%
- Setup Datadog/Prometheus metrics
- Document runbooks cho top 5 incidents

**Tháng 5-6: Scalability (Architecture)**
- Identify và plan tách monolith (nếu cần)
- IaC với Terraform
- Database query optimization

### Quick Wins (2 tuần đầu)
1. Update packages có known CVEs (4 giờ)
2. Add GitHub Actions cho test chạy tự động (8 giờ)
3. Fix 3 critical N+1 queries (impact lớn nhất)
4. Implement JWT rotation (security critical)

Prompt mẫu: Audit code cụ thể

Đây là module users.js trong codebase của tôi.
Hãy identify tech debt cụ thể với gợi ý refactor:

[paste code]

Tôi muốn biết:
1. Code smells cụ thể (tên, dòng nào)
2. Security issues
3. Performance issues
4. Cách refactor từng phần
5. Ưu tiên theo impact

Prompt mẫu: Đề xuất với management

Hãy giúp tôi viết đề xuất cho CTO về việc dành
20% sprint capacity cho tech debt.

Context:
- 3 incidents trong tháng qua do code quality
- Deploy time tăng từ 15 phút lên 45 phút
- Onboarding developer mới mất 3 tuần (trước là 1 tuần)
- 2 senior developers đã than về code quality

Tôi cần một trang document thuyết phục,
có số liệu, và đề xuất concrete về prioritization.
Tone: technical nhưng business-focused.

Cách tích hợp tech debt vào sprint

Claude có thể giúp bạn estimate và plan tech debt work trong sprint thực tế:

Sprint 14 của chúng tôi có capacity 80 story points.
Feature work đã commit: 64 points.

Tech debt backlog (đã được prioritize):
1. Fix JWT rotation (8 points, Priority: Critical)
2. Add Redis caching cho product catalog (5 points, High)
3. Refactor order.js - God Object (13 points, Medium)
4. Update 15 outdated dependencies (3 points, Medium)
5. Write tests cho payment module (8 points, High)

Hãy đề xuất cách phân bổ 16 points còn lại
cho tech debt, justify reasoning.

Theo dõi tiến độ tech debt

Tôi muốn setup một system đơn giản để track
tech debt cho team 6 engineers.

Requirements:
- Mọi người có thể add debt items dễ dàng
- Prioritization rõ ràng
- Visible trong sprint planning
- Không quá overhead

Chúng tôi dùng Linear cho project management.
Đề xuất workflow và labels/fields cần setup.

Dependency audit tự động

Đây là output của npm audit:

[paste npm audit output]

Hãy:
1. Categorize severity (Critical/High/Medium/Low)
2. Identify những cái cần fix ngay (security risk)
3. Estimate effort để update từng package
4. Flag các breaking changes có thể xảy ra
5. Tạo update plan theo thứ tự ưu tiên

Mẹo quản lý tech debt hiệu quả

• Đừng "tech debt sprint" riêng: Chạy song song với feature work. 20% capacity bền vững hơn 100% theo đợt.
• Ưu tiên bằng số: Framework Impact x Risk / Effort giúp tránh tranh luận chủ quan.
• Kết nối với incidents: Mỗi incident là cơ hội: "Tech debt nào góp phần gây ra incident này?"
• Celebrate payoff: Khi refactor giúp feature mới develop nhanh hơn, document và share với team.

Bước tiếp theo

Tech debt management là chiến lược dài hạn, không phải one-time fix:

• Thư viện ứng dụng Claude cho Engineering
• Kết hợp với Code Review workflow để ngăn tech debt mới tích lũy
• Dùng Testing Strategy workflow để address test debt một cách có hệ thống

Bài viết liên quan

• Claude cho Engineering: Incident Response workflow
• Claude cho Engineering: Standup và báo cáo tiến độ
• Claude cho Engineering: System Design interviews và planning
• Claude cho Data: Tạo biểu đồ và visualization
• Bắt đầu với Claude Vision — Gửi hình ảnh qua API