Report Templates Index
AI Agent Instructions
Vai trò của thư mục này: /templates/reports/ chứa biểu mẫu output cho các công cụ AI automation trong /tools/. Các template này định nghĩa cấu trúc tài liệu được sinh tự động — không phải do engineer tạo thủ công.
Mapping giữa tool và template:
| Tool | Template | Trigger |
|---|---|---|
/tools/report/generate_pir.py | /templates/reports/pir.md | Incident feature branch được push |
/tools/review/drift_analyzer.py | /templates/reports/staleness-summary.md | Nightly CI schedule job trên main |
Khi nào AI agent cần đọc file này:
- Khi cần biết output format chuẩn trước khi sinh báo cáo.
- Khi debug output của generation pipeline không đúng cấu trúc.
Danh Mục Report Templates
| Template | Sinh bởi | Mô tả |
|---|---|---|
| /templates/reports/pir.md | generate_pir.py | Biểu mẫu Post-Incident Review — timeline, RCA, corrective actions table. |
| /templates/reports/staleness-summary.md | drift_analyzer.py | Biểu mẫu báo cáo tài liệu lỗi thời — expired docs list, drift detection summary. |