| name | documentation-adr-skill |
| description | Use when: documenting architecture decisions, tradeoffs, impacts, and rollback guidance after important changes. |
Skill: Documentation và ADR
Mục tiêu
Ghi lại quyết định kiến trúc và thay đổi quan trọng để người mới có thể theo kịp nhanh.
Khi dùng
- Có thay đổi kiến trúc, contract API, flow quan trọng.
- Có quyết định kỹ thuật ảnh hưởng nhiều feature.
Nội dung cần ghi
- Vấn đề ban đầu.
- Các lựa chọn đã cân nhắc.
- Quyết định cuối cùng và lý do.
- Ảnh hưởng lên code hiện tại.
- Cách rollback nếu cần.
Vị trí ưu tiên cập nhật
docs/ cho hướng dẫn vận hành.
.agents/instructions/* nếu thay đổi quy tắc cho agent.
Done khi
- Tài liệu đủ để dev mới hiểu và tiếp tục triển khai.