From 3e1ce704d30c9b827d69323ecbbaa7dfec07e0ac Mon Sep 17 00:00:00 2001
From: Grace <grace@ubuntu-server-ai>
Date: Tue, 17 Mar 2026 16:21:45 -0700
Subject: [PATCH] Update stack overview template: add References section and
 agent notes

---
 docs/templates/stack-overview-template.md | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/docs/templates/stack-overview-template.md b/docs/templates/stack-overview-template.md
index 68f1da6..89124e1 100644
--- a/docs/templates/stack-overview-template.md
+++ b/docs/templates/stack-overview-template.md
@@ -59,7 +59,7 @@ AI USAGE INSTRUCTIONS:
 ---
 
 ## Change Log
-<!-- AI INSTRUCTION: Keep a running log of updates, additions, or fixes to the stack. Include date, type, and summary. Append only. -->
+<!-- AI INSTRUCTION: Keep a running log of updates, additions, or fixes to the stack. Include date, type, and summary. Append only. Format: YYYY-MM-DD | Added/Updated/Fixed | Summary -->
 
 <!-- AI GENERATED START: Change Log -->
 {{change_log}}
@@ -68,5 +68,17 @@ AI USAGE INSTRUCTIONS:
 ---
 
 ## References
-- [Official Documentation]({{docs_url}})
-- [Related Stack or Module]({{related_url}})
+<!-- AI INSTRUCTION: Include official docs, repos, guides, or RAG import TODOs. Indicate if online documentation has not yet been imported into the RAG. -->
+
+{{references}}
+
+---
+
+<!--
+### Notes for the AI Agent
+
+1. Each section has specific instructions and examples so the AI can generate content consistently.
+2. Connections section emphasizes the stack-level view — where this stack sits in the system architecture and what it communicates with.
+3. References section includes TODOs for RAG imports to ensure offline or indexed documentation.
+4. This template can be reused for multiple stacks (AI, NextCloud, Dashboard/Monitoring, GIS Editing, etc.) by replacing {{stack_name}} and filling in the placeholders.
+-->