Files
Jonathan Boniface c84dbdea20 feat: the solution architecture agent on the shared Execution engine
The reference agent's subject, cloud solution architecture, as an agent in
the operating model agent's pattern: the Execution engine (from
orchestration_engine) and one Workflow in app/solution_architecture,
built for the settings and provider bundle by assembly.workflow_for.

Copied from gcp_solution_architecture_agent at 8b397cd without its own
engine: its role files, Skills, provider bundle, ADRs, vocabulary, scripts
and evaluation datasets. The image takes the engine from a named build
context and installs Terraform. It is called through the Orchestration
engine, and its files are what the operating model agent digests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 19:49:28 +01:00

231 lines
8.8 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
# Model ids: gemini/<model> runs on ADK's native Gemini client (Vertex AI or the Gemini
# API, chosen by environment); any other LiteLLM id runs through LiteLLM. Explicit
# versions, because -latest aliases are not served on Vertex AI (checked 2026-09-16).
# Reasoning-heavy roles use Pro; drafting and per-pillar advice use Flash.
models:
default: gemini/gemini-3.8-flash
roles:
orchestrator: gemini/gemini-3.1-pro-preview
product-selector: gemini/gemini-3.1-pro-preview
design-advisor: gemini/gemini-3.1-pro-preview
target-architect: gemini/gemini-3.1-pro-preview
iac-author: gemini/gemini-3.1-pro-preview
validator: gemini/gemini-3.1-pro-preview
lesson-curator: gemini/gemini-3.1-pro-preview
# The same reading the validator makes of a design's coverage, made earlier.
coverage-reviewer: gemini/gemini-3.1-pro-preview
# Dividing and estimating the build is judgement about the whole design.
delivery-planner: gemini/gemini-3.1-pro-preview
# A lighter model for a role's first attempt, used when MODEL_TIERS is on. Only a
# role whose work is checked by something else belongs here: the code is checked
# by terraform validate and by the validator. The validator is the check, and a
# weaker one that passes everything would look like an improvement.
first_attempt:
iac-author: gemini/gemini-3.8-flash
# Seconds one model request may take, for roles whose replies are long. Other
# roles get MODEL_TIMEOUT_SECONDS. The target architect timed out at 180 s in both
# attempts of the 2026-10-07 run.
timeout_seconds:
target-architect: 420
iac-author: 300
validator: 300 # timed out five times at 180 s in a run of 2026-10-07
packager: 300
coverage-reviewer: 300
delivery-planner: 300
# 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
mcp_auth:
kind: google_adc # Application Default Credentials bearer token; sends X-Goog-User-Project
# 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]