# 🏛️ Step 2: Architecture Assessment - {project-name}

![Step](https://img.shields.io/badge/Step-2-blue?style=for-the-badge)
![Status](https://img.shields.io/badge/Status-Draft-orange?style=for-the-badge)
![Agent](https://img.shields.io/badge/Agent-Architect-purple?style=for-the-badge)

<details open>
<summary><strong>📑 Assessment Contents</strong></summary>

- [✅ Requirements Validation](#-requirements-validation)
- [💎 Executive Summary](#-executive-summary)
- [🏛️ WAF Pillar Assessment](#-waf-pillar-assessment)
- [📦 Resource SKU Recommendations](#-resource-sku-recommendations)
- [🎯 Architecture Decision Summary](#-architecture-decision-summary)
- [🚀 Implementation Handoff](#-implementation-handoff)
- [🔒 Approval Gate](#-approval-gate)
- [References](#references)

</details>

> Generated by architect agent | {date}

| ⬅️ Previous                              | 📑 Index            | Next ➡️                                            |
| ---------------------------------------- | ------------------- | -------------------------------------------------- |
| [01-requirements.md](01-requirements.md) | [README](README.md) | [03-des-cost-estimate.md](03-des-cost-estimate.md) |

## ✅ Requirements Validation

| Requirement Area        | Status                               | Validation Notes |
| ----------------------- | ------------------------------------ | ---------------- |
| NFRs (SLA, RTO, RPO)    | ✅ Defined / ⚠️ Partial / ❌ Missing | {notes}          |
| Compliance requirements | ✅ Defined / ⚠️ Partial / ❌ Missing | {notes}          |
| Budget (approximate)    | ✅ Defined / ⚠️ Partial / ❌ Missing | {notes}          |
| Scale requirements      | ✅ Defined / ⚠️ Partial / ❌ Missing | {notes}          |
| Security controls       | ✅ Defined / ⚠️ Partial / ❌ Missing | {notes}          |
| Data residency          | ✅ Defined / ⚠️ Partial / ❌ Missing | {notes}          |

> [!WARNING]
> Any ❌ items above must be resolved before proceeding to implementation.

---

## 💎 Executive Summary

Brief narrative summary of the workload and recommended approach.

### Recommended Architecture

```mermaid
flowchart TB
    User["\U0001F464 Users"] --> FD["\U0001F6E1\uFE0F Front Door / CDN"]
    FD --> App["\U0001F4BB App Service"]
    App --> DB[("\U0001F5C4\uFE0F Database")]
    App --> KV["\U0001F511 Key Vault"]
    App --> Storage["\U0001F4E6 Storage"]
    App --> Monitor["\U0001F4CA Monitor"]

    subgraph Security
        KV
        NSG["\U0001F6E1\uFE0F NSG"]
    end

    subgraph Data
        DB
        Storage
    end
```

> Replace the above with actual architecture for the project.

---

## 🏛️ WAF Pillar Assessment

### Overall Scores

| Pillar                    | Score | Confidence       | Summary |
| ------------------------- | ----- | ---------------- | ------- |
| 🔒 Security               | /10   | High / Med / Low |         |
| 🔄 Reliability            | /10   | High / Med / Low |         |
| ⚡ Performance            | /10   | High / Med / Low |         |
| 💰 Cost Optimization      | /10   | High / Med / Low |         |
| 🔧 Operational Excellence | /10   | High / Med / Low |         |

**Primary Pillar Optimized**: {pillar}
**Trade-offs Accepted**: {trade-offs}

![WAF Pillar Scores](./02-waf-scores.png)

> Generate `02-waf-scores.png` using the pattern in `python-diagrams` skill →
> `references/waf-cost-charts.md` → **Chart 1 – WAF Pillar Scores**.
> Replace placeholder scores with the actual pillar values before running.

---

### 🔒 Security Assessment ({score}/10)

**Strengths:**

- List strengths

**Gaps:**

- List gaps

**Recommendations:**

1. Recommendation 1
2. Recommendation 2

### 🔄 Reliability Assessment ({score}/10)

**Strengths:**

- List strengths

**Gaps:**

- List gaps

**Recommendations:**

1. Recommendation 1
2. Recommendation 2

### ⚡ Performance Assessment ({score}/10)

**Strengths:**

- List strengths

**Gaps:**

- List gaps

**Recommendations:**

1. Recommendation 1
2. Recommendation 2

### 💰 Cost Assessment ({score}/10)

| Metric           | Value                              |
| ---------------- | ---------------------------------- |
| Monthly Estimate | ~${X}/month                        |
| Annual Estimate  | ~${X}/year                         |
| Budget Status    | {✅ Within budget / ⚠️ Over by $X} |
| Confidence       | {High / Medium / Low}              |

> 📎 Full cost breakdown: [03-des-cost-estimate.md](03-des-cost-estimate.md)

**Cost Optimization Applied:**

- List optimizations

### 🔧 Operational Excellence Assessment ({score}/10)

**Strengths:**

- List strengths

**Gaps:**

- List gaps

**Recommendations:**

1. Recommendation 1
2. Recommendation 2

---

## 📦 Resource SKU Recommendations

| Service   | Recommended SKU | Configuration | Monthly Est. | Justification |
| --------- | --------------- | ------------- | ------------ | ------------- |
| {service} | {sku}           | {config}      | ${amount}    | {why}         |

<details>
<summary><strong>{Service 1}</strong> — Pricing Tier Comparison</summary>

| Tier     | vCPU   | RAM    | Price/mo | Fits?        |
| -------- | ------ | ------ | -------- | ------------ |
| Basic    | {spec} | {spec} | ${price} | ❌ / ⚠️ / ✅ |
| Standard | {spec} | {spec} | ${price} | ❌ / ⚠️ / ✅ |
| Premium  | {spec} | {spec} | ${price} | ❌ / ⚠️ / ✅ |

**Selected**: {tier} — {justification}

</details>

<details>
<summary><strong>{Service 2}</strong> — Pricing Tier Comparison</summary>

| Tier     | Capacity | Price/mo | Fits?        |
| -------- | -------- | -------- | ------------ |
| Basic    | {spec}   | ${price} | ❌ / ⚠️ / ✅ |
| Standard | {spec}   | ${price} | ❌ / ⚠️ / ✅ |
| Premium  | {spec}   | ${price} | ❌ / ⚠️ / ✅ |

**Selected**: {tier} — {justification}

</details>

---

## 🎯 Architecture Decision Summary

| Decision   | Choice | Rationale |
| ---------- | ------ | --------- |
| Decision 1 |        |           |
| Decision 2 |        |           |

### Top Architecture Risks

| Risk   | WAF Pillar               | Likelihood                  | Impact                      | Mitigation   |
| ------ | ------------------------ | --------------------------- | --------------------------- | ------------ |
| {risk} | {🔒 / 🔄 / ⚡ / 💰 / 🔧} | {🔴 High / 🟡 Med / 🟢 Low} | {🔴 High / 🟡 Med / 🟢 Low} | {mitigation} |

> Limit to the top 5 architecture-level risks. Pillar-specific gaps remain in the WAF assessment above.

---

## 🚀 Implementation Handoff

### Ready for iac-planner

The architecture is approved for implementation with the following key parameters:

| Parameter      | Value                                  |
| -------------- | -------------------------------------- |
| Region         | {region}                               |
| Environment    | {env}                                  |
| Budget         | ${budget}/month (estimated: ${actual}) |
| Resource Count | {count}                                |

### Resources to Provision

| #   | Resource   | SKU   | Key Config |
| --- | ---------- | ----- | ---------- |
| 1   | {resource} | {sku} | {config}   |
| 2   | {resource} | {sku} | {config}   |

### Security Requirements for Implementation

| Requirement        | Implementation              |
| ------------------ | --------------------------- |
| {security feature} | {how to implement in Bicep} |

### Monitoring Requirements for Implementation

| Requirement          | Implementation              |
| -------------------- | --------------------------- |
| {monitoring feature} | {how to implement in Bicep} |

---

## 🔒 Approval Gate

> [!IMPORTANT]
> **🏗️ Architecture Assessment Complete**
>
> | Pillar      | Score |
> | ----------- | ----- |
> | Security    | X/10  |
> | Reliability | X/10  |
> | Performance | X/10  |
> | Cost        | X/10  |
> | Operations  | X/10  |
>
> **Estimated Monthly Cost**: ~$X ({within budget / over budget by $Y})
>
> **Confidence Level**: {High / Medium / Low}
>
> - [ ] **Approved** — proceed to iac-planner
> - Approver: {name}
> - Date: {date}
>
> Reply **"approve"** to proceed to iac-planner, or provide feedback for revisions.

---

## References

> [!NOTE]
> 📚 The following Microsoft Learn resources informed this assessment.

| Topic                      | Link                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------- |
| Well-Architected Framework | [Overview](https://learn.microsoft.com/azure/well-architected/)                             |
| Security Checklist         | [WAF Security](https://learn.microsoft.com/azure/well-architected/security/checklist)       |
| Reliability Checklist      | [WAF Reliability](https://learn.microsoft.com/azure/well-architected/reliability/checklist) |
| Cost Optimization          | [WAF Cost](https://learn.microsoft.com/azure/well-architected/cost-optimization/checklist)  |
| Azure Pricing Calculator   | [Calculator](https://azure.microsoft.com/pricing/calculator/)                               |

---

_Assessment performed using Azure Well-Architected Framework. Pricing data from Azure Pricing MCP ({date})._

---

<div align="center">

| ⬅️ [01-requirements.md](01-requirements.md) | 🏠 [Project Index](README.md) | ➡️ [03-des-cost-estimate.md](03-des-cost-estimate.md) |
| ------------------------------------------- | ----------------------------- | ----------------------------------------------------- |

</div>
