{"slug": "well-architected-skills-and-steering-for-ai-coding-agents", "title": "Well-Architected Skills and Steering for AI Coding Agents", "summary": "AWS has released an open-source project that embeds Well-Architected Framework best practices directly into AI coding agents across 12 development tools including Claude Code, Cursor, and GitHub Copilot. The project provides reusable skills and steering files that run locally without AWS credentials, enabling continuous architecture guidance during code writing rather than separate review gates. The initiative aims to reduce rework by catching misalignments early, as developers increasingly rely on AI assistants instead of consulting documentation.", "body_md": "Reusable skills and steering that teach AI coding agents how to apply the [AWS Well-Architected Framework](https://docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html). One set of playbooks, **12 supported tools**.\n\n**Kiro** · **Claude Code** · **Cursor** · **Codex** · **Windsurf** · **GitHub Copilot** · **Gemini CLI** · **Antigravity** · **Junie** · **Amp** · **Cline** · **AWS DevOps Agent**\n\nImportant\n\nThis sample is provided for educational and demonstrative purposes. It is not intended for production use without additional review and testing appropriate to your environment.\n\nDevelopers don't stop to consult documentation — they ask their AI assistant. If the assistant doesn't know the Well-Architected Framework, the guidance never reaches the code.\n\nThis project embeds WA best practices **where development actually happens**: in the IDE, at the moment code is being written. Instead of treating architecture reviews as a separate gate, teams get continuous, contextual guidance that:\n\n- ✅ Reduces rework by catching misalignments early\n- ✅ Works across 12 AI coding tools with a single source of truth\n- ✅ Requires no AWS credentials, no API calls — everything runs locally\n- ✅ Follows the open\n[Agent Skills specification](https://agentskills.io/)\n\n```\nsteering/                           Always-on context (Kiro)\n  well-architected.md                 Pillars, design principles, review process\n\nskills/                             Step-by-step playbooks (tool-agnostic)\n  wa-review/                          Full review across all 6 pillars\n  security-assessment/                IAM, detection, data protection, incident response\n  reliability-improvement-plan/       SPOFs, recovery, scaling, change management\n  cost-optimization-audit/            Waste, right-sizing, pricing models\n  performance-efficiency/             Resource selection, scaling, caching\n  sustainability-optimization/        Utilization, managed services, data lifecycle\n  operational-excellence/             CI/CD, observability, incidents, automation\n  migration-readiness/                7 Rs assessment with migration plan\n  architecture-decision-record/       WA-aligned ADRs with pillar impact\n\nassets/                             Shared reference material\n  v13/                                307 WA Framework best practices (by ID)\n  well-architected-best-practices.md  Per-pillar investigation checklists\n  cloudwatch-metrics-reference.md     Metric thresholds + composite alarm patterns\n  incident-investigation-patterns.md  Triage, RCA, mitigation playbooks\n  skill-authoring-guide.md            DevOps Agent skill authoring guide\n\nadapters/                           Tool-specific configuration\n  claude-code/                        CLAUDE.md + slash commands\n  cursor/                             .cursor/rules/*.md\n  codex/                              AGENTS.md\n  windsurf/                           .windsurfrules\n  github-copilot/                     .github/copilot-instructions.md\n  cline/                              .clinerules\n  gemini-cli/                         GEMINI.md\n  antigravity/                        .agents/rules/*.md\n  junie/                              .junie/guidelines + .junie/skills\n  amp/                                .agents/skills/*.md\n  devops-agent/                       Packaging for AWS DevOps Agent\n\ninstall.sh                          One-command setup (macOS/Linux)\ninstall.ps1                         One-command setup (Windows PowerShell)\n# Install for a specific tool\n./install.sh ~/my-project --tool claude-code\n./install.sh ~/my-project --tool cursor\n./install.sh ~/my-project --tool kiro\n\n# Install for multiple tools at once\n./install.sh ~/my-project --tool kiro --tool claude-code --tool cursor\n\n# Install for all supported tools\n./install.sh ~/my-project --tool all\n\n# Use symlinks for automatic updates\n./install.sh ~/my-project --tool claude-code --symlink\n\n# Install globally (applies to all projects)\n./install.sh --global --tool claude-code\n```\n\nRun `./install.sh --help`\n\nfor full usage.\n\n**Windows (PowerShell):**\n\n```\n.\\install.ps1 -TargetDir C:\\Projects\\my-app -Tool claude-code\n.\\install.ps1 -Tool all -Force\n```\n\nTip\n\nUse `--symlink`\n\n(bash) or `-Symlink`\n\n(PowerShell) to create symbolic links instead of copies. When this repo updates, your project gets the changes automatically without reinstalling. On Windows, symlinks require elevated permissions.\n\nNote\n\n**Global installs** place files in your home directory (`~/CLAUDE.md`\n\n, `~/.kiro/`\n\n, `~/.cursor/`\n\n, etc.) and apply to all projects without their own config. Use project-level installation (the default) if you only want WA guidance for specific projects.\n\n**Existing files** — the installer prompts before overwriting. Use `--force`\n\nto skip confirmation.\n\n**🔹 Kiro**\n\n```\nmkdir -p .kiro/steering .kiro/skills\ncp path/to/this-repo/steering/well-architected.md .kiro/steering/\ncp -r path/to/this-repo/skills/* .kiro/skills/\n```\n\n**🔹 Claude Code**\n\n```\ncp path/to/this-repo/adapters/claude-code/CLAUDE.md ./CLAUDE.md\ncp -r path/to/this-repo/adapters/claude-code/commands .claude/commands\n```\n\n**🔹 Cursor**\n\n```\ncp -r path/to/this-repo/adapters/cursor/rules .cursor/rules\n```\n\n**🔹 Codex (OpenAI)**\n\n```\ncp path/to/this-repo/adapters/codex/AGENTS.md ./AGENTS.md\ncp -r path/to/this-repo/skills ./skills\n```\n\n**🔹 Windsurf**\n\n```\ncp path/to/this-repo/adapters/windsurf/.windsurfrules ./.windsurfrules\n```\n\n**🔹 GitHub Copilot**\n\n```\nmkdir -p .github\ncp path/to/this-repo/adapters/github-copilot/.github/copilot-instructions.md .github/\n```\n\n**🔹 Gemini CLI**\n\n```\ncp path/to/this-repo/adapters/gemini-cli/GEMINI.md ./GEMINI.md\ncp -r path/to/this-repo/skills ./skills\n```\n\n**🔹 Antigravity**\n\n```\nmkdir -p .agents/rules .agents/skills\ncp -r path/to/this-repo/adapters/antigravity/rules/* .agents/rules/\nfor skill_dir in path/to/this-repo/skills/*/; do\n  skill_name=$(basename \"$skill_dir\")\n  mkdir -p \".agents/skills/$skill_name\"\n  cp \"$skill_dir/SKILL.md\" \".agents/skills/$skill_name/SKILL.md\"\ndone\n```\n\n**🔹 Junie (JetBrains)**\n\n```\nmkdir -p .junie/guidelines .junie/skills\ncp path/to/this-repo/adapters/junie/guidelines.md .junie/guidelines/well-architected.md\ncp -r path/to/this-repo/skills/* .junie/skills/\n```\n\n**🔹 Amp**\n\n```\ncp path/to/this-repo/adapters/amp/AGENTS.md ./AGENTS.md\nmkdir -p .agents/skills\ncp -r path/to/this-repo/skills/* .agents/skills/\n```\n\n**🔹 Cline**\n\n```\ncp path/to/this-repo/adapters/cline/.clinerules ./.clinerules\n```\n\n**🔹 AWS DevOps Agent**\n\n```\n# Package all skills as zip files for upload to your Agent Space\n./install.sh ~/output-dir --tool devops-agent\n# Then upload each .zip from ~/output-dir/devops-agent-skills/ via the Operator Web App\nphp\ngraph LR\n    S[skills/] --> A[adapters/]\n    ST[steering/] --> A\n    A --> K[Kiro]\n    A --> CC[Claude Code]\n    A --> CU[Cursor]\n    A --> CO[Codex]\n    A --> W[Windsurf]\n    A --> GH[GitHub Copilot]\n    A --> G[Gemini CLI]\n    A --> AG[Antigravity]\n    A --> J[Junie]\n    A --> AM[Amp]\n    A --> CL[Cline]\n    A --> DA[DevOps Agent]\n```\n\n| Component | What it does |\n|---|---|\nSkills (`skills/*/SKILL.md` ) |\nSelf-contained, tool-agnostic playbooks. Any AI agent can follow them step-by-step. They don't depend on steering or on each other. |\nSteering (`steering/*.md` ) |\nAlways-on context loaded into every Kiro conversation. Other tools use equivalent mechanisms via adapters. |\nAdapters (`adapters/` ) |\nTranslate steering into each tool's native config format and wire up skills as commands or rules. |\nAssets (`assets/` ) |\nShared reference material (v13 best practices, metrics, patterns) bundled with skills for tools that support it. |\n\n| Tool | Steering mechanism | Skills mechanism |\n|---|---|---|\n| Kiro | `.kiro/steering/*.md` |\n`.kiro/skills/*/SKILL.md` |\n| Claude Code | `CLAUDE.md` |\n`.claude/commands/*.md` (slash commands) |\n| Cursor | `.cursor/rules/*.md` |\nRules with conditional activation |\n| Codex | `AGENTS.md` |\nReferences `skills/` directory |\n| Windsurf | `.windsurfrules` |\nReferences `skills/` directory |\n| GitHub Copilot | `.github/copilot-instructions.md` |\nInline (no separate skill mechanism) |\n| Cline | `.clinerules` |\nReferences `skills/` directory |\n| Gemini CLI | `GEMINI.md` |\nReferences `skills/` directory |\n| Antigravity | `.agents/rules/*.md` |\n`.agents/skills/*/SKILL.md` |\n| Junie | `.junie/guidelines/*.md` |\n`.junie/skills/*/SKILL.md` |\n| Amp | `AGENTS.md` |\n`.agents/skills/*/SKILL.md` |\n| AWS DevOps Agent | N/A (skills are self-contained) | `SKILL.md` zip upload to Agent Space |\n\n| Skill | Pillar(s) | Use when you need to... |\n|---|---|---|\n`wa-review` |\nAll 6 | Run a full Well-Architected review |\n`security-assessment` |\n🔒 Security | Assess IAM, detection, data protection, incident response |\n`reliability-improvement-plan` |\n🔄 Reliability | Find and eliminate single points of failure |\n`cost-optimization-audit` |\n💰 Cost Optimization | Identify waste and right-sizing opportunities |\n`performance-efficiency` |\n⚡ Performance Efficiency | Evaluate resource selection, scaling, and caching |\n`sustainability-optimization` |\n🌱 Sustainability | Reduce carbon footprint and resource waste |\n`operational-excellence` |\n🛠️ Operational Excellence | Assess CI/CD, observability, incident management |\n`migration-readiness` |\nAll 6 | Assess readiness to migrate a workload to AWS |\n`architecture-decision-record` |\nAll 6 | Document a design decision with WA pillar impact |\n\nAsk your AI coding agent:\n\n```\nWhat Well-Architected pillars should I consider for this architecture?\n```\n\nIf configured correctly, it will reference all six pillars with specific guidance rather than giving a generic answer.\n\nTip\n\n**Claude Code users**: try `/wa-review`\n\nto invoke the full review skill as a slash command.\n\n**Kiro users**: the steering loads automatically — just start discussing architecture and the agent applies WA principles.\n\nWe welcome contributions from the community and internal teams alike! See [CONTRIBUTING.md](/aws-samples/sample-well-architected-skills-and-steering/blob/main/CONTRIBUTING.md) for guidelines on adding skills, modifying steering files, or adding new tool adapters.\n\nNote\n\nThis is a community-driven project. Anyone can collaborate and improve the skills and steering docs through Pull Requests. Adapt them to your domain, add new patterns, and share back.\n\nSee [CONTRIBUTING](/aws-samples/sample-well-architected-skills-and-steering/blob/main/CONTRIBUTING.md#security-issue-notifications) for more information.\n\nThis project is licensed under the [MIT-0 License](/aws-samples/sample-well-architected-skills-and-steering/blob/main/LICENSE).", "url": "https://wpnews.pro/news/well-architected-skills-and-steering-for-ai-coding-agents", "canonical_source": "https://github.com/aws-samples/sample-well-architected-skills-and-steering", "published_at": "2026-05-26 12:12:27+00:00", "updated_at": "2026-05-26 12:38:35.935493+00:00", "lang": "en", "topics": ["ai-tools", "ai-agents", "ai-infrastructure"], "entities": ["AWS", "Kiro", "Claude Code", "Cursor", "Codex", "Windsurf", "GitHub Copilot", "Gemini CLI"], "alternates": {"html": "https://wpnews.pro/news/well-architected-skills-and-steering-for-ai-coding-agents", "markdown": "https://wpnews.pro/news/well-architected-skills-and-steering-for-ai-coding-agents.md", "text": "https://wpnews.pro/news/well-architected-skills-and-steering-for-ai-coding-agents.txt", "jsonld": "https://wpnews.pro/news/well-architected-skills-and-steering-for-ai-coding-agents.jsonld"}}