Files
gcp_solution_architecture_a…/app/skills/packaging_guide/SKILL.md
Jonathan Boniface a24a44e28c
Some checks failed
validation / verify (push) Failing after 10s
refactored: to utilise the google adk and production grade agent
2026-09-02 21:42:10 +01:00

2.3 KiB

name, phase, description
name phase description
packaging_guide package Guidance for assembling the comprehensive solution-architecture-guide.md following Google's official 8-section output template.

Phase 3: Solution Packaging Skill

When producing solution-architecture-guide.md, follow Google's official 8-section solution architecture output template:

  1. Executive summary and workload overview
    • High-level business goals, workload description, and proposed solution architecture summary.
  2. Requirements and current state
    • 2.1. Functional requirements: Business processes, key activities, and use cases.
    • 2.2. Non-functional requirements: Security, reliability, cost, operations, performance, and sustainability requirements.
    • 2.3. Current state: Existing As-Is architecture, pain points, and migration drivers.
    • 2.4. Dependencies: Internal and external system dependencies.
  3. Technical decomposition of the workload
    • Layered breakdown of application tiers and logical components.
  4. Proposed solution architecture
    • 4.1. Google Cloud products and features mapping: Selected products mapping table with justifications, doc citations, and alternatives considered.
    • 4.2. Architecture diagram: Embedded Mermaid diagrams for As-Is (Before) and Target Google Cloud (After) architecture.
    • 4.3. Architecture description: Data flow and task/control flow between components.
  5. Design and configuration recommendations (Architecture Framework Pillars)
    • 5.1 Security, privacy, and compliance (IAM, encryption, network security)
    • 5.2 Reliability (Redundancy, disaster recovery, RTO/RPO)
    • 5.3 Operational excellence (Monitoring, logging, IaC)
    • 5.4 Cost optimization (Sizing, autoscaling, pricing models)
    • 5.5 Performance efficiency (Caching, database & query optimization)
    • 5.6 Sustainability (Resource efficiency, serverless adoption)
  6. Deployment guidance
    • 6.1. Deployment prerequisites: Required GCP APIs, SDK tools, and permissions.
    • 6.2. Step-by-step deployment instructions: Complete Terraform IaC blueprint (terraform/main.tf) and CLI execution runbook.
  7. Validation plan
    • Pre-deployment validation results, dry-run checks, and Verification Checklist.
  8. References
    • Citations and documentation links grounded by Google Developer Knowledge MCP.