Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
64 commits
Select commit Hold shift + click to select a range
0f7f133
feat(gcp-to-aws): Add GCP-to-AWS migration plugin (v1.0)
Feb 26, 2026
114bf10
refactor(gcp-to-aws): Refactor discover phase architecture into modul…
Feb 26, 2026
ffdbae8
refactor(gcp-to-aws): Make discover phase specifications more prescri…
Feb 26, 2026
b10f365
refactor(gcp-to-aws): Simplify discover phase - discover-iac produces…
Feb 26, 2026
23afe1c
refactor(gcp-to-aws): Explicitly forbid extra files - discover output…
Feb 26, 2026
2d84eb7
fix(gcp-to-aws): Clarify Rule 2 - ONE cluster per resource type, not …
Feb 26, 2026
e2a00a4
merge(gcp-to-aws): Merge discover phase refactoring into main
Feb 26, 2026
39c2441
build: Configure bandit to exclude node_modules from security scans
icarthick Feb 26, 2026
50942d0
style: Apply dprint formatting to discover phase files
icarthick Feb 26, 2026
7714075
chore: Add package.json and package-lock.json
icarthick Feb 26, 2026
d7362c7
chore: Remove package.json and package-lock.json
icarthick Feb 26, 2026
8732b1d
chore: Add package.json and package-lock.json to .gitignore
icarthick Feb 26, 2026
033c4c9
revert: Undo bandit configuration changes
icarthick Feb 26, 2026
2436511
docs: Add gcp-to-aws plugin to documentation
icarthick Feb 26, 2026
f8a9a6f
style: Apply dprint formatting to README.md
icarthick Feb 26, 2026
bc7bf2f
chore: Remove package.json and package-lock.json from .gitignore
icarthick Feb 26, 2026
c5ca339
refactor: Rename gcp-to-aws plugin to migration-to-aws
icarthick Feb 27, 2026
590c6d3
fix: Correct phase status schema logic
icarthick Feb 27, 2026
fcbb0b0
fix: Consolidate gcp-resource-inventory.json schema
icarthick Feb 27, 2026
6f16f6e
fix: Consolidate cluster ID naming format
icarthick Feb 27, 2026
5a560dc
fix(migration-to-aws): Fix compute.md factual error in timeout calcul…
icarthick Feb 27, 2026
fa38246
fix(migration-to-aws): Remove misleading IaC generation message from …
icarthick Feb 27, 2026
a9c299c
fix(migration-to-aws): Automatically protect migration state from git…
icarthick Feb 27, 2026
0923dd1
refactor(migration-to-aws): Consolidate duplicate schemas into single…
icarthick Feb 27, 2026
0e1a7dc
Merge branch 'main' into main
krokoko Feb 27, 2026
076f7ed
chore: Remove REVIEWER_FEEDBACK.md (internal tracking only)
icarthick Feb 27, 2026
3ff0cac
fix: Correct markdown formatting for lint compliance
icarthick Feb 27, 2026
c32df72
fix(migration-to-aws): Resolve 3 remaining reviewer issues
icarthick Feb 27, 2026
349cfd5
fix(migration-to-aws): Update plugin path in development instructions
icarthick Feb 27, 2026
bc612dd
fix: Align install command order with plugin table
icarthick Feb 27, 2026
b0c7e01
docs: Add migration-to-aws plugin team ownership to CODEOWNERS
icarthick Feb 27, 2026
ca5dd5d
Merge branch 'main' into main
krokoko Feb 27, 2026
924be14
fix(migration-to-aws): Fix depth pseudocode direction and README scop…
icarthick Feb 27, 2026
6c8cc13
fix(migration-to-aws): Resolve resource classification contradictions…
icarthick Feb 27, 2026
f0580f5
docs: Add migration-to-aws plugin to AGENTS.md (Critical Issue #5)
icarthick Feb 27, 2026
21e1961
fix(migration-to-aws): Add pricing fallback transparency and retry lo…
icarthick Feb 27, 2026
6b683ce
fix(migration-to-aws): Add architecture validation tracking (Critical…
icarthick Feb 27, 2026
648683d
fix(migration-to-aws): Add pricing fallback staleness enforcement (Cr…
icarthick Feb 27, 2026
a03553f
fix(migration-to-aws): Fix 3 critical cost estimation issues (Importa…
icarthick Feb 27, 2026
282f60a
fix(migration-to-aws): Align 4 schema inconsistencies (Important Issu…
icarthick Feb 27, 2026
5bea9d1
Fix 3 important workflow/logic issues (4, 8, 9)
icarthick Feb 27, 2026
4b850a1
Fix 3 critical workflow/logic issues (10, 11, 12)
icarthick Feb 27, 2026
cd3bb78
Fix 2 final important issues (13, 15)
icarthick Feb 27, 2026
c267765
Update plugins/migration-to-aws/skills/gcp-to-aws/references/shared/o…
icarthick Mar 2, 2026
b23bf18
Update plugins/migration-to-aws/skills/gcp-to-aws/references/shared/o…
icarthick Mar 2, 2026
b9faa78
Fix 6 review feedback items for migration-to-aws plugin
icarthick Mar 2, 2026
a6d52a9
Fix stray diff artifact in output-schema.md and clarify network class…
icarthick Mar 2, 2026
7fa40bd
Fix 4 review items: README scope, serves[] example, schema duplicatio…
icarthick Mar 2, 2026
01b3c7e
Update plugins/migration-to-aws/skills/gcp-to-aws/references/shared/o…
icarthick Mar 2, 2026
f0a0beb
Fix 6 review items: table inputs, network cluster, JSON validity, edg…
icarthick Mar 2, 2026
cf20657
Fix 3 review items: network classification, estimation numbers, edge …
icarthick Mar 2, 2026
1c9d5c9
Add input validation to discover, clarify, and execute phases
icarthick Mar 3, 2026
e144f92
Fix 4 critical issues from PR #73 review
icarthick Mar 3, 2026
530d8b5
Fix remaining critical and high issues from PR #73 review
icarthick Mar 3, 2026
51c7ed8
Fix critical and high issues from PR #73 review round 2
icarthick Mar 3, 2026
262107b
Fix critical and high issues from PR #73 review round 3
icarthick Mar 3, 2026
db3ea39
Fix all remaining issues from PR #73 external review
icarthick Mar 3, 2026
91859a0
Fix dprint table formatting in database and messaging design refs
icarthick Mar 3, 2026
8dc7bd0
Merge branch 'main' into main
krokoko Mar 3, 2026
a0f0375
Merge branch 'main' into main
krokoko Mar 5, 2026
5b64731
Merge branch 'main' into main
krokoko Mar 6, 2026
4ae6dac
Update plugin.json's description to include the correct description
icarthick Mar 6, 2026
bd2bdd5
Update plugin.json's description to be under 500 chars
icarthick Mar 6, 2026
c2b8cf0
Update migration description in marketplace.json
icarthick Mar 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,25 @@
"tags": ["aws", "location", "maps", "geospatial"],
"version": "1.0.0"
},
{
"category": "migration",
"description": "This no-cost tool assesses your current cloud provider's usage, geography, and billing data to estimate and compare AWS services and pricing, and recommends migration or continued use of your current provider. AWS pricing is based on current published pricing and may vary over time. The tool may generate a .migration folder containing comparison and migration execution data, which you may delete upon completion or use to migrate to AWS.",
Comment thread
krokoko marked this conversation as resolved.
"keywords": [
"aws",
"gcp",
"google-cloud",
"migration",
"cloud-migration",
"terraform",
"fargate",
"rds",
"eks"
],
"name": "migration-to-aws",
"source": "./plugins/migration-to-aws",
"tags": ["aws", "gcp", "migration", "infrastructure"],
"version": "1.0.0"
},
{
"category": "development",
"description": "Design, build, deploy, test, and debug serverless applications with AWS Serverless services.",
Expand Down
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ tools/ @awslabs/agent-plugins-admins
plugins/amazon-location-service @awslabs/agent-plugins-admins @awslabs/agent-plugins-maintainers @awslabs/agent-plugins-agent-plugins-amazon-location-service
plugins/aws-serverless @awslabs/agent-plugins-admins @awslabs/agent-plugins-maintainers @awslabs/agent-plugins-aws-serverless
plugins/deploy-on-aws @awslabs/agent-plugins-admins @awslabs/agent-plugins-maintainers @awslabs/agent-plugins-deploy-on-aws
plugins/migration-to-aws @awslabs/agent-plugins-admins @awslabs/agent-plugins-maintainers @awslabs/agent-plugins-migrate-to-aws

## File must end with CODEOWNERS file

Expand Down
19 changes: 17 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## TL;DR Pitch

This repository supports **plugins** - bundles of skills, MCP servers, and agent configurations that extend capabilities. The `awslabs/agent-plugins` marketplace includes plugins like `deploy-on-aws` (architecture recommendations, cost estimates, and working IaC) and `amazon-location-service` (maps, geocoding, routing, and geospatial features).
This repository supports **plugins** - bundles of skills, MCP servers, and agent configurations that extend capabilities. The `awslabs/agent-plugins` marketplace includes plugins like `deploy-on-aws` (architecture recommendations, cost estimates, and working IaC), `amazon-location-service` (maps, geocoding, routing, and geospatial features), and `migration-to-aws` (GCP-to-AWS migration with resource discovery, architecture mapping, and cost analysis).

## Core Concepts

Expand Down Expand Up @@ -48,14 +48,22 @@ agent-plugins/
│ │ ├── defaults.md
│ │ ├── cost-estimation.md
│ │ └── security.md
── amazon-location-service/
── amazon-location-service/
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── .mcp.json
│ └── skills/
│ └── amazon-location-service/
│ ├── SKILL.md
│ └── references/
│ └── migration-to-aws/
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── .mcp.json
│ └── skills/
│ └── gcp-to-aws/
│ ├── SKILL.md
│ └── references/
├── schemas/ # JSON schemas for manifests
│ ├── marketplace.schema.json
│ ├── plugin.schema.json
Expand Down Expand Up @@ -87,6 +95,13 @@ agent-plugins/
| --------- | ----- | -------------------------------------- |
| `aws-mcp` | stdio | AWS documentation and service guidance |

### migration-to-aws

| Server | Type | Purpose |
| -------------- | ----- | ----------------------------------------------- |
| `awsknowledge` | HTTP | AWS documentation and architecture guidance |
| `awspricing` | stdio | Real-time AWS service pricing for cost analysis |

## Workflow: Deploy Skill

1. **Analyze** - Scan codebase for framework, database, dependencies
Expand Down
42 changes: 37 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,12 @@ To maximize the benefits of plugin-assisted development while maintaining securi

## Plugins

| Plugin | Description | Status |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------- |
| **deploy-on-aws** | Deploy applications to AWS with architecture recommendations, cost estimates, and IaC deployment | Available |
| **amazon-location-service** | Add maps, geocoding, routing, places search, and geospatial features to applications with Amazon Location Service | Available |
| **aws-serverless** | Build serverless applications with Lambda, API Gateway, EventBridge, Step Functions, and durable functions | Available |
| Plugin | Description | Status |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------- |
| **deploy-on-aws** | Deploy applications to AWS with architecture recommendations, cost estimates, and IaC deployment | Available |
| **amazon-location-service** | Add maps, geocoding, routing, places search, and geospatial features to applications with Amazon Location Service | Available |
| **migration-to-aws** | Migrate GCP infrastructure to AWS with resource discovery, architecture mapping, cost analysis, and execution planning | Available |
| **aws-serverless** | Build serverless applications with Lambda, API Gateway, EventBridge, Step Functions, and durable functions | Available |

## Installation

Expand All @@ -54,6 +55,12 @@ or
/plugin install amazon-location-service@agent-plugins-for-aws
```

or

```bash
/plugin install migration-to-aws@agent-plugins-for-aws
```

### Cursor

You can install the **deploy-on-aws** plugin from the [Cursor Marketplace](https://cursor.com/marketplace/aws). For additional information, please refer to the [Cursor plugin documentation](https://cursor.com/docs/plugins). You can also install within the Cursor application:
Expand Down Expand Up @@ -107,6 +114,31 @@ Guides developers through adding maps, places search, geocoding, routing, and ot
| ----------- | -------------------------------------- |
| **aws-mcp** | AWS documentation and service guidance |

## migration-to-aws

Helps you systematically migrate GCP infrastructure to AWS through Terraform resource discovery, architecture mapping, cost estimation, and execution planning.

### Workflow

1. **Discover** - Scan Terraform files for GCP resources and extract infrastructure
2. **Clarify** - Understand compute workloads and architecture patterns
3. **Design** - Map GCP services to AWS equivalents with rationale
4. **Estimate** - Calculate monthly AWS costs and compare to GCP
5. **Execute** - Plan migration timeline and identify deployment risks

### Agent Skill Triggers

| Agent Skill | Triggers |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| **gcp-to-aws** | "migrate GCP to AWS", "move from GCP", "GCP migration plan", "estimate AWS costs", "GCP infrastructure assessment" |

### MCP Servers

| Server | Purpose |
| ---------------- | ------------------------------------------------ |
| **awsknowledge** | AWS documentation, architecture guidance |
| **awspricing** | Real-time AWS service pricing for cost estimates |

## Requirements

- Claude Code >=2.1.29 or [Cursor >= 2.5](https://cursor.com/changelog/2-5)
Expand Down
20 changes: 20 additions & 0 deletions plugins/migration-to-aws/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"author": {
"name": "Amazon Web Services"
},
"description": "This no-cost tool assesses your current cloud provider's usage, geography, and billing data to estimate and compare AWS services and pricing, and recommends migration or continued use of your current provider. AWS pricing is based on current published pricing and may vary over time. The tool may generate a .migration folder containing comparison and migration execution data, which you may delete upon completion or use to migrate to AWS.",
Comment thread
krokoko marked this conversation as resolved.
"homepage": "https://github.com/awslabs/agent-plugins",
"keywords": [
"aws",
"gcp",
"google-cloud",
"migration",
"cloud-migration",
"terraform",
"fargate"
],
"license": "Apache-2.0",
"name": "migration-to-aws",
"repository": "https://github.com/awslabs/agent-plugins",
"version": "1.0.0"
}
19 changes: 19 additions & 0 deletions plugins/migration-to-aws/.mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"mcpServers": {
"awsknowledge": {
"type": "http",
"url": "https://knowledge-mcp.global.api.aws"
},
"awspricing": {
"args": [
"awslabs.aws-pricing-mcp-server@latest"
],
"command": "uvx",
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
},
"timeout": 120000,
"type": "stdio"
}
}
}
72 changes: 72 additions & 0 deletions plugins/migration-to-aws/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# GCP-to-AWS Migration Plugin

Migrate workloads from Google Cloud Platform to AWS with a 5-phase guided process.

## Overview

This plugin guides you through migrating GCP infrastructure to AWS by:

1. **Discover** - Scan Terraform files for GCP resources
2. **Clarify** - Answer 8 questions about your migration requirements
3. **Design** - Map GCP services to equivalent AWS services
4. **Estimate** - Calculate monthly costs and ROI
5. **Execute** - Plan your migration timeline and rollback procedures

## Usage

Invoke the skill with migration-related phrases:

- "Migrate my GCP infrastructure to AWS"
- "Move off Google Cloud"
- "Migrate Cloud SQL to RDS"
- "GCP to AWS migration plan"

## Scope (v1.0)

- **Supports**: Terraform-based GCP infrastructure
- **Generates**: AWS architecture design, cost estimates, execution timeline
- **Does not include** (v1.1+): App code scanning, billing data import, CDK code generation

## MCP Servers

The plugin integrates with:

- **awspricing** - Real-time AWS pricing (with fallback to cached data)
- **awsknowledge** - AWS service guidance and best practices

## Files

- `SKILL.md` - Main skill orchestrator
- `references/phases/` - Workflow phase implementations
- `references/design-refs/` - AWS service mapping rubrics
- `references/shared/` - Shared utilities and pricing data

## Architecture

The plugin uses state files (`.migration/[MMDD-HHMM]/`) to track migration progress across invocations:

- `.phase-status.json` - Current phase and status
- `gcp-resource-inventory.json` - Discovered GCP resources
- `clarified.json` - User requirements
- `aws-design.json` - Mapped AWS services
- `estimation.json` - Cost analysis
- `execution.json` - Timeline and risks

## Installation

```bash
/plugin marketplace add awslabs/agent-plugins
/plugin install migration-to-aws@agent-plugins-for-aws
```

## Development

To test locally:

```bash
claude --plugin-dir ./plugins/migration-to-aws
```

## License

Apache-2.0
Loading