Files
gcp_solution_architecture_a…/providers/gcp.yaml
Jonathan Boniface e9246828b3 feat: establish the Target architecture as a graph before code
Design is now approved before any infrastructure code is written (ADR-0005).
A new target-architect Specialist produces one graph of Elements,
Relationships and Checks; the diagram is rendered from it, deployment
guidance must account for every Check, and validation gives a verdict per
Check. Requirements, components, products and recommendations carry ids in
data files, and a submission with a gap in the Requirements chain is refused.

Also in this commit:
- Customer cases group Executions, with an intent history per case
- lesson candidates are captured when an Execution ends
- evaluation gains chain, verdict, judged and interactive checks, and
  per-case thresholds
- Terraform providers are cached between checks
- the requirements analyst proposes defaults instead of asking
- the legacy-baseline case and the checks that only read it are removed
- ADR-0006 (Change requests) accepted; ADR-0004 and ADR-0007 proposed
- plans for iterations 4 to 7 under .agents/plans/

Unproven with a real model: no evaluation run has completed on this design.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 13:59:09 +01:00

164 lines
5.5 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
# Skills each role may load. Role files stay provider-neutral; the bundle names Skills.
role_skills:
orchestrator: [google-cloud-solution-architecture]
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]
target-architect: [google-cloud-solution-architecture, requirements-chain]
describer: [google-cloud-solution-architecture]
iac-author: [google-cloud-solution-architecture, requirements-chain, iac-validation]
validator: [google-cloud-solution-architecture, requirements-chain, iac-validation]
packager: [google-cloud-solution-architecture]
# 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]
cloud_read: [terraform_plan]
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]