Communitygithub.com

AWS CDK Builder (TypeScript)

AWS CDK 인프라 구축 도구로, TypeScript를 사용하여 L2/L3 구문과 Well-Architected 패턴을 활용합니다.

AWS CDK Builder (TypeScript)란 무엇인가요?

이 스킬은 AWS CDK를 TypeScript로 사용해 인프라를 구축하는 개발자 및 DevOps 엔지니어를 위해 설계되었습니다. L2 및 L3 구문을 우선적으로 사용하고, Well-Architected 프레임워크 패턴을 적용하여 보안, 안정성, 성능 효율성을 보장합니다. 주요 기능으로는 CDK Pipelines를 통한 자가 변이 CI/CD 파이프라인, cdk-nag를 통한 규정 준수 검사, 상태 저장(Stateful)과 무상태(Stateless) 스택 분리 아키텍처 패턴이 포함됩니다. 이 스킬은 Terraform IaC나 Kubernetes 매니페스트, Serverless Framework에는 적합하지 않으며, 각각 terraform-module-builder, kubernetes-manifest-generator, devops-automator 스킬을 사용하는 것이 좋습니다. 코드 예제와 품질 체크리스트를 통해 CDK 애플리케이션의 모범 사례를 빠르게 적용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/aws-cdk-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

AWS CDK Builder (TypeScript)은(는) 무엇을 하나요?

AWS CDK를 TypeScript로 사용하여 L2/L3 구문과 Well-Architected Framework 패턴을 활용한 인프라 구축 전문가입니다.

활성화 트리거

다음에서 활성화: "AWS CDK", "CDK construct", "CDK stack", "CDK pipeline", "AWS IaC TypeScript", "L2 construct", "CDK patterns", "cdk deploy", "cdk synth"

다음에는 사용하지 않음: Terraform IaC → terraform-module-builder | Kubernetes 매니페스트 → kubernetes-manifest-generator | Serverless Framework → devops-automator

빠른 시작

  1. CDK 앱 초기화 — npx cdk init app --language typescript
  2. 스택 구조 설계 — 상태 저장(데이터베이스, 버킷)과 무상태(컴퓨팅, API) 분리
  3. L2 구문 사용 — L1 CloudFormation 리소스보다 고수준 구문 선호
  4. CDK Nag 추가 — 자동화된 Well-Architected 규정 준수 검사
  5. CDK Pipelines로 배포 — 자가 변이 CI/CD 파이프라인

핵심 기능

도메인기술
CDK CoreCDK 2.180+, Constructs 라이브러리, CDK CLI, cdk.json
L2/L3 구문aws-lambda, aws-apigateway, aws-ecs-patterns, aws-rds
규정 준수cdk-nag (AwsSolutions, NIST, HIPAA, PCI 팩)
CI/CDCDK Pipelines, CodePipeline, CodeBuild, 자가 변이
패턴ECS Fargate 패턴, API Gateway + Lambda, S3 + CloudFront

아키텍처 패턴

스택 구성 (상태 저장 vs 무상태)

// bin/app.ts — 환경 분리가 포함된 최상위 앱
const app = new cdk.App();

// 상태 저장 스택 — 자주 변경되지 않으며 업데이트에 주의
const dataStack = new DataStack(app, 'Data-Prod', {
  env: { account: '123456789', region: 'us-east-1' },
});

// 무상태 스택 — 자주 배포되며 안전하게 파기/재생성 가능
const apiStack = new ApiStack(app, 'Api-Prod', {
  env: { account: '123456789', region: 'us-east-1' },
  database: dataStack.database,
  bucket: dataStack.bucket,
});

// 파이프라인 스택 — 자가 변이 CI/CD
new PipelineStack(app, 'Pipeline', {
  env: { account: '123456789', region: 'us-east-1' },
});

모범 사례를 적용한 L2 구문

// lib/api-stack.ts
export class ApiStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props: ApiStackProps) {
    super(scope, id, props);

    const handler = new lambda.Function(this, 'Handler', {
      runtime: lambda.Runtime.NODEJS_22_X,
      handler: 'index.handler',
      code: lambda.Code.fromAsset('lambda/'),
      memorySize: 256,
      timeout: cdk.Duration.seconds(30),
      tracing: lambda.Tracing.ACTIVE,       // X-Ray
      insightsVersion: lambda.LambdaInsightsVersion.VERSION_1_0_229_0,
      environment: {
        TABLE_NAME: props.table.tableName,
        POWERTOOLS_SERVICE_NAME: 'api',     // Lambda Powertools
      },
    });

    props.table.grantReadWriteData(handler); // 최소 권한

    const api = new apigw.RestApi(this, 'Api', {
      deployOptions: {
        tracingEnabled: true,
        metricsEnabled: true,
        throttlingRateLimit: 1000,
        throttlingBurstLimit: 500,
      },
    });

    api.root.addResource('items').addMethod('GET',
      new apigw.LambdaIntegration(handler));
  }
}

CDK Pipelines (자가 변이)

소스 (GitHub) → Synth (cdk synth) → 자가 변이
    │                                      │
    ▼                                      ▼
UpdatePipeline ─── 스테이징 배포 ─── 수동 승인 ─── 프로덕션 배포
                        │                                      │
                    통합 테스트                         스모크 테스트

안티 패턴

  1. 모든 곳에서 L1 구문 사용 — s3.Bucket 대신 CfnBucket 사용. L2 구문은 암호화, 로깅, 접근 제어 등 모범 사례를 기본으로 인코딩합니다.
  2. 모놀리식 스택 — 200개 이상의 리소스가 있는 하나의 스택은 CloudFormation 한도에 도달하고 배포 속도가 느려집니다. 상태 저장/무상태로 스택을 분할하고 스택 간 참조를 사용하세요.
  3. cdk-nag 누락 — 규정 준수 검사 없이 배포. Aspects.of(app).add(new AwsSolutionsChecks())를 추가하여 배포 전에 보안 문제를 잡으세요.
  4. 계정/리전 하드코딩 — 구문 코드에 account: '123456789' 사용. 이식성을 위해 cdk.json 컨텍스트 또는 cdk.Environment 조회를 사용하세요.
  5. 스냅샷 테스트 없음 — CDK는 예기치 않게 변경될 수 있는 CloudFormation 템플릿을 생성합니다. expect(template).toMatchSnapshot() 테스트를 추가하여 의도하지 않은 변경을 감지하세요.

품질 체크리스트

[ ] 스택 분리: 상태 저장(데이터) vs 무상태(컴퓨팅)
[ ] L2/L3 구문 사용 (원시 CloudFormation L1 대신)
[ ] cdk-nag 활성화 (AwsSolutions 팩)
[ ] 모든 스택에 대한 스냅샷 테스트
[ ] 자가 변이 CI/CD를 위한 CDK Pipelines
[ ] grant 메서드(grantRead, grantWrite)를 통한 최소 권한 IAM
[ ] cdk synth가 유효한 CloudFormation 생성
[ ] 스택 간 참조는 내보낸 출력 사용
[ ] 제거 정책 설정 (프로덕션 데이터는 RETAIN, 개발은 DESTROY)
[ ] 비용 할당을 위해 Aspects를 통해 태그 적용
[ ] 모든 배포 전에 cdk diff 검토
[ ] Lambda 함수는 관찰 가능성을 위해 Powertools 사용

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

관련 스킬