---
name: architecture_design
phase: design
description: Guidance for GCP product selection, architecture design markdown, Mermaid diagrams, and Terraform IaC generation.
---

# Phase 1: Architecture Design & Product Selection Skill

When designing a Google Cloud Solution Architecture based on `docs/requirements.md`:

1. **Resolve Deferred Product Choices**: Select Google Cloud managed services suited for regional high availability and scale:
   - Compute: Cloud Run / Cloud Functions / GKE.
   - Messaging & Ingestion: Pub/Sub, Eventarc, or Cloud Tasks.
   - State & Storage: Cloud Storage, Firestore, Cloud SQL, or Spanner.
   - Identity & Security: Cloud IAM, Secret Manager, KMS, Artifact Registry.
2. **Architecture Documentation (`docs/architecture.md`)**:
   - Provide executive summary, component responsibilities, data flow, security model, and cost model.
3. **Mermaid Diagram (`architecture.mmd`)**:
   - Render clean, valid Mermaid syntax (`graph TD` or `flowchart TD`) mapping client ingress, compute, messaging, and storage components.
4. **Terraform Infrastructure as Code (`terraform/`)**:
   - Produce valid Terraform HCL files (`main.tf`, `variables.tf`, `outputs.tf`, `versions.tf`).
   - Ensure planability without credentials or resource provisioning during validation.