https://github.com/ozzy-labs/create-agentic-aws
CLI tool to generate AI-agent-native AWS projects — supports Amazon Q, Claude Code, Copilot, and more
https://github.com/ozzy-labs/create-agentic-aws
ai-agent amazon-q aws bedrock cdk claude-code cli scaffold terraform typescript
Last synced: about 1 month ago
JSON representation
CLI tool to generate AI-agent-native AWS projects — supports Amazon Q, Claude Code, Copilot, and more
- Host: GitHub
- URL: https://github.com/ozzy-labs/create-agentic-aws
- Owner: ozzy-labs
- License: mit
- Created: 2026-03-27T13:27:01.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-03T10:13:35.000Z (about 2 months ago)
- Last Synced: 2026-05-03T10:16:58.235Z (about 2 months ago)
- Topics: ai-agent, amazon-q, aws, bedrock, cdk, claude-code, cli, scaffold, terraform, typescript
- Language: TypeScript
- Size: 619 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.ja.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# create-agentic-aws
[English](README.md)
AI エージェント対応の AWS プロジェクトを生成する CLI ツール — Amazon Q、Claude Code、Copilot などをサポート
## クイックスタート
```bash
pnpm create agentic-aws my-app
cd my-app
bash scripts/setup.sh
```
## ウィザード
対話式ウィザードが 12 の質問をエージェントファーストの順序で行います:
1. **プロジェクト名**
2. **AI エージェントツール** — Amazon Q / Claude Code / GitHub Copilot（複数選択）
3. **Infrastructure as Code** — CDK / Terraform
4. **コンピュート** — Lambda / ECS / EKS / EC2（複数選択）
5. **AI** — Bedrock / Bedrock Knowledge Bases / Bedrock Agents / OpenSearch（複数選択）
6. **データ & ストレージ** — S3 / DynamoDB / Aurora / RDS（複数選択）
7. **データパイプライン & 分析** — Kinesis / Glue / Redshift（複数選択）
8. **アプリケーション統合** — SQS / SNS / EventBridge / Step Functions（複数選択）
9. **ネットワーク & API** — API Gateway / CloudFront（複数選択）
10. **セキュリティ & アイデンティティ** — Cognito（複数選択）
11. **オブザーバビリティ** — CloudWatch（複数選択）
12. **言語ツールチェーン** — TypeScript / Python（自動解決済みを除外）
サブオプション（ECS 起動タイプ、Aurora エンジン、API Gateway タイプなど）は親の選択後に表示されます。
## プリセット
13 レイヤーにまたがるコンポーザブルプリセット。各プリセットは所有ファイル + IaC 貢献 + 共有ファイルへのマージ貢献を提供します。
| レイヤー | プリセット |
|---------|----------|
| Base | 常に含まれる（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（コンピュート/DB 選択で自動解決） |
### Service x IaC マトリクス
各 AWS サービスプリセットは IaC 固有の貢献を提供します。CDK は Construct を生成し、Terraform は .tf ファイルを生成します。合計: 24 サービス x 2 IaC = 48 テンプレート。
ウィザードの選択と生成される AWS リソースの対応表は [docs/resource-map.md](docs/resource-map.md) を参照してください。
詳細は [docs/design.md](docs/design.md) を参照してください。
## 生成されるもの
すべての生成プロジェクトに含まれるもの:
- **AI エージェント統合** — インストラクションファイル、MCP サーバー、スキル（Claude Code）、エージェントごとのルール
- **AWS インフラストラクチャ** — 選択したサービスの CDK Construct または Terraform 設定
- **Git hooks** — commitlint (commit-msg)、linters + Gitleaks (pre-commit)、typecheck (pre-push)
- **CI ワークフロー** — 全 linter + テスト + ビルド（push/PR 時）
- **Dev Container** — AWS CLI、プリセット固有ツール、拡張機能、~/.aws マウント付き VSCode devcontainer
- **Renovate** — 依存関係の自動更新
### 生成プロジェクト構成
```text
my-project/
├── infra/ # IaC (CDK Construct または Terraform .tf ファイル)
├── lambda/ # Lambda ハンドラー（選択時）
├── ecs/ # ECS Dockerfile + アプリ（選択時）
├── eks/ # EKS Dockerfile + アプリ + K8s マニフェスト（選択時）
├── ec2/ # EC2 ユーザーデータ（選択時）
├── lib/ # 共有コード（DAL、コンシューマー、スキーマ）
├── tests/
├── scripts/
├── .devcontainer/
├── .github/
├── .vscode/
└── ...
```
## 開発
```bash
pnpm install # 依存関係インストール
pnpm run dev # ウォッチモードビルド
pnpm run build # プロダクションビルド
pnpm test # テスト実行
pnpm run lint:all # 全 linter + typecheck
pnpm run verify # 生成出力の検証
```
### ロードマップ
開発は [GitHub Milestones](https://github.com/ozzy-labs/create-agentic-aws/milestones) で管理しています。
## アーキテクチャ
- `src/presets/*.ts` — プリセットロジック（マージ貢献、IaC 貢献、依存関係）
- `templates/*/` — プリセットのファイルアセット（そのまま出力にコピー）
- `src/generator/` — 合成エンジン（解決 → 変換 → ファイナライズ → 出力）
- `src/merge.ts` — ファイルタイプ別マージロジック（JSON, YAML, TOML, HCL, Markdown）
詳細は [docs/design.md](docs/design.md) を参照してください。
## ライセンス
MIT