slo-architect — плагин для Claude Code: что делает и как установить
Проектирует SLI и SLO по методике Google SRE Workbook, рассчитывает бюджет ошибок и генерирует правила алертов. Пригодится инженерам надёжности и бэкендерам.
/plugin marketplace add alirezarezvani/claude-skills
/plugin install slo-architect@claude-code-skillsЧто делает slo-architect
Плагин внедряет инженерный подход к целевым показателям надёжности вместо случайных чисел вроде «99.9% на всё подряд». В комплект входят три скрипта на стандартной библиотеке Python: генератор спецификаций slo_designer.py, калькулятор бюджета ошибок error_budget_calculator.py с расчётом многооконного burn-rate под PromQL и анализатор slo_review.py. Инструмент проверки выявляет семь типовых ошибок, включая использование загрузки процессора в роли SLI или слишком узкое окно расчёта.
Для стандартизации процессов добавлены шаблоны slo_template.yaml и регламента error_budget_policy.md. Документация в составе плагина разбирает принципы связки с другими инструментами (флаги фич, хаос-инжиниринг, операторы Kubernetes) и пять пользовательских типов SLI: процент успешных запросов, задержку ответа, доступность, свежесть данных и корректность ответов. Генератор строго следит за структурой и отказывается создавать манифест, если пропущены обязательные поля.
Для запуска скриптов из комплекта в системе должен быть установлен Python.
Какие задачи решает
- рассчитать пороги алертов по скорости сжигания бюджета ошибок
- проверить готовые спецификации SLO на типовые архитектурные ошибки
- составить формальный регламент расходования бюджета ошибок
- спроектировать метрики SLI от пользовательского опыта, а не серверного железа
Примеры запросов агенту
- /slo-design --service
checkout-svc --sli-type request-success-rate --target 99.9 --window-days 28 - Проверь файлы в docs/slos/ через скрипт slo_review.py и покажи найденные ошибки
- Рассчитай пороги сжигания бюджета ошибок на 28 дней при целевом уровне 99.9%
Как установить slo-architect
Через маркетплейс плагинов
/plugin marketplace add alirezarezvani/claude-skills/plugin install slo-architect@claude-code-skillsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о slo-architect
Как установить slo-architect в Claude Code?
Сначала добавьте репозиторий каталога командой /plugin marketplace add alirezarezvani/claude-skills, затем установите сам плагин через /plugin install slo-architect@claude-code-skills.
Что делает плагин slo-architect?
Он помогает проектировать целевые уровни обслуживания по стандартам Google SRE, вычислять бюджеты ошибок с многооконными алертами и проверять спецификации на антипаттерны.
Какие типы SLI поддерживает плагин?
В комплект заложены пять пользовательских типов: request-success-rate, request-latency, availability-time, data-freshness и correctness.
Исходный текст
slo-architect · MIT
# SLO Architect
Define SLOs that mean something. Most "SLOs" in the wild are arbitrary numbers nobody believes — 99.9% on every endpoint, no SLI definition, no error budget policy. This skill enforces the Google SRE Workbook discipline.
## What's inside
- **3 stdlib Python tools** — SLO designer, error-budget calculator with multi-window burn-rate alerts, SLO reviewer
- **4 reference docs** — principles, SLI design, error budget, composition
- **2 asset templates** — SLO YAML, error budget policy
- **`/slo-design` slash command**
## Install
```bash
# Via Claude Code marketplace
/plugin install slo-architect
# Or clone the repo
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills/engineering/slo-architect
```
## Quick start
```bash
SKILL=engineering/slo-architect/skills/slo-architect
# 1. Design an SLO
python "$SKILL/scripts/slo_designer.py" \
--service checkout-svc --sli-type request-success-rate \
--target 99.9 --window-days 28
# 2. Compute error budget + multi-window burn-rate alerts
python "$SKILL/scripts/error_budget_calculator.py" --target 99.9 --window-days 28
# 3. Review existing SLOs for common bugs
python "$SKILL/scripts/slo_review.py" --slo-doc docs/slos/
```
## Key principles
1. **An SLO is a promise about user experience** — not a CPU graph
2. **Pick the SLI from the user's perspective** — request-success / latency / availability / freshness / correctness
3. **Pick the target from data** — measure 30 days, then floor it
4. **Multi-window burn-rate alerts** — single-window is either too noisy or too slow
5. **Error budget without a policy is theater** — every SLO ships with a policy
## The 5 SLI types
| User experience | SLI type |
|---|---|
| "Did the request succeed?" | request-success-rate |
| "Was the response fast?" | request-latency |
| "Was the service up?" | availability-time |
| "Is the data current?" | data-freshness |
| "Was the answer correct?" | correctness |
## Composition with the rest of the portfolio
| Skill | Composition |
|---|---|
| `feature-flags-architect` | Rollout abort criteria reference SLO burn-rate thresholds |
| `chaos-engineering` | Blast-radius calculator takes monthly error budget as input |
| `kubernetes-operator` | Operator capability L4 requires SLOs + Prometheus rules |
## Skill structure
```
slo-architect/
├── README.md
├── .claude-plugin/plugin.json
└── skills/slo-architect/
├── SKILL.md
├── scripts/
│ ├── slo_designer.py
│ ├── error_budget_calculator.py
│ └── slo_review.py
├── references/
│ ├── slo_principles.md
│ ├── sli_design.md
│ ├── error_budget.md
│ └── composition.md
└── assets/
├── slo_template.yaml
└── error_budget_policy.md
```
## Verifiable success
A team using this skill should achieve:
- 100% of SLOs pass `slo_review.py` with 0 FAIL findings
- Every SLO has a documented owner, error budget, burn-rate alerts, and policy
- Burn-rate alerts fire ≤2 times/month per SLO that's hit
- Mean time to detect SLO violation: <30 min
- Quarterly SLO review actually happens
## License
MIT — see repo root LICENSE.
© Alireza Rezvani · MIT · alirezarezvani/claude-skills
