Suporte upstream incluído

Arquivos de suporte são incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Segurança do helper restaurada

scripts/validate-stack.sh executa cdk synth a partir da raiz do projeto selecionada pelo chamador, que executa a aplicação CDK desse projeto e suas dependências, pode escrever cdk.out e pode contatar provedores de contexto da AWS se o projeto exigir lookups. Revise o projeto e o contexto da AWS antes de invocá-lo. O helper não faz deploy; o deploy requer autorização separada do usuário.

Desenvolvimento AWS CDK

Esta skill fornece orientação abrangente para desenvolver infraestrutura AWS usando o Cloud Development Kit (CDK), com servidores MCP integrados para acessar o conhecimento mais recente da AWS e utilitários CDK.

Requisito de Documentação AWS

Sempre verifique fatos da AWS usando ferramentas MCP (mcp__aws-mcp__* ou mcp__*awsdocs*__*) antes de responder. A dependência aws-mcp-setup é carregada automaticamente — se as ferramentas MCP não estiverem disponíveis, guie o usuário através do fluxo de configuração dessa skill.

Orientação MCP Específica para CDK

O AWS Labs substituiu o servidor MCP CDK dedicado (awslabs.cdk-mcp-server) pelo mais amplo awslabs.aws-iac-mcp-server, que cobre CDK juntamente com CloudFormation e outros fluxos de trabalho de infraestrutura como código da AWS.

Para lookups de construtos CDK, recomendações de melhores práticas e orientação de padrões, instale awslabs.aws-iac-mcp-server. Ele vem no plugin deploy-on-aws de awslabs/agent-plugins, ou pode ser registrado diretamente com claude mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest.

Quando usá-lo:

• Recomendações de construtos CDK e lookups de API
• Padrões de melhores práticas CDK e CloudFormation
• Validação de templates sintetizados
• Orientação de configuração entre recursos

Quando Usar Esta Skill

Use esta skill quando:

• Criando novas stacks ou construtos CDK
• Refatorando infraestrutura CDK existente
• Implementando funções Lambda dentro do CDK
• Seguindo as melhores práticas do AWS CDK
• Validando configurações de stack CDK antes do deploy
• Verificando capacidades de serviços AWS e disponibilidade regional

Princípios Fundamentais do CDK

Nomenclatura de Recursos

CRÍTICO: NÃO especifique explicitamente nomes de recursos quando eles forem opcionais em construtos CDK.

Por quê: Nomes gerados pelo CDK permitem:

• Padrões reutilizáveis: Faça deploy do mesmo construto/padrão várias vezes sem conflitos
• Deploys paralelos: Múltiplas stacks podem fazer deploy simultaneamente na mesma região
• Lógica compartilhada mais limpa: Padrões e código compartilhado podem ser inicializados várias vezes sem colisão de nomes
• Isolamento de stack: Cada stack recebe recursos identificados unicamente automaticamente

Padrão: Deixe o CDK gerar nomes únicos automaticamente usando o mecanismo de nomenclatura do CloudFormation.

// ❌ BAD - Explicit naming prevents reusability and parallel deployments
new lambda.Function(this, 'MyFunction', {
  functionName: 'my-lambda',  // Avoid this
  // ...
});

// ✅ GOOD - Let CDK generate unique names
new lambda.Function(this, 'MyFunction', {
  // No functionName specified - CDK generates: StackName-MyFunctionXXXXXX
  // ...
});

Nota de Segurança: Para diferentes ambientes (dev, staging, prod), siga as melhores práticas do Pilar de Segurança da AWS usando contas AWS separadas em vez de confiar na nomenclatura de recursos dentro de uma única conta. O isolamento em nível de conta fornece limites de segurança mais fortes.

Desenvolvimento de Funções Lambda

Use o construto Lambda apropriado com base no runtime:

TypeScript/JavaScript: Use @aws-cdk/aws-lambda-nodejs

import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';

new NodejsFunction(this, 'MyFunction', {
  entry: 'lambda/handler.ts',
  handler: 'handler',
  // Automatically handles bundling, dependencies, and transpilation
});

Python: Use @aws-cdk/aws-lambda-python

import { PythonFunction } from '@aws-cdk/aws-lambda-python-alpha';

new PythonFunction(this, 'MyFunction', {
  entry: 'lambda',
  index: 'handler.py',
  handler: 'handler',
  // Automatically handles dependencies and packaging
});

Benefícios:

• Agrupamento e gerenciamento de dependências automáticos
• Transpilação tratada automaticamente
• Nenhum empacotamento manual necessário
• Padrões de deploy consistentes

Validação Pré-Deploy

Use uma estratégia de validação em várias camadas para verificações abrangentes de qualidade do CDK:

Camada 1: Feedback em Tempo Real do IDE (Recomendado)

Para projetos TypeScript/JavaScript:

…