---
name: packaging_guide
phase: package
description: 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.