К основному содержанию
команда CX Codex

wa-guardrails — команда для Claude Code: что делает и как установить

Команда wa-guardrails генерирует превентивные правила AWS Well-Architected: проверки в CI, правила AWS Config, SCP и алерты CloudWatch для защиты инфраструктуры от регрессий.

MIT-0 ★ 280 обновлён 2026-10-06

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/wa-guardrails.md
Открыть на GitHub

Что делает wa-guardrails

Команда переводит рекомендации AWS Well-Architected Framework в исполняемый код. Вместо разового аудита она создаёт постоянные барьеры безопасности: политики Service Control Policies (SCP), правила AWS Config, проверки в IaC (CDK Aspects, cfn-guard, OPA или Sentinel) и алерты CloudWatch. Команда опирается либо на готовый отчёт аудита, либо сканирует кодовую базу CloudFormation, CDK, SAM или Terraform сама.

Сценарий отдаёт приоритет превентивным проверкам. Он блокирует некорректные изменения ещё на этапе CI до деплоя, а детективные правила Config оставляет для дрифта и рантайма. По умолчанию фокус ставится на столпы Security и Reliability. Без нужных прав в аккаунте инструмент честно исключает недоступные меры из итогового плана.

На выходе формируется план развёртывания с переводом правил из режима предупреждений в режим блокировки, примеры файлов и опциональный документ контекста (CLAUDE.md или .cursor/rules/) с правилами для ИИ-агентов.

Какие задачи решает

  • заблокировать небезопасные конфигурации AWS до деплоя на этапе CI
  • создать правила AWS Config и SCP по отчёту Well-Architected
  • настроить политики CDK Aspects или cfn-guard против открытых портов и бакетов
  • сформировать правила для AI-агента в CLAUDE.md или .cursor/rules

Примеры запросов агенту

  • Сгенерируй guardrails для нашего CDK-проекта на основе отчёта Well-Architected
  • Просканируй Terraform-код и настрой правила OPA для проверки шифрования и бэкапов
  • Создай превентивные правила для CI и обнови файл CLAUDE.md требованиями безопасности

Как установить wa-guardrails

Вручную: положить файлы

.claude/commands/wa-guardrails.md

Вызов — /wa-guardrails. Для всех проектов — ~/.claude/commands/

Вопросы о wa-guardrails

Как установить команду wa-guardrails в Claude Code?

Сохраните файл команды по пути .claude/commands/wa-guardrails.md. После этого команда станет доступна в окружении Claude Code.

Что делает wa-guardrails?

Команда анализирует IaC-код или результаты аудита Well-Architected и создаёт постоянные проверки: правила для CI/CD (CDK Aspects, cfn-guard, OPA), SCP в AWS Organizations и правила AWS Config.

Чем превентивные правила отличаются от детективных в выводе команды?

Превентивные барьеры прерывают сборку в CI при обнаружении ошибок до развёртывания. Детективные правила следят за уже созданными ресурсами и фиксируют дрифт настроек в облаке.

Исходный текст

wa-guardrails.md · MIT-0
Generate preventive Well-Architected guardrails — AWS Config rules, Service Control Policies, permission boundaries, CloudWatch alarms, and IaC policy checks (CDK Aspects, cfn-guard, OPA/Sentinel) — so a workload stays aligned with Well-Architected best practices over time instead of being assessed once.

Unlike the assessment commands (which find gaps) or one-off remediation (which fixes a single finding), guardrails codify best practices so non-compliant changes are blocked or flagged automatically — in CI, at deploy time, and continuously in the account.

## Step 1: Gather context

Ask the user (skip anything already provided or inferable from the codebase):

> I can generate guardrails to keep your workload Well-Architected. Let me know:
> - **Workload name** and code packages/directories (IaC, CI/CD configs)
> - **IaC dialect**: CDK (which language), CloudFormation, Terraform, SAM, or mixed
> - **Source of controls**: a prior `/aws-well-architected-framework-review` or assessment output, specific concerns, or "scan and propose"
> - **Enforcement points available**: CI pipeline (which one), AWS Organizations/SCPs, AWS Config, account-level admin
> - **Pillars to prioritize** (optional; default: Security and Reliability)

If you are in a codebase, proceed directly and infer the IaC dialect and CI system from the files present.

## Step 2: Discovery — what to enforce

**Path A — From an assessment (preferred):** parse the prior review for findings, their pillar, severity, evidence (file:line), and the Best Practice IDs cited. Each High/Critical finding becomes a candidate guardrail so the same gap cannot recur.

**Path B — Standalone scan:** analyze the IaC and identify the control-worthy configurations in use — encryption, public access, IAM scope, multi-AZ, backups, logging, TLS, tagging — and map each to the WA Best Practice it relates to.

