gcp_solution_architecture_agent/app/skills/architecture_design/SKILL.md

name, phase, description

name	phase	description
architecture_design	design	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.