런북 & 운영 문서

### 조치: API worker 재시작

- **조건**: p95 latency > 3s 상태가 5분 이상 지속되고, error rate < 1%
- **권한 모드**: Act allowed
- **행동**: `kubectl rollout restart deployment/api-worker`
- **확인**: 5분 안에 p95 latency < 1s
- **롤백/복구**: rollout 실패 시 `kubectl rollout undo deployment/api-worker`
- **에스컬레이션**: 10분 안에 복구 실패 시 L1 호출

## 진단

| 순서 | 관측값 | 명령/도구 | 정상 기준 |
|---|---|---|---|
| 1 | API error rate | Grafana `api-5xx-rate` | < 1% |
| 2 | 최근 배포 | `kubectl rollout history deployment/api` | 30분 내 배포 없음 |
| 3 | DB connection | `SELECT count(*) FROM pg_stat_activity` | < max의 80% |

## 에스컬레이션 매트릭스

| 레벨 | 조건 | 대상 | 채널 | SLA |
|---|---|---|---|---|
| L1 | 자동/저위험 조치 후 10분 미해결 | 온콜 엔지니어 | Slack #oncall | 10분 |
| L2 | L1 후 30분 미해결 또는 고객 영향 확대 | 팀 리드 | 전화 + Slack | 15분 |
| L3 | Sev1 또는 데이터 손상 가능성 | Incident Commander | War room | 즉시 |

.agents/skills/incident-triage/
├── SKILL.md
├── references/
│   ├── severity-policy.md
│   └── escalation-matrix.md
└── scripts/
    └── collect-diagnostics.sh

---
name: incident-triage
description: 장애 알림을 분석하고, 관련 런북을 찾아 진단 요약과 권장 조치를 보고할 때 사용한다.
---

1. 관련 런북을 찾는다.
2. 읽기 전용 진단만 수행한다.
3. 조치가 필요한 경우 권한 모드와 승인 필요 여부를 표시한다.
4. 사용자 승인 없이 destructive action을 실행하지 않는다.
5. 출력은 "관측값 / 판단 / 권장 조치 / 승인 필요 / 에스컬레이션" 순서로 작성한다.

---
title: "런북: {서비스명} - {장애 유형}"
severity: "{sev1|sev2|sev3}"
services: ["{서비스1}", "{서비스2}"]
owner: "{팀/담당자}"
last_tested: "{YYYY-MM-DD}"
allowed_modes: ["diagnose", "recommend"]
---

# 런북: {서비스명} - {장애 유형}

## 트리거
- 알림: {모니터링 알림 이름/ID}
- 조건: {수치 기반 조건}

## 영향 범위
- 영향 서비스:
- 영향 사용자:
- 비즈니스 영향:

## 진단

| 순서 | 관측값 | 명령/도구 | 정상 기준 |
|---|---|---|---|
| 1 | {metric/log} | `{read-only command}` | {기준} |

## 조치

### 조치 1: {조치 이름}
- **조건**:
- **권한 모드**: Diagnose / Recommend / Act
- **행동**:
- **확인**:
- **롤백/복구**:
- **승인 필요 여부**:

## 에스컬레이션

| 조건 | 대상 | 채널 | SLA |
|---|---|---|---|
| {조건} | {담당자/팀} | {Slack/전화} | {응답 시간} |

## 사후 처리
- [ ] 포스트모템 작성
- [ ] 근본 원인 분석
- [ ] 재발 방지 조치 등록
- [ ] 런북 업데이트

다음 장애 대응 위키를 에이전트 운용형 런북으로 변환해줘.

요구사항:
1. 진단, 권장 조치, 실행 조치를 분리한다.
2. 모든 조건을 수치화한다.
3. 각 조치에 권한 모드와 승인 필요 여부를 표시한다.
4. destructive action은 기본적으로 사람 승인 필요로 둔다.
5. MCP Tool로 노출할 수 있는 진단/조치 후보를 별도 표로 정리한다.

기존 문서:
{위키 내용}