Produce a **control candidate list**: pillar, WA Question/BP ID, resource type, current state (compliant / non-compliant / absent), and the enforcement point that fits.

## Step 3: Select preventive vs. detective

For each candidate pick the strongest control the user's enforcement points allow. Prefer **preventive** over detective:

- Catchable in IaC before deploy → **CI policy check** (CDK Aspect, `cfn-guard`/`cfn-lint`, Terraform OPA/Sentinel). Strongest: it blocks the change before anything is deployed.
- Must be blocked org-wide → **SCP / permission boundary**.
- Only observable on the live resource (drift, runtime) → **AWS Config rule** (detective; auto-remediation only if confirmed).
- Continuous reliability/cost/performance signal → **CloudWatch metric + alarm**.

If a control can't be enforced with the available points, say so rather than emitting something that won't run.

## Step 4: Generate the controls

Emit each selected control as ready-to-commit code in the workload's existing dialect. Each MUST cite the WA Question/BP ID it enforces, be labeled 🛡️ Preventive or 🔍 Detective, and state in one line what it blocks/flags and why. Cover as applicable:

- **Security (SEC)** — Config: `s3-bucket-server-side-encryption-enabled`, `s3-bucket-public-read-prohibited`, `iam-policy-no-statements-with-admin-access`; SCP denying unencrypted-resource creation or CloudTrail disablement; CDK Aspect failing synth on a `0.0.0.0/0` security group.
- **Reliability (REL)** — `rds-multi-az-support`, `dynamodb-pitr-enabled`, `db-instance-backup-enabled`; `cfn-guard` rule requiring `DeletionProtection`; alarm on DLQ depth.
- **Operational Excellence (OPS)** — CI check for required tags; Config rule for log retention; SCP preventing out-of-band changes.
- **Cost (COST)** — CI check for approved instance types/capacity modes; budget/anomaly alarm.
- **Performance / Sustainability (PERF/SUS)** — CI check preferring Graviton/managed services.

Provide each snippet in a fenced code block with its target filename, matching the workload's dialect. Examples of the three common forms:

```yaml
# guardrails/config-rules.yaml  — 🔍 Detective, SEC 8 (encryption at rest)
Resources:
  S3EncryptionEnabled:
    Type: AWS::Config::ConfigRule
    Properties:
      ConfigRuleName: s3-bucket-server-side-encryption-enabled
      Source: { Owner: AWS, SourceIdentifier: S3_BUCKET_SERVER_SIDE_ENCRYPTION_ENABLED }
```

```typescript
// guardrails/no-open-sg.aspect.ts — 🛡️ Preventive, SEC 5 (fails cdk synth on 0.0.0.0/0)
export class NoOpenIngress implements IAspect {
  visit(node: IConstruct): void {
    if (node instanceof CfnSecurityGroupIngress &&
        node.cidrIp === "0.0.0.0/0" && ![80, 443].includes(Number(node.fromPort))) {
      Annotations.of(node).addError(`SEC 5: open to 0.0.0.0/0 on port ${node.fromPort}`);
    }
  }
}
```

```
# guardrails/reliability.guard — 🛡️ Preventive, REL 9 (cfn-guard)
AWS::RDS::DBInstance { Properties { MultiAZ == true  DeletionProtection == true } }
```

## Step 5: Produce the guardrails plan

Output: a summary (dialect, enforcement points, source, control counts split preventive/detective); controls grouped by pillar (each with name, preventive/detective label, enforcement point, what it blocks, the file + snippet, and any coverage gap); a **rollout plan** table (start preventive checks/SCPs in warn/log mode, promote to block once clean); a **verification** section (attempt a known-bad change, confirm CI fails / check Config compliance); and a **not covered** section for controls the available enforcement points can't implement.

## Step 6: Offer a governance steering doc

Beyond machine-enforced controls, offer to capture the same standards as a **human- and agent-readable governance doc** — the prose counterpart to the guardrails, for standards a control can't fully express (design conventions, review expectations) and for teams that want an always-on policy their AI agent follows. Generate it on request as a steering file the agent loads automatically (`.kiro/steering/`, `CLAUDE.md`, `.cursor/rules/`), with: an "Enforced automatically" section (one line per machine control + its BP ID), a "Conventions to follow (not auto-enforced)" section, and standing "When proposing or reviewing changes" instructions. Keep each statement tied to a WA Question/BP ID and short enough for always-on context.

## Step 7: Offer follow-up

> Would you like me to:
> - Generate the CI workflow wiring (GitHub Actions / CodePipeline step) to run the policy checks?
> - Produce a governance steering doc (`CLAUDE.md` / `.cursor/rules/` / `.kiro/steering/`) capturing these standards for your AI agent?
> - Add auto-remediation to a detective Config rule (with safety review)?
> - Fix the existing violations these guardrails would block (remediate the current code)?
> - Tighten a control from warn mode to block mode?

