feat: add content source validation tracking system

- Add content-validation-status.md to track MSLearn source coverage
- Add Content Source Requirements section to AGENTS.md
- Enforce MSLearn-first policy for all platform content and diagrams
- Track 89 mermaid diagrams requiring source validation

Author: yeongseon

AGENTS.md

@@ -106,6 +106,46 @@ For MkDocs admonitions (`!!!` / `???`), every line in the body must be indented
 
 All architectural diagrams use Mermaid. Every documentation page should include at least one diagram. Test with `mkdocs build --strict`.
 
+## Content Source Requirements
+
+### MSLearn-First Policy
+
+All content MUST be traceable to official Microsoft Learn documentation:
+
+- **Platform content** (`docs/platform/`): MUST have direct Microsoft Learn source URLs
+- **Architecture diagrams**: MUST reference official Microsoft documentation
+- **Troubleshooting playbooks**: MAY synthesize Microsoft Learn content with clear attribution
+- **Self-generated content**: MUST have justification explaining the source basis
+
+### Source Types
+
+| Type | Description | Allowed? |
+|---|---|---|
+| `mslearn` | Directly from Microsoft Learn | Required for platform content |
+| `mslearn-adapted` | Microsoft Learn content adapted for this guide | Allowed with source URL |
+| `self-generated` | Original content for this guide | Requires justification |
+| `community` | From community sources | Not for core content |
+| `unknown` | Source not documented | Must be validated |
+
+### Diagram Source Documentation
+
+Every Mermaid diagram MUST have source metadata in frontmatter:
+
+```yaml
+content_sources:
+  diagrams:
+    - id: architecture-overview
+      type: flowchart
+      source: mslearn
+      mslearn_url: https://learn.microsoft.com/en-us/azure/storage/
+    - id: troubleshooting-flow
+      type: flowchart
+      source: self-generated
+      justification: "Synthesized from Microsoft Learn articles"
+      based_on:
+        - https://learn.microsoft.com/en-us/azure/storage/
+```
+
 ### Nested List Indentation
 
 All nested list items MUST use **4-space indent** (Python-Markdown standard).

docs/reference/content-validation-status.md

@@ -0,0 +1,108 @@
+# Content Source Validation Status
+
+This page tracks the source validation status of documentation content, including diagrams and text. All content must be traceable to official Microsoft Learn documentation.
+
+## Summary
+
+*Generated: 2026-04-10*
+
+| Content Type | Total | MS Learn Sourced | Self-Generated | No Source |
+|---|---:|---:|---:|---:|
+| Mermaid Diagrams | 89 | 0 | 0 | 89 |
+| Text Sections | — | — | — | — |
+
+!!! warning "Validation Required"
+    All 89 mermaid diagrams require source validation. Content without Microsoft Learn sources must be either:
+    
+    1. Linked to an official Microsoft Learn URL, or
+    2. Marked as `self-generated` with clear justification
+
+```mermaid
+pie title Content Source Status
+    "Not Validated" : 89
+```
+
+## Validation Categories
+
+### Source Types
+
+| Type | Description | Allowed? |
+|---|---|---|
+| `mslearn` | Content directly from Microsoft Learn | Yes |
+| `mslearn-adapted` | Microsoft Learn content adapted for this guide | Yes, with source URL |
+| `self-generated` | Original content created for this guide | Requires justification |
+| `community` | From community sources | Not for core content |
+| `unknown` | Source not documented | Must be validated |
+
+### Diagram Validation Status
+
+All mermaid diagrams are currently marked as not validated.
+
+## How to Validate Content
+
+### Step 1: Add Source Metadata to Frontmatter
+
+Add `content_sources` to the document's YAML frontmatter:
+
+```yaml
+---
+title: Example Page
+content_sources:
+  diagrams:
+    - id: architecture-overview
+      type: flowchart
+      source: mslearn
+      mslearn_url: https://learn.microsoft.com/en-us/azure/storage/
+    - id: request-flow
+      type: sequence
+      source: self-generated
+      justification: "Synthesized from multiple Microsoft Learn articles for clarity"
+      based_on:
+        - https://learn.microsoft.com/en-us/azure/storage/
+  text:
+    - section: "## Summary"
+      source: mslearn-adapted
+      mslearn_url: https://learn.microsoft.com/en-us/azure/storage/
+---
+```
+
+### Step 2: Mark Diagram Blocks with IDs
+
+Add an HTML comment before each mermaid block to identify it:
+
+```markdown
+<!-- diagram-id: architecture-overview -->
+```mermaid
+flowchart TD
+    A[Client] --> B[Azure Storage]
+```
+```
+
+### Step 3: Run Validation Script
+
+```bash
+python3 scripts/validate_content_sources.py
+```
+
+### Step 4: Update This Page
+
+```bash
+python3 scripts/generate_content_validation_status.py
+```
+
+## Validation Rules
+
+!!! danger "Mandatory Rules"
+    1. Platform diagrams (`docs/platform/`) must have Microsoft Learn sources
+    2. Architecture diagrams must reference official Microsoft documentation
+    3. Troubleshooting flowcharts may be self-generated if they synthesize Microsoft Learn content
+    4. Self-generated content must have a `justification` field explaining the source basis
+
+## See Also
+
+- [Validation Status](validation-status.md)
+- [Reference Index](index.md)
+
+## Sources
+
+- [Microsoft Learn: Azure Storage documentation](https://learn.microsoft.com/en-us/azure/storage/)

mkdocs.yml

@@ -166,6 +166,7 @@ nav:
         - SAS and Token Issues: troubleshooting/playbooks/security/sas-and-token-issues.md
   - Reference:
     - reference/index.md
+    - Content Validation: reference/content-validation-status.md
     - Validation Status: reference/validation-status.md
     - Storage Service Selection Guide: reference/storage-service-selection-guide.md
     - Redundancy Options: reference/redundancy-options.md