From f14af3a9373ea6b5e3579f8198001ab47279c38e Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 16 Feb 2026 10:58:54 +0100
Subject: [PATCH] docs: fix template formatting for CI

---
 docs/reference/templates/GOALS.md    | 13 +++++++++++++
 docs/reference/templates/SOUVENIR.md | 16 ++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/docs/reference/templates/GOALS.md b/docs/reference/templates/GOALS.md
index e10b15295ba..8bbce2b36f6 100644
--- a/docs/reference/templates/GOALS.md
+++ b/docs/reference/templates/GOALS.md
@@ -31,25 +31,31 @@ _[Your core mission statement — what you're here to achieve]_
 ## Active Goals
 
 ### Goal: [Goal Name]
+
 **Status:** Active | Completed | Blocked | Planned
 
 Success Criteria:
+
 - [Criterion 1]
 - [Criterion 2]
 
 Subtasks:
+
 - [ ] Subtask 1
 - [x] Subtask 2
 
 Dependencies:
+
 - [Dependency if any]
 
 ---
 
 ### Goal: [Another Goal]
+
 **Status:** [Status]
 
 Success Criteria:
+
 - [Criterion]
 
 ---
@@ -57,9 +63,11 @@ Success Criteria:
 ## Completed Goals
 
 ### Goal: [Completed Goal Name]
+
 **Completed:** YYYY-MM-DD
 
 Impact:
+
 - [What this achieved]
 
 ---
@@ -79,6 +87,7 @@ Impact:
 # GOALS.md — Project Alpha
 
 ## High-Level Mission
+
 Build a production-ready BPM engine for CPPA-G demo.
 
 ---
@@ -86,20 +95,24 @@ Build a production-ready BPM engine for CPPA-G demo.
 ## Active Goals
 
 ### Goal: Implement BPMN 2.0 Engine
+
 **Status:** Active
 
 Success Criteria:
+
 - All 21 tests passing
 - Supports parallel gateways
 - SLA tracking works
 
 Subtasks:
+
 - [x] Core engine architecture
 - [ ] Timer service
 - [x] Human task management
 - [ ] Parallel gateway support
 
 Dependencies:
+
 - None
 ```
 
diff --git a/docs/reference/templates/SOUVENIR.md b/docs/reference/templates/SOUVENIR.md
index 8636cde0577..c28b060718b 100644
--- a/docs/reference/templates/SOUVENIR.md
+++ b/docs/reference/templates/SOUVENIR.md
@@ -29,15 +29,19 @@ _Purpose: Capture operational insights, lessons learned, and behavioral refineme
 ## YYYY-MM-DD
 
 ### Context
+
 What was happening / What task were you doing
 
 ### Observation
+
 What happened / What went wrong / What worked well
 
 ### Insight
+
 What you learned / What should change
 
 ### Action
+
 Permanent behavior adjustment (if any)
 ```
 
@@ -51,15 +55,19 @@ Permanent behavior adjustment (if any)
 ## 2026-02-16
 
 ### Context
+
 Ravenclaw scheduled emails weren't sending on time.
 
 ### Observation
+
 The background checker wasn't running — Ravenclaw had crashed silently.
 
 ### Insight
+
 Need monitoring for the scheduler process, not just the Flask app.
 
 ### Action
+
 Added process health check in ops.sh script.
 ```
 
@@ -69,15 +77,19 @@ Added process health check in ops.sh script.
 ## 2026-02-15
 
 ### Context
+
 Successfully completed multi-hour coding session without errors.
 
 ### Observation
+
 Breaking work into 30-minute iterations with SOUVENIR.md checkins reduced context drift.
 
 ### Insight
+
 Short iteration loops + reflection beats marathon sessions.
 
 ### Action
+
 Default to 30-minute work blocks with SOUVENIR.md updates.
 ```
 
@@ -87,15 +99,19 @@ Default to 30-minute work blocks with SOUVENIR.md updates.
 ## 2026-02-14
 
 ### Context
+
 Pushed force update to shared repo, overwrote contributor changes.
 
 ### Observation
+
 Should have pulled first, merged, then pushed.
 
 ### Insight
+
 Never force push to shared branches. Ever.
 
 ### Action
+
 Use `git pull --rebase` or create merge commits on shared branches.
 ```