## Calibration

- Prefer **preventive** (CI/IaC) over **detective**; fall back to detective only when the issue is only visible on the live resource.
- Never emit a control for an enforcement point the user doesn't have — say it's not enforceable and what's needed.
- Roll out preventive controls and `Deny` SCPs in **warn/log mode first** — a hard block on day one can break existing pipelines.
- Auto-remediation is destructive: only when explicitly asked, with a safety/rollback note.
- Tie every control to a WA Question/BP ID — a guardrail without a "why" gets disabled the first time it's inconvenient.
- Don't over-generate: a focused set the team keeps beats 50 noisy rules they'll mute.
- Match the workload's dialect — CDK Aspects for CDK, `cfn-guard` for CloudFormation, OPA/Sentinel for Terraform; don't mix paradigms.

<!--
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
SPDX-License-Identifier: MIT-0
-->

© aws-samples · MIT-0 · aws-samples/sample-well-architected-skills-and-steering

Похожие слэш-команды

Все слэш-команды по теме «Облака: AWS, Azure, GCP» →
aws-advisor Felipe Rodrigues - github.com/felipfr Скилл aws-advisor консультирует по архитектуре AWS, проверяет безопасность и сверяет параметры сервисов с документацией через MCP-инструменты. CX Codex +1 ★ 7 191звёзд репо aws-solution-architect borghei Скилл aws-solution-architect для Claude Code, Codex, Cursor и других платформ проектирует архитектуру AWS и генерирует IaC-шаблоны. Помогает подобрать стек под нагрузки и рассчитать примерные расходы. CX Codex +1 150установок aws-cloud-expert официальный github Субагент aws-cloud-expert для проектирования, развёртывания и оптимизации рабочих нагрузок на AWS. Охватывает серверлесс, контейнеры, базы данных, сеть, IaC и безопасность через призму AWS Well-Architected Framework. CX Codex +1 ★ 41 430звёзд репо aws-architecture-review-expert Giuseppe Trisciuoglio Субагент aws-architecture-review-expert проверяет шаблоны CloudFormation и архитектуру AWS по шести столпам Well-Architected Framework и находит проблемы безопасности. CX Codex ★ 372звёзд репо aws-cdk aws Скилл aws-cdk для Claude Code, который учит агента писать и деплоить инфраструктуру AWS на CDK на TypeScript и Python — от конструкций до импорта ресурсов и разбора ошибок CloudFormation. CX Codex +1 10 800установок aws-cdk-development zxkane Скилл aws-cdk-development для Claude Code ведёт агента по AWS CDK: стеки, конструкты, синтез и деплой. Описывает инфраструктуру кодом на TypeScript или Python. CX Codex +1 1 200установок

Из того же набора19

Весь набор →
sustainability-optimization Команда sustainability-optimization запускает разбор архитектуры по AWS Well-Architected, ограниченный столпом Sustainability, и выдаёт отчёт с таблицей возможностей и скорингом. CX Codex +1 ★ 280звёзд репо prompt Субагент prompt проводит аудит инфраструктуры AWS по Well-Architected Framework, находя риски в коде и IaC без автоматических правок в репозитории. CX Codex +1 ★ 280звёзд репо well-architected Правило применяет принципы AWS Well-Architected при разборе архитектуры, проектировании систем и написании инфраструктурного кода. Помогает структурировать рекомендации и явно показывать компромиссы. CX Codex +1 ★ 280звёзд репо wa-builder Команда wa-builder разбирает архитектуру по принципам AWS Well-Architected и создаёт схемы PlantUML, деревья решений и дорожные карты улучшений. CX Codex +1 ★ 280звёзд репо migration-readiness Команда migration-readiness анализирует кодовую базу и оценивает готовность нагрузки к переносу в AWS. Она пригодится, чтобы найти блокеры и составить план миграции по компонентам. CX Codex +1 ★ 280звёзд репо aws-well-architected-framework-review Правило aws-well-architected-framework-review прогоняет полный обзор Well-Architected по коду и IaC: шесть столпов, находки со ссылками на файл и строку, отчёт с планом исправлений. CX Codex +1 ★ 280звёзд репо aws-well-architected-framework-review Команда aws-well-architected-framework-review для Claude Code проверяет AWS-нагрузку по столпам Well-Architected Framework и связывает риски с кодом и инфраструктурой. Разбирает IaC, конфигурации и архитектуру приложения. CX Codex +1 ★ 280звёзд репо wa-builder Скилл wa-builder разбирает AWS Well-Architected применительно к вашей нагрузке, а потом собирает PlantUML-диаграмму с подсветкой столпов, деревья решений и план улучшений. CX Codex +1 ★ 280звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой