From 2c0d078ec81be9e07aae0f1b4a95671f4ed792a8 Mon Sep 17 00:00:00 2001 From: Scott Schreckengaust Date: Tue, 10 Feb 2026 13:43:04 -0800 Subject: [PATCH 1/4] Create .github/copilot-instructions.md file with Copilot instructions. --- .github/copilot-instructions.md | 49 +++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 .github/copilot-instructions.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 0000000..a2e376d --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,49 @@ +# GitHub Copilot Custom Instructions for Agent Plugins for AWS + +## Project Overview +This repository contains Agent Plugins for AWS that equip AI coding agents with the skills to help architects, deploy, and operate on AWS. The primary plugin is `deploy-on-aws`, which provides recommendations, cost estimates, and Infrastructure as Code generation. + +## Technology Stack +- **Language**: Primarily TypeScript/JavaScript +- **Framework**: Claude Code plugins +- **Cloud Platform**: AWS +- **Infrastructure as Code**: CDK and CloudFormation +- **Tools**: MCP Servers (awsknowledge, awspricing, aws-iac-mcp) + +## Code Organization +- `/plugins` - Plugin implementations +- `/schemas` - Data schemas and type definitions +- `/tools` - Utility tools and helpers +- `/.github` - GitHub workflows and configuration +- Root files: Configuration for linting (markdownlint, semgrep), security (gitleaks), and formatting (dprint) + +## Development Practices +1. **Code Quality**: Uses pre-commit hooks, semgrep for security analysis, and gitleaks for secret detection +2. **Documentation**: Comprehensive guides including DEVELOPMENT_GUIDE.md, CONTRIBUTING.md, TROUBLESHOOTING.md +3. **Testing**: Follow existing test patterns in the codebase +4. **Formatting**: Use dprint for code formatting consistency +5. **Commit Signoff**: Web commit signoff required (git commit -S flag) + +## Plugin Development Guidelines +- Follow the workflow pattern: Analyze → Recommend → Estimate → Generate → Deploy +- MCP Servers provide: AWS documentation, pricing data, and IaC best practices +- Skill triggers should be intuitive natural language phrases users would say +- Always include cost estimation and confirmation steps before deployment +- Generate infrastructure code with explanations and best practices + +## Important Reminders for Copilot +1. **AWS Best Practices**: Recommend services aligned with AWS Well-Architected Framework +2. **Cost Awareness**: Always estimate and display costs to users +3. **User Confirmation**: Never deploy without explicit user confirmation +4. **Multi-Agent Support**: Currently supports Claude Code; consider extensibility +5. **Security**: Follow AWS security best practices and principle of least privilege +6. **Documentation**: Provide clear explanations for architectural recommendations + +## Key Files to Reference +- `README.md` - Project overview and installation instructions +- `DEVELOPMENT_GUIDE.md` - How to create new plugins +- `CONTRIBUTING.md` - Contribution guidelines +- `TROUBLESHOOTING.md` - Common issues and solutions + +## License +Apache-2.0 License - Ensure all contributions comply with this license \ No newline at end of file From 4e855bd0b0f8adc883706ea356af58fa67ef3790 Mon Sep 17 00:00:00 2001 From: Scott Schreckengaust Date: Tue, 10 Feb 2026 14:44:50 -0800 Subject: [PATCH 2/4] Create codeowners.instructions.md Signed-off-by: Scott Schreckengaust --- .../instructions/codeowners.instructions.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 .github/instructions/codeowners.instructions.md diff --git a/.github/instructions/codeowners.instructions.md b/.github/instructions/codeowners.instructions.md new file mode 100644 index 0000000..02136f2 --- /dev/null +++ b/.github/instructions/codeowners.instructions.md @@ -0,0 +1,29 @@ +--- +applyTo: ".github/CODEOWNERS" +--- + +# CODEOWNERS file rules + +Please verify this checklist to keep the `.github/CODEOWNERS` file following all five of these rules: + +1. [ ] ONLY teams are used (no users) +2. [ ] Teams MUST be vertically aligned across all lines with spaces (no tabs) +3. [ ] Each section, "## section", MUST be alphabetically sorted (keep file patterns in order) +4. [ ] Admins or maintainers must be first (if both separated by one space) - others follow with two spaces +5. [ ] The file MUST follow this regular expression `^.github/CODEOWNERS *@awslabs/agent-plugins-admins$` + +EXAMPLE: + +```.github/CODEOWNERS +README.md @awslabs/agent-plugins-admins @awslabs/agent-plugins-maintainers @awslabs/otherteams + +## Plugins (alphabetically listed) + +plugins/a @awslabs/agent-plugins-maintainers @awslabs/a-team +plugins/d @awslabs/agent-plugins-maintainers @awslabs/a-d-group +plugins/z @awslabs/agent-plugins-maintainers @awslabs/the-z-team + +## File must end with CODEOWNERS file + +.github/CODEOWNERS @awslabs/agent-plugins-admins +``` From 64e324b6cb02c46028ba6cf7b672615ae005a851 Mon Sep 17 00:00:00 2001 From: Scott Schreckengaust Date: Wed, 11 Feb 2026 12:34:42 -0800 Subject: [PATCH 3/4] fix: formatting Signed-off-by: Scott Schreckengaust --- .github/copilot-instructions.md | 10 +++++++++- .github/instructions/codeowners.instructions.md | 2 +- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index a2e376d..f12e810 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,9 +1,11 @@ # GitHub Copilot Custom Instructions for Agent Plugins for AWS ## Project Overview + This repository contains Agent Plugins for AWS that equip AI coding agents with the skills to help architects, deploy, and operate on AWS. The primary plugin is `deploy-on-aws`, which provides recommendations, cost estimates, and Infrastructure as Code generation. ## Technology Stack + - **Language**: Primarily TypeScript/JavaScript - **Framework**: Claude Code plugins - **Cloud Platform**: AWS @@ -11,6 +13,7 @@ This repository contains Agent Plugins for AWS that equip AI coding agents with - **Tools**: MCP Servers (awsknowledge, awspricing, aws-iac-mcp) ## Code Organization + - `/plugins` - Plugin implementations - `/schemas` - Data schemas and type definitions - `/tools` - Utility tools and helpers @@ -18,6 +21,7 @@ This repository contains Agent Plugins for AWS that equip AI coding agents with - Root files: Configuration for linting (markdownlint, semgrep), security (gitleaks), and formatting (dprint) ## Development Practices + 1. **Code Quality**: Uses pre-commit hooks, semgrep for security analysis, and gitleaks for secret detection 2. **Documentation**: Comprehensive guides including DEVELOPMENT_GUIDE.md, CONTRIBUTING.md, TROUBLESHOOTING.md 3. **Testing**: Follow existing test patterns in the codebase @@ -25,6 +29,7 @@ This repository contains Agent Plugins for AWS that equip AI coding agents with 5. **Commit Signoff**: Web commit signoff required (git commit -S flag) ## Plugin Development Guidelines + - Follow the workflow pattern: Analyze → Recommend → Estimate → Generate → Deploy - MCP Servers provide: AWS documentation, pricing data, and IaC best practices - Skill triggers should be intuitive natural language phrases users would say @@ -32,6 +37,7 @@ This repository contains Agent Plugins for AWS that equip AI coding agents with - Generate infrastructure code with explanations and best practices ## Important Reminders for Copilot + 1. **AWS Best Practices**: Recommend services aligned with AWS Well-Architected Framework 2. **Cost Awareness**: Always estimate and display costs to users 3. **User Confirmation**: Never deploy without explicit user confirmation @@ -40,10 +46,12 @@ This repository contains Agent Plugins for AWS that equip AI coding agents with 6. **Documentation**: Provide clear explanations for architectural recommendations ## Key Files to Reference + - `README.md` - Project overview and installation instructions - `DEVELOPMENT_GUIDE.md` - How to create new plugins - `CONTRIBUTING.md` - Contribution guidelines - `TROUBLESHOOTING.md` - Common issues and solutions ## License -Apache-2.0 License - Ensure all contributions comply with this license \ No newline at end of file + +Apache-2.0 License - Ensure all contributions comply with this license diff --git a/.github/instructions/codeowners.instructions.md b/.github/instructions/codeowners.instructions.md index 02136f2..f5700ee 100644 --- a/.github/instructions/codeowners.instructions.md +++ b/.github/instructions/codeowners.instructions.md @@ -6,7 +6,7 @@ applyTo: ".github/CODEOWNERS" Please verify this checklist to keep the `.github/CODEOWNERS` file following all five of these rules: -1. [ ] ONLY teams are used (no users) +1. [ ] ONLY teams are used (no users) 2. [ ] Teams MUST be vertically aligned across all lines with spaces (no tabs) 3. [ ] Each section, "## section", MUST be alphabetically sorted (keep file patterns in order) 4. [ ] Admins or maintainers must be first (if both separated by one space) - others follow with two spaces From 0459c5e3d4fdaea3155b510e72e609098824775f Mon Sep 17 00:00:00 2001 From: Scott Schreckengaust Date: Wed, 11 Feb 2026 12:42:50 -0800 Subject: [PATCH 4/4] fix(pre-commit): remove trailing whitespace Signed-off-by: Scott Schreckengaust --- TROUBLESHOOTING.md | 2 +- mise.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md index 515c24c..89e9390 100644 --- a/TROUBLESHOOTING.md +++ b/TROUBLESHOOTING.md @@ -63,7 +63,7 @@ claude /plugin list # Then navigate to the "Installed" tab using your right arrow -# Check available skills +# Check available skills /skills # Check available mcp servers diff --git a/mise.toml b/mise.toml index 3add071..934d76e 100644 --- a/mise.toml +++ b/mise.toml @@ -118,4 +118,4 @@ run = [ { task = "lint" }, { task = "fmt:check" }, { task = "security"} -] \ No newline at end of file +]