Why This Matters

Core Concepts & Rules

Inputs:
- Incident type and symptoms
- Service information
- Common incident patterns
Entry Conditions:
- Template repository is accessible
- Team is trained on runbook structure
Outputs:
- Standardized runbook templates
- Runbook creation guidelines
- Template documentation
Artifacts Required (Deliverables):
- Quick runbook template
- Detailed runbook template
- Template documentation
- Best practices guide
Acceptance Evidence:
- Templates are used consistently
- All runbooks follow template structure
- Template compliance > 90%
Success Criteria:
- All runbooks use standardized templates
- Template compliance > 95%
- Runbook creation time reduced by 40%

Depends on: On-Call Playbooks
Compatible with: Incident Triage, Severity Levels
Conflicts with: Custom runbook formats
Related Skills:
- 41-incident-management/oncall-playbooks - Main skill with comprehensive runbook coverage
- 41-incident-management/incident-triage - Initial assessment
- 40-system-resilience/disaster-recovery - DR procedures

# Example implementation following best practices
def example_function():
    # Your implementation here
    pass

Assumptions:
- Development environment is properly configured
- Required dependencies are available
- Team has basic understanding of domain
Constraints:
- Must follow existing codebase conventions
- Time and resource limitations
- Compatibility requirements
Non-goals:
- This skill does not cover edge cases outside scope
- Not a replacement for formal training

Supported Versions:
- Python 3.8+
- Node.js 16+
- Modern browsers (Chrome, Firefox, Safari, Edge)
Required AI Tools:
- Code editor (VS Code recommended)
- Testing framework appropriate for language
- Version control (Git)
Dependencies:
- Language-specific package manager
- Build tools
- Testing libraries
Environment Setup:
- .env.example keys: API_KEY, DATABASE_URL (no values)

Type	Focus Area	Required Scenarios / Mocks
Unit	Core Logic	Must cover primary logic and at least 3 edge/error cases. Target minimum 80% coverage
Integration	DB / API	All external API calls or database connections must be mocked during unit tests
E2E	User Journey	Critical user flows to test
Performance	Latency / Load	Benchmark requirements
Security	Vuln / Auth	SAST/DAST or dependency audit
Frontend	UX / A11y	Accessibility checklist (WCAG), Performance Budget (Lighthouse score)

Data Handling: Sanitize all user inputs to prevent Injection attacks. Never log raw PII
Secrets Management: No hardcoded API keys. Use Env Vars/Secrets Manager
Authorization: Validate user permissions before state changes

Logging Standards: Structured JSON, include trace IDs request_id
Metrics: Track error_rate, latency, queue_depth
Error Handling: Standardized error codes, no bare except
Observability Artifacts:
- Log Fields: timestamp, level, message, request_id
- Metrics: request_count, error_count, response_time
- Dashboards/Alerts: High Error Rate > 5%

(ข้อกำหนดสำหรับ AI Agent ในการคิดและแก้ปัญหาเมื่อเกิดข้อผิดพลาด)

Thinking Process: Analyze root cause before fixing. Do not brute-force.
Fallback Strategy: Stop after 3 failed test attempts. Output root cause and ask for human intervention/clarification.
Self-Review: Check against Guardrails & Anti-patterns before finalizing.
Output Constraints: Output ONLY the modified code block. Do not explain unless asked.