Files
Jonathan Boniface bc84ee4df6
Some checks failed
check agents / check (push) Failing after 13s
Solution architecture outcome pattern: agent and its MCP servers
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>
2026-11-05 22:13:25 +00:00

223 lines
7.9 KiB
YAML

# 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]