Solution architecture outcome pattern: agent and its MCP servers
Some checks failed
check agents / check (push) Failing after 13s
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:
@@ -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]
|
||||
Reference in New Issue
Block a user