ready to commit policy workflow

architecture/workspace/dynamic-policy-approval-retirement.puml

@@ -0,0 +1,27 @@
+@startuml
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Dynamic.puml
+
+title Policy Approval and Retirement Workflow - Dynamic Diagram
+
+Person(owner, "Business Owner")
+Person(staff, "Operations Staff")
+
+System(system, "Kell Creations Platform", "Unified business applications and shared services")
+
+Container(policyrepo, "Policy Repository", "Document Service", "Manages draft, review, active, and retired policy states")
+Container(notify, "Notification Service", "Messaging Service", "Sends review, approval, and retirement notifications")
+Container(audit, "Audit & Logging Service", "Observability Service", "Captures workflow, approval, publication, and retirement events")
+Container(evidence, "Compliance Evidence Repository", "Evidence Store", "Stores approval records, superseded versions, and retained evidence")
+System_Ext(git, "Forgejo Git", "Version-controlled source and change history")
+
+Rel(staff, policyrepo, "Creates or updates draft policy in")
+Rel(owner, policyrepo, "Reviews, approves, or retires policy in")
+
+Rel(policyrepo, notify, "Requests review and approval notifications through")
+Rel(policyrepo, git, "Stores controlled source and revision history in")
+Rel(policyrepo, audit, "Logs draft, review, approval, publication, and retirement events to")
+Rel(policyrepo, evidence, "Stores approval records and retired policy evidence in")
+Rel(notify, audit, "Logs notification activity to")
+Rel(owner, evidence, "Reviews retained approval and retirement evidence in")
+
+@enduml

docs/architecture/dynamic/policy-approval-retirement.md

@@ -0,0 +1,31 @@
+# Policy Approval and Retirement Workflow
+
+This diagram shows the dynamic workflow used to create, review, approve, publish, supersede, and retire controlled policy documents in the Kell Creations platform.
+
+## Purpose
+
+This view explains how the Policy Repository, notifications, audit logging, evidence retention, and version-controlled source history work together to support controlled policy lifecycle management.
+
+## Diagram Source
+
+The source for this diagram is maintained as architecture code in:
+
+`architecture/workspace/dynamic-policy-approval-retirement.puml`
+
+## Diagram
+
+![Policy Approval and Retirement Workflow](../../images/dynamic-policy-approval-retirement.svg)
+
+## Included Workflow Participants
+
+- Business Owner
+- Operations Staff
+- Policy Repository
+- Notification Service
+- Audit & Logging Service
+- Compliance Evidence Repository
+- Forgejo Git
+
+## Notes
+
+This dynamic workflow establishes the governance pattern for controlled policy lifecycle management in the Kell Creations platform. Future refinements should distinguish between draft creation, formal review states, approval-required publication, superseded version handling, retirement triggers, and evidence-retention policies.

mkdocs.yml

@@ -55,6 +55,7 @@ nav:
           - Product Publishing Workflow: "architecture/dynamic/product-publishing.md"
           - Social Campaign Publishing Workflow: "architecture/dynamic/social-campaign-publishing.md"
           - Inventory-to-Production Workflow: "architecture/dynamic/inventory-to-production.md"
+          - Policy Approval and Retirement Workflow: "architecture/dynamic/policy-approval-retirement.md"
       - Decisions:
           - ADR Index: "architecture/decisions/index.md"
   - Policies: