Concept Templates Index
AI Agent Instructions
Vai trò của thư mục này: /templates/concepts/ chứa biểu mẫu cho từng document type được định nghĩa trong /.okf/profile.yaml. Mỗi file template tương ứng 1:1 với một type trong schema.
Quy tắc sử dụng template:
- Chọn template theo
typecần tạo (xem bảng bên dưới). - Copy toàn bộ nội dung template.
- Thay thế tất cả placeholder có dạng
[...]vàYYYY-MM-DD. - Set
status: draft,timestamp= current datetime ISO 8601,review_bytheo review cycle của type đó. - Thêm
generated_bynếu là AI-generated document.
Review cycles (từ /.okf/profile.yaml):
- 90 ngày: Playbook, Runbook, Incident, ChaosExperiment, ExperimentRun, Handover
- 365 ngày: Service, Policy, Contact, DRPlan, RecoveryObjective, BCPlan, BusinessFunction, Component, DataFlow, ADR, SecurityIncident
Danh Mục Concept Templates
| Template | Type | Review Cycle | Mô tả ngắn |
|---|---|---|---|
| /templates/concepts/service.md | Service | 365 ngày | Anchor node cho dịch vụ — SLA, dependencies, operational contacts. |
| /templates/concepts/playbook.md | Playbook | 90 ngày | Điều phối sự cố — roles, response procedure, escalation criteria. |
| /templates/concepts/runbook.md | Runbook | 90 ngày | Thủ tục kỹ thuật step-by-step — CLI commands, verification, rollback. |
| /templates/concepts/incident.md | Incident | 90 ngày | PIR sau sự cố — timeline, RCA, corrective actions. |
| /templates/concepts/security-incident.md | SecurityIncident | 365 ngày | PIR bảo mật — metadata-only, evidence_vault_url bắt buộc. |
| /templates/concepts/handover-soc.md | Handover | 90 ngày | Bàn giao ca trực SOC — security alerts, active investigations, SIEM status. |
| /templates/concepts/handover-noc.md | Handover | 90 ngày | Bàn giao ca trực NOC — infrastructure health, network status, change requests. |
| /templates/concepts/handover-combined.md | Handover | 90 ngày | Bàn giao ca trực kết hợp SOC+NOC — dùng cho team nhỏ cover cả hai nhiệm vụ. |
| /templates/concepts/drplan.md | DRPlan | 365 ngày | Kế hoạch khôi phục thảm họa — RTO/RPO targets, DR procedures. |
| /templates/concepts/recovery-objective.md | RecoveryObjective | 365 ngày | Mục tiêu phục hồi — RTO, RPO cụ thể cho từng service. |
| /templates/concepts/bcplan.md | BCPlan | 365 ngày | Kế hoạch liên tục kinh doanh — business function continuity. |
| /templates/concepts/business-function.md | BusinessFunction | 365 ngày | Chức năng nghiệp vụ — abstract business process và dependencies. |
| /templates/concepts/chaos-experiment.md | ChaosExperiment | 90 ngày | Định nghĩa thí nghiệm chaos — hypothesis, blast radius, success metrics. |
| /templates/concepts/experiment-run.md | ExperimentRun | 90 ngày | Kết quả một lần chạy chaos experiment cụ thể. |
| /templates/concepts/component.md | Component | 365 ngày | Thành phần kiến trúc — infrastructure component details. |
| /templates/concepts/data-flow.md | DataFlow | 365 ngày | Luồng dữ liệu — data path giữa các components. |
| /templates/concepts/adr.md | ADR | 365 ngày | Architecture Decision Record — quyết định kiến trúc và lý do. |
| /templates/concepts/policy.md | Policy | 365 ngày | Chính sách vận hành — SLA parameters, enforcement rules. |
| /templates/concepts/contact.md | Contact | 365 ngày | Directory liên lạc — team assignments, on-call rotations. |