From 8b418dd7887bfccb4855b16141d1bc43a69c9ef0 Mon Sep 17 00:00:00 2001
From: Mike Kell <mtkell@kellengineering.com>
Date: Fri, 3 Apr 2026 17:13:38 -0400
Subject: [PATCH] ready to commit policy workflow

---
 .../dynamic-policy-approval-retirement.puml   | 27 ++++++++++++++++
 .../dynamic/policy-approval-retirement.md     | 31 +++++++++++++++++++
 mkdocs.yml                                    |  1 +
 3 files changed, 59 insertions(+)
 create mode 100644 architecture/workspace/dynamic-policy-approval-retirement.puml
 create mode 100644 docs/architecture/dynamic/policy-approval-retirement.md

diff --git a/architecture/workspace/dynamic-policy-approval-retirement.puml b/architecture/workspace/dynamic-policy-approval-retirement.puml
new file mode 100644
index 0000000..7d36ec3
--- /dev/null
+++ b/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
\ No newline at end of file
diff --git a/docs/architecture/dynamic/policy-approval-retirement.md b/docs/architecture/dynamic/policy-approval-retirement.md
new file mode 100644
index 0000000..235fe0f
--- /dev/null
+++ b/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.
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index e2187ea..f41178f 100644
--- a/mkdocs.yml
+++ b/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: