Solution architecture outcome pattern: agent and its MCP servers
Some checks failed
check agents / check (push) Failing after 13s

The cp1-solution-architecture-agent and the sa-aws/azure/gcp-cloud MCP servers, a separate
stream from the individual and sub-agent patterns.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-05 22:13:25 +00:00
parent 8bb62a4a42
commit bc84ee4df6
267 changed files with 44287 additions and 45 deletions

View File

@@ -0,0 +1,209 @@
# Cloud provider bundle: aws. Loaded by app/core/providers.py. Tools are on sa-aws-cloud
# (mcp-servers/), grouped as the source grouped Google's. No published Terraform modules yet.
name: aws
skills_dirs:
- skills
output_template: skills/aws-solution-architecture/assets/output-template.md
models:
default: claude-sonnet-5-5
timeout_seconds:
target-architect: 420
iac-author: 300
validator: 300
packager: 300
coverage-reviewer: 300
delivery-planner: 300
deliverables:
pillar_sections:
- Security
- Reliability
- Operational Excellence
- Cost Optimization
- Performance Efficiency
- Sustainability
iac_files:
- terraform/main.tf
- terraform/variables.tf
role_skills:
orchestrator:
- aws-solution-architecture
scope-analyst:
- scoping
requirements-analyst:
- aws-solution-architecture
- requirements-chain
- cloud-discovery
decomposer:
- aws-solution-architecture
- requirements-chain
product-selector:
- aws-solution-architecture
- requirements-chain
design-advisor:
- aws-solution-architecture
- requirements-chain
describer:
- aws-solution-architecture
target-architect:
- aws-solution-architecture
- requirements-chain
iac-author:
- aws-solution-architecture
- requirements-chain
- iac-validation
- aws-iac-patterns
validator:
- aws-solution-architecture
- requirements-chain
- iac-validation
delivery-planner:
- requirements-chain
packager:
- aws-solution-architecture
scope:
skill: scoping
values:
estate.cloud_provider:
- aws
compliance.encryption.type:
- cmk
- cloudhsm
networking.topology:
- single_vpc
- shared_vpc
- transit_gateway_hub_and_spoke
networking.hybrid_connectivity.type:
- site_to_site_vpn
- direct_connect
pillar_skills:
security: aws-waf-security
reliability: aws-waf-reliability
operational-excellence: aws-waf-operational-excellence
cost-optimization: aws-waf-cost-optimization
performance-efficiency: aws-waf-performance-efficiency
sustainability: aws-waf-sustainability
tools:
general:
- mermaid_check
- terraform_fmt
- terraform_validate
- terraform_schema
- terraform_module
cloud_read:
- terraform_plan
terraform:
required_providers:
aws:
source: hashicorp/aws
version: 6.10.0
mcp:
server: sa-aws-cloud
mcp_servers:
docs:
url: https://sts.amazonaws.com
tier: general
allow:
- aws_search_documents
- aws_get_documents
resources:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_search_projects
- aws_list_assets
iam:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_roles
- aws_list_deny_policies
- aws_get_role
- aws_get_deny_policy
- aws_analyze_access
compute:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_instances
- aws_list_instance_group_managers
- aws_list_instance_templates
- aws_list_disks
- aws_list_reservations
- aws_list_commitments
- aws_list_sql_instances
- aws_list_instance_attached_disks
- aws_get_instance_basic_info
- aws_get_instance_group_manager_basic_info
- aws_get_instance_template_properties
- aws_get_disk_basic_info
- aws_get_sql_instance
kubernetes:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_clusters
- aws_list_node_pools
- aws_get_cluster
- aws_get_node_pool
- aws_get_k8s_version
apps:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_services
- aws_list_functions
- aws_get_service
- aws_get_function
data:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_sql_instances
- aws_list_buckets
- aws_get_sql_instance
messaging:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_topics
- aws_list_subscriptions
- aws_get_topic
- aws_get_subscription
monitoring:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_alert_policies
- aws_list_dashboards
- aws_list_metric_descriptors
- aws_get_alert_policy
- aws_list_timeseries
network:
url: https://sts.amazonaws.com
tier: cloud_read
allow:
- aws_list_connectivity_tests
- aws_get_connectivity_test
role_mcp_servers:
requirements-analyst:
- resources
- compute
- kubernetes
- apps
- data
- messaging
- iam
- monitoring
product-selector:
- docs
describer:
- docs
design-advisor:
- docs
target-architect:
- docs
pillar-advisor:
- docs
validator:
- iam
- network

View File

@@ -0,0 +1,203 @@
# Cloud provider bundle: azure. Loaded by app/core/providers.py. Tools are on sa-azure-cloud
# (mcp-servers/), grouped as the source grouped Google's. No published Terraform modules yet.
name: azure
skills_dirs:
- skills
output_template: skills/azure-solution-architecture/assets/output-template.md
models:
default: claude-sonnet-5-5
timeout_seconds:
target-architect: 420
iac-author: 300
validator: 300
packager: 300
coverage-reviewer: 300
delivery-planner: 300
deliverables:
pillar_sections:
- Security
- Reliability
- Operational Excellence
- Cost Optimization
- Performance Efficiency
iac_files:
- terraform/main.tf
- terraform/variables.tf
role_skills:
orchestrator:
- azure-solution-architecture
scope-analyst:
- scoping
requirements-analyst:
- azure-solution-architecture
- requirements-chain
- cloud-discovery
decomposer:
- azure-solution-architecture
- requirements-chain
product-selector:
- azure-solution-architecture
- requirements-chain
design-advisor:
- azure-solution-architecture
- requirements-chain
describer:
- azure-solution-architecture
target-architect:
- azure-solution-architecture
- requirements-chain
iac-author:
- azure-solution-architecture
- requirements-chain
- iac-validation
- azure-iac-patterns
validator:
- azure-solution-architecture
- requirements-chain
- iac-validation
delivery-planner:
- requirements-chain
packager:
- azure-solution-architecture
scope:
skill: scoping
values:
estate.cloud_provider:
- azure
compliance.encryption.type:
- cmk
- cmk_hsm
networking.topology:
- single_vnet
- hub_and_spoke
- virtual_wan
networking.hybrid_connectivity.type:
- vpn_gateway
- expressroute
pillar_skills:
security: azure-waf-security
reliability: azure-waf-reliability
operational-excellence: azure-waf-operational-excellence
cost-optimization: azure-waf-cost-optimization
performance-efficiency: azure-waf-performance-efficiency
tools:
general:
- mermaid_check
- terraform_fmt
- terraform_validate
- terraform_schema
- terraform_module
cloud_read:
- terraform_plan
terraform:
required_providers:
azurerm:
source: hashicorp/azurerm
version: 4.40.0
mcp:
server: sa-azure-cloud
mcp_servers:
docs:
url: https://management.azure.com
tier: general
allow:
- azure_search_documents
- azure_get_documents
resources:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_search_subscriptions
- azure_list_assets
iam:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_analyze_access
- azure_list_roles
- azure_get_role
- azure_list_deny_policies
compute:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_instance_attached_disks
- azure_list_instances
- azure_list_instance_group_managers
- azure_list_instance_templates
- azure_list_disks
- azure_list_reservations
- azure_list_sql_instances
- azure_get_instance_basic_info
- azure_get_instance_group_manager_basic_info
- azure_get_instance_template_properties
- azure_get_disk_basic_info
- azure_get_sql_instance
- azure_list_commitments
kubernetes:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_node_pools
- azure_list_clusters
- azure_get_cluster
- azure_get_node_pool
- azure_get_k8s_version
apps:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_services
- azure_get_service
data:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_sql_instances
- azure_list_buckets
- azure_get_sql_instance
messaging:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_topics
- azure_get_topic
- azure_list_subscriptions
monitoring:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_alert_policies
- azure_list_dashboards
- azure_get_alert_policy
- azure_list_metric_descriptors
- azure_list_timeseries
network:
url: https://management.azure.com
tier: cloud_read
allow:
- azure_list_connectivity_tests
- azure_get_connectivity_test
role_mcp_servers:
requirements-analyst:
- resources
- compute
- kubernetes
- apps
- data
- messaging
- iam
- monitoring
product-selector:
- docs
describer:
- docs
design-advisor:
- docs
target-architect:
- docs
pillar-advisor:
- docs
validator:
- iam
- network

View File

@@ -0,0 +1,222 @@
# Cloud provider bundle: Google Cloud.
# Loaded by app/providers.py; select with CLOUD_PROVIDER=gcp. See ADR-0002.
name: gcp
skills_dirs:
- skills/vendor/google
- skills
output_template: skills/vendor/google/google-cloud-solution-architecture/assets/output-template.md
# Every role uses one model, set by LITELLM_MODEL in the agent's ConfigMap (owner decision).
models:
default: claude-sonnet-5-5
# Seconds one model request may take, for roles whose replies are long.
timeout_seconds:
target-architect: 420
iac-author: 300
validator: 300
packager: 300
coverage-reviewer: 300
delivery-planner: 300
# What this provider adds to the Deliverables (ProviderContract).
deliverables:
pillar_sections:
- Security, privacy, and compliance
- Reliability
- Operational excellence
- Cost optimization
- Performance efficiency
- Sustainability
iac_files: [terraform/main.tf, terraform/variables.tf]
# Skills each role may load. Role files stay provider-neutral; the bundle names Skills.
role_skills:
orchestrator: [google-cloud-solution-architecture]
scope-analyst: [scoping]
requirements-analyst: [google-cloud-solution-architecture, requirements-chain, cloud-discovery]
decomposer: [google-cloud-solution-architecture, requirements-chain]
product-selector: [google-cloud-solution-architecture, requirements-chain]
design-advisor: [google-cloud-solution-architecture, requirements-chain]
describer: [google-cloud-solution-architecture]
target-architect: [google-cloud-solution-architecture, requirements-chain]
iac-author: [google-cloud-solution-architecture, requirements-chain, iac-validation, google-cloud-iac-patterns]
validator: [google-cloud-solution-architecture, requirements-chain, iac-validation]
delivery-planner: [requirements-chain]
packager: [google-cloud-solution-architecture]
# Where approved lessons are published (ADR-0004). A Specialist is given this Skill
# once it holds lessons for that Specialist's Deliverable.
lessons_skill: google-cloud-lessons
# The scope spec (ADR-0008). `skill` holds its catalogue, which names no Cloud
# provider. `values` are what this provider allows for the fields the catalogue
# leaves to a provider, in this provider's own terms.
scope:
skill: scoping
values:
estate.cloud_provider: [gcp]
compliance.encryption.type: [cmek, cmek_hsm]
networking.topology: [single_vpc, shared_vpc, shared_vpc_hub_and_spoke]
networking.hybrid_connectivity.type: [cloud_vpn, cloud_interconnect, partner_interconnect]
# One advisor per architecture-framework pillar; each loads only its pillar's Skill.
pillar_skills:
security: google-cloud-waf-security
reliability: google-cloud-waf-reliability
operational-excellence: google-cloud-waf-operational-excellence
cost-optimization: google-cloud-waf-cost-optimization
performance-optimization: google-cloud-waf-performance-optimization
sustainability: google-cloud-waf-sustainability
tools:
general: [mermaid_check, terraform_fmt, terraform_validate, terraform_schema, terraform_module]
cloud_read: [terraform_plan]
# The Terraform providers generated code is written for. One exact version, so the
# schema lookup, the patterns Skill and validation all describe the same provider.
# The 2026-10-07 run left five different versions in the plugin cache.
terraform:
required_providers:
google:
source: hashicorp/google
version: 8.6.0
# Published modules. Generated code is plain resources unless an Execution opts
# into modules; then a `module` may come only from these registry namespaces, at
# one exact version. `terraform init` downloads and evaluates whatever a source
# names, so anything else is refused before Terraform runs. `skill` holds the
# modules known to work with the provider pinned above, and is given, with the
# terraform_module tool, only to an Execution that opted in.
modules:
namespaces: [terraform-google-modules]
skill: google-cloud-iac-modules
# Not usable on 2026-10-09: each required a google provider below 8. Run
# scripts/check-terraform-modules.py to see whether that has changed.
watch:
- terraform-google-modules/lb-http/google
- terraform-google-modules/pubsub/google
- terraform-google-modules/bigquery/google
- terraform-google-modules/kubernetes-engine/google
- terraform-google-modules/log-export/google
- terraform-google-modules/event-function/google
- terraform-google-modules/scheduled-function/google
- terraform-google-modules/bastion-host/google
# The agent's server for this provider (mcp-servers/), and how its tools are named. It
# forwards to the hosted servers below, which keep the source's tiers and allow lists.
mcp:
server: sa-gcp-cloud
tool_format: "gcp_{server}_{tool}"
describe_tool: gcp_describe_tool
# Remote MCP servers hosted by Google Cloud (streamable HTTP).
# `allow` lists name the only tools ever exposed. Reviewed 2026-09-16 against each
# server's live tools/list (scripts/list-mcp-tools.py): inventory and configuration
# metadata only, every tool readOnlyHint=true. Deliberately excluded even though
# read-only: data content (Cloud SQL execute_sql_readonly, Storage read_object/read_text,
# list_objects), generic Kubernetes reads that can return Secrets (get_k8s_resource,
# describe_k8s_resource), and every write. See docs/operations/mcp-access.md.
mcp_servers:
developer_knowledge:
url: https://developerknowledge.googleapis.com/mcp
tier: general # public documentation, no customer data
allow:
- search_documents
- get_documents
- answer_query
resource_manager:
url: https://cloudresourcemanager.googleapis.com/mcp
tier: cloud_read
allow:
- search_projects
asset_inventory:
url: https://cloudasset.googleapis.com/mcp
tier: cloud_read
allow:
- list_assets
- analyze_iam_policy
preview: true
compute:
url: https://compute.googleapis.com/mcp
tier: cloud_read
allow:
- list_instances
- get_instance_basic_info
- list_instance_attached_disks
- list_instance_group_managers
- get_instance_group_manager_basic_info
- list_instance_templates
- get_instance_template_properties
- list_disks
- get_disk_basic_info
- list_reservations
- list_commitments
gke:
url: https://container.googleapis.com/mcp
tier: cloud_read
allow:
- list_clusters
- get_cluster
- list_node_pools
- get_node_pool
- get_k8s_version
cloud_run:
url: https://run.googleapis.com/mcp
tier: cloud_read
allow:
- list_services
- get_service
cloud_sql:
url: https://sqladmin.googleapis.com/mcp
tier: cloud_read
allow:
- list_instances
- get_instance
storage:
url: https://storage.googleapis.com/storage/mcp
tier: cloud_read
allow:
- list_buckets
pubsub:
url: https://pubsub.googleapis.com/mcp
tier: cloud_read
allow:
- list_topics
- get_topic
- list_subscriptions
- get_subscription
iam:
url: https://iam.googleapis.com/mcp
tier: cloud_read
allow:
- list_roles
- get_role
- list_deny_policies
- get_deny_policy
monitoring:
url: https://monitoring.googleapis.com/mcp
tier: cloud_read
allow:
- list_alert_policies
- get_alert_policy
- list_dashboards
- list_metric_descriptors
- list_timeseries
network_intelligence:
url: https://networkmanagement.googleapis.com/mcp
tier: cloud_read
allow:
- list_connectivity_tests
- get_connectivity_test
preview: true
role_mcp_servers:
requirements-analyst:
[resource_manager, asset_inventory, compute, gke, cloud_run, cloud_sql, storage, pubsub, iam, monitoring]
product-selector: [developer_knowledge]
describer: [developer_knowledge]
design-advisor: [developer_knowledge]
target-architect: [developer_knowledge]
pillar-advisor: [developer_knowledge]
validator: [iam, network_intelligence]