diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index ba05da1b..c1892df6 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -23,6 +23,7 @@ repos:
       - id: trailing-whitespace
       - id: end-of-file-fixer
       - id: check-yaml
+        exclude: mkdocs.yml  # Uses Python tags (!!python/name) unsupported by basic YAML checker
       - id: check-added-large-files
         args: ['--maxkb=1000']
       - id: check-json
diff --git a/docs/frontend/shared/jinja-macros.md b/docs/frontend/shared/jinja-macros.md
index 556dfabc..68988a3c 100644
--- a/docs/frontend/shared/jinja-macros.md
+++ b/docs/frontend/shared/jinja-macros.md
@@ -1045,7 +1045,7 @@ For complex detail views (job details, log entries, etc.), use inline modals wit
 </div>
 ```
 
-See the [Components Library](/admin/components#modals) for live examples.
+See the Components Library (Admin > Components > Modals) for live examples.
 
 ---
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 2a1adadd..836fad18 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -52,6 +52,15 @@ nav:
       - API Consolidation:
         - Proposal: architecture/api-consolidation-proposal.md
         - Migration Status: architecture/api-migration-status.md
+      - Audit Provider Pattern: architecture/audit-provider-pattern.md
+      - Cross-Module Import Rules: architecture/cross-module-import-rules.md
+      - Customer Orders Architecture: architecture/customer-orders-architecture.md
+      - Frontend Detection: architecture/frontend-detection.md
+      - Media Architecture: architecture/media-architecture.md
+      - Metrics Provider Pattern: architecture/metrics-provider-pattern.md
+      - Multi-Platform CMS: architecture/multi-platform-cms.md
+      - Tenancy Module Migration: architecture/tenancy-module-migration.md
+      - Widget Provider Pattern: architecture/widget-provider-pattern.md
       - Architecture Violations Status: architecture/architecture-violations-status.md
       - Diagrams:
         - Multi-Tenant Diagrams: architecture/diagrams/multitenant-diagrams.md
@@ -147,6 +156,10 @@ nav:
         - Troubleshooting: development/troubleshooting.md
       - Synology Repo: development/synology-github-repo.md
 
+    # --- Modules ---
+    - Modules:
+      - Loyalty: modules/loyalty.md
+
     # --- Migrations & Implementation ---
     - Migrations:
       - Database Migrations: development/migration/database-migrations.md
@@ -158,6 +171,7 @@ nav:
       - Multi-Marketplace Product Architecture: development/migration/multi-marketplace-product-architecture.md
       - Product Migration Database Changes: development/migration/product-migration-database-changes.md
       - Store Operations Expansion: development/migration/store-operations-expansion.md
+      - Module Autodiscovery: development/migration/module-autodiscovery-migration.md
 
     - Implementation Plans:
       - Module Migration Plan: archive/module-migration-plan.md
@@ -186,6 +200,9 @@ nav:
       - Test Maintenance: testing/test-maintenance.md
       - Test Structure: testing/test-structure.md
       - Store API Testing: testing/store-api-testing.md
+      - Admin Frontend Features: testing/admin-frontend-features.md
+      - Shop Frontend Features: testing/shop-frontend-features.md
+      - Store Frontend Features: testing/store-frontend-features.md
 
     # --- Deployment & Operations ---
     - Deployment:
@@ -206,6 +223,32 @@ nav:
       - Capacity Monitoring: operations/capacity-monitoring.md
       - Image Storage: operations/image-storage.md
 
+    # --- Proposals ---
+    - Proposals:
+      - Documentation Consolidation: proposals/PLAN_documentation-consolidation.md
+      - Module Dependency Redesign: proposals/SESSION_NOTE_2026-02-03_module-dependency-redesign.md
+      - Import-002 Cross-Module Deps: proposals/SESSION_NOTE_2026-02-09_import002-cross-module-deps.md
+      - Decouple Modules: proposals/decouple-modules.md
+      - Decouple Modules Implementation: proposals/decouple-modules-implementation-plan.md
+      - Loyalty Phase 2 Interfaces: proposals/loyalty-phase2-interfaces-plan.md
+      - Loyalty Program Analysis: proposals/loyalty-program-analysis.md
+      - Permissions Plan: proposals/plan-perms.md
+
+    # --- Archive ---
+    - Archive:
+      - Storefront Module Restructure: archive/PLAN_storefront-module-restructure.md
+      - "Session: Modular Platform Architecture": archive/SESSION_NOTE_2026-01-25_modular-platform-architecture.md
+      - "Session: Self-Contained Modules": archive/SESSION_NOTE_2026-01-26_self-contained-modules.md
+      - "Session: Module Reclassification": archive/SESSION_NOTE_2026-01-27_module-reclassification.md
+      - "Session: Module Config Migrations": archive/SESSION_NOTE_2026-01-28_module-config-migrations.md
+      - "Session: Self-Contained Module Routes": archive/SESSION_NOTE_2026-01-30_self-contained-module-routes.md
+      - "Session: Tenancy Module Consolidation": archive/SESSION_NOTE_2026-01-31_tenancy-module-consolidation.md
+      - "Session: Middleware Frontend Detection": archive/SESSION_NOTE_2026-02-02_middleware-frontend-detection.md
+      - Humble Orbiting Otter: archive/humble-orbiting-otter.md
+      - Multi-Platform CMS Architecture: archive/multi-platform-cms-architecture.md
+      - Multi-Platform CMS Implementation: archive/multi-platform-cms-architecture-implementation-plan.md
+      - Section-Based Homepage Plan: archive/section-based-homepage-plan.md
+
     - Troubleshooting:
       - Shop Frontend: troubleshooting/shop-frontend.md