create-agentic-aws

日本語

CLI tool to generate AI-agent-native AWS projects — supports Amazon Q, Claude Code, Copilot, and more

Quick Start

pnpm create agentic-aws my-app
cd my-app
bash scripts/setup.sh

Wizard

The interactive wizard asks 12 questions in an agent-first flow:

1. Project name
2. AI Agent tools — Amazon Q / Claude Code / GitHub Copilot (multi-select)
3. Infrastructure as Code — CDK / Terraform
4. Compute — Lambda / ECS / EKS / EC2 (multi-select)
5. AI — Bedrock / Bedrock Knowledge Bases / Bedrock Agents / OpenSearch (multi-select)
6. Data & Storage — S3 / DynamoDB / Aurora / RDS (multi-select)
7. Data Pipeline & Analytics — Kinesis / Glue / Redshift (multi-select)
8. Application Integration — SQS / SNS / EventBridge / Step Functions (multi-select)
9. Networking & API — API Gateway / CloudFront (multi-select)
10. Security & Identity — Cognito (multi-select)
11. Observability — CloudWatch (multi-select)
12. Language toolchains — TypeScript / Python (excluding auto-resolved)

Sub-options (ECS launch type, Aurora engine, API Gateway type, etc.) are shown after parent selection.

Presets

Composable presets across 13 layers. Each provides owned files + IaC contributions + merge contributions to shared files.

Layer	Presets
Base	Always included (AWS CLI, git hooks, linters, devcontainer)
Agent	Amazon Q, Claude Code, GitHub Copilot
IaC	CDK (TypeScript), Terraform
Compute	Lambda, ECS, EKS, EC2
AI	Bedrock, Bedrock Knowledge Bases, Bedrock Agents, OpenSearch
Data & Storage	S3, DynamoDB, Aurora, RDS
Data Pipeline & Analytics	Kinesis, Glue, Redshift
Application Integration	SQS, SNS, EventBridge, Step Functions
Networking & API	API Gateway, CloudFront
Security & Identity	Cognito
Observability	CloudWatch
Language	TypeScript, Python
Infrastructure (auto)	VPC (auto-resolved by compute/DB selection)

Service x IaC matrix

Each AWS service preset provides IaC-specific contributions. CDK generates Constructs; Terraform generates .tf files. Total: 24 services x 2 IaC = 48 templates.

See docs/resource-map.md for a complete mapping of wizard selections to generated AWS resources (CDK constructs and Terraform resource types).

See docs/design.md for the full preset details, dependency chains, and file ownership.

What You Get

Every generated project includes:

• AI Agent integration — Instruction files, MCP servers, skills (Claude Code), and rules per agent
• AWS infrastructure — CDK Constructs or Terraform configs for selected services
• Git hooks — commitlint (commit-msg), linters + Gitleaks (pre-commit), typecheck (pre-push)
• CI workflow — All linters + tests + build on push/PR
• Dev Container — VSCode devcontainer with AWS CLI, preset-specific tools, extensions, and ~/.aws mount
• Renovate — Automated dependency updates

Generated project structure

my-project/
├── infra/          # IaC (CDK Constructs or Terraform .tf files)
├── lambda/         # Lambda handlers (if selected)
├── ecs/            # ECS Dockerfile + app (if selected)
├── eks/            # EKS Dockerfile + app + K8s manifests (if selected)
├── ec2/            # EC2 user data (if selected)
├── lib/            # Shared code (DAL, consumers, schemas)
├── tests/
├── scripts/
├── .devcontainer/
├── .github/
├── .vscode/
└── ...

Development

pnpm install          # Install dependencies
pnpm run dev          # Watch mode build
pnpm run build        # Production build
pnpm test             # Run tests
pnpm run lint:all     # All linters + typecheck
pnpm run verify       # Verify generated output

Roadmap

Development is tracked via GitHub Milestones.

Architecture

• src/presets/*.ts — Preset logic (merge contributions, IaC contributions, dependencies)
• templates/*/ — Preset file assets (copied as-is to output)
• src/generator/ — Composition engine (resolve → transform → finalize → output)
• src/merge.ts — Per-filetype merge logic (JSON, YAML, TOML, HCL, Markdown)

See docs/design.md for the full design document.

License

MIT