ddadmin
50640d8cb5
- Зачем:
- нужен ручной скилл для брейнсторма и дизайна, который удерживает
словарь смыслов (CONTEXT.md) и лёгкие ADR, активно прожаривает план
и не сваливается в реализацию.
- Что:
- SKILL.md: процесс (контекст → классификация → декомпозиция →
грилл → синтез опций → подтверждение → артефакт), единый HARD-GATE
«исследуй, но не меняй состояние» с поправкой на auto mode.
- artifacts/: шаблоны spec, research-note, adr, runbook, prd, context
(по файлу на тип для progressive disclosure).
- README.md с MIT-атрибуцией grill-with-docs (Pocock) и brainstorming
(obra/superpowers); шов для будущей фазы дивергенции в шаге 5.
- frontmatter переносим: Claude читает все поля, Codex — name+description.
- Проверка:
- python3 yaml-парс frontmatter; markdown-ссылки на artifacts/ резолвятся.
38 lines
824 B
Markdown
38 lines
824 B
Markdown
# Runbook
|
|
|
|
Use for operational procedures: diagnostics, verification, recovery, deployment,
|
|
or routine maintenance. A runbook is for *doing*, so optimise for someone
|
|
following it under pressure — concrete commands, expected output, clear failure
|
|
branches.
|
|
|
|
## Template
|
|
|
|
```markdown
|
|
# Title
|
|
|
|
## Purpose
|
|
|
|
## When to use
|
|
|
|
## Preconditions
|
|
|
|
## Procedure
|
|
|
|
## Verification
|
|
|
|
## Rollback / recovery
|
|
|
|
## Known failure modes
|
|
|
|
## Notes
|
|
```
|
|
|
|
## Notes
|
|
|
|
- **Procedure** steps should be copy-pasteable where possible, with the expected
|
|
result after each consequential step.
|
|
- **Verification** is how the operator confirms success — not "it should work"
|
|
but "run X, expect Y".
|
|
- **Rollback / recovery** and **Known failure modes** are what separate a
|
|
runbook from a tutorial. If you can't say how to undo it, say that explicitly.
|