Increment 6 of .scratch/solution-architect-agent/spec.md, test-first. - app/tools/mcp.py: MCP client and catalog exposing only allowlisted, readOnlyHint tools as framework-neutral ToolSpecs; unreachable servers and failed calls become discovery gaps; ADC auth with quota project. - app/tools/local.py: Mermaid structure check and Terraform fmt, validate and plan in a scratch copy; apply is never constructed. - Tool factory gives roles their named local tools and bundle MCP servers; pillar advisors get general-tier documentation tools. - providers/gcp.yaml: 42 allowlisted tools reviewed against live tools/list of 12 Google Cloud MCP servers (snapshot in providers/reviews/), excluding data-reading and secret-capable tools. - scripts/list-mcp-tools.py, docs/operations/mcp-access.md (IAM deny policy, service account roles), cloud-discovery and iac-validation Skills, MCP and Terraform settings, pytest asyncio auto mode. - 31 new tests; full suite 189 passed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
name, description, metadata
| name | description | metadata | ||
|---|---|---|---|---|
| cloud-discovery | Discovers and documents the current state of a workload's existing cloud environment through the Cloud provider's read-only MCP discovery tools. Use when requirements discovery needs the as-is architecture of resources that already run in the user's cloud project or account. |
|
Cloud discovery
Describe what actually exists, so requirements rest on facts rather than recollection.
Before you discover
Your discovery tools read the user's live cloud environment. The first call may pause the Execution to ask the user's permission. When permission is refused, work only from what the user tells you.
Ask the user which project, subscription or account and which regions hold the workload, unless the request already says. Discover only there.
Steps
- Inventory first. Use the broadest inventory tool available (an asset inventory or project search) to list the resource types and counts in scope.
- Detail what matters. For each resource type that belongs to the workload, call the product's list and get tools for configuration: sizes, regions and zones, scaling, networking, identities and their roles.
- Map relationships. Connect compute to its data stores, messaging, load balancers and identities, from configuration you have read, not from names alone.
- Record gaps. When a tool reports a discovery gap (a server that's unavailable, an API that isn't enabled, a permission that's missing), list it under
Assumptions / discovery gapswith the resource type it leaves unknown.
Writing the current state
Under the Current state heading, give:
- a component inventory table: component, resource type, location, key configuration
- the relationships between components as a short list
- observed operational signals, such as alert policies and dashboards, when discovered
Assumptions / discovery gaps
Report what exists, not what should change; recommendations belong to later Deliverables. Never include secrets, credentials, object contents or database rows, even when a tool returns them.