runbook-write
User-invoked as /runbook-write <incident-type>. Drafts a new operational runbook in docs/runbooks/ using the Aegis runbook template. Use to document how on-call responds to a given incident/fault clas
Files1
View on GitHubSKILL.md.junie/skills/runbook-write/SKILL.md
GitHubRunbook Write
Draft a runbook for the incident type $ARGUMENTS (e.g. memory-access- violation, deadlock, resource-exhaustion, log-forensics-anomaly).
Steps
- Cross-reference the fault class against the agents' declared consensus
weights,
core/fault_codes.py, andIncidentModeso the runbook matches real product classifications. - Write
docs/runbooks/<incident-type>.mdusing the template below. - Add an index line to
docs/README.mdanddocs/runbooks/index if present.
Aegis runbook template
# Runbook - <Incident Type>
- Fault class / mode: <fault_code / IncidentMode>
- Severity default: <P0|P1|P2>
- Owner / escalation: <team / on-call>
## Detection signals
- How Aegis surfaces this (events, ConfidenceLevel, SkepticVerdict cues).
## Triage (first 5 minutes)
1. <step> - expected: <result>
## Investigation
- Which analysis agents dominate (consensus weights), what RCAReport fields to
read first, which dumps/logs to pull.
## Mitigation
1. <step> - idempotent? rollback? requires AEGIS_PROD_CONFIRMED?
## Escalation
- When to raise a HITLRequest / page on-call (PagerDuty) / post to the incident
Slack channel.
## Verification & resolution
- How to confirm the incident is resolved and move to post-mortem.
## Related
- ADRs, playbooks, prior post-mortems.
Output
Print the runbook path. Recommend the incident-analyst agent review the
mitigation/escalation steps for safety before the runbook is trusted.