From 49161ed68df1e244ec884c199b135a0a286ca10f Mon Sep 17 00:00:00 2001
From: Homelab Automation <automation@homelab>
Date: Sun, 23 Nov 2025 14:39:16 +0000
Subject: [PATCH] Add complete homelab agents structure, templates, and
 sysadmin-session-closer agent

---
 README.md                             | 25 +++++++++++++++++++++++--
 agents/README.md                      |  6 ++++++
 agents/sysadmin-session-closer.md     | 18 ++++++++++++++++++
 scripts/README.md                     |  3 +++
 scripts/install-agent.sh              | 18 ++++++++++++++++++
 templates/CLAUDE.md.template          | 10 ++++++++++
 templates/README.md                   |  3 +++
 templates/session-summary.md.template | 20 ++++++++++++++++++++
 8 files changed, 101 insertions(+), 2 deletions(-)
 create mode 100644 agents/README.md
 create mode 100644 agents/sysadmin-session-closer.md
 create mode 100644 scripts/README.md
 create mode 100755 scripts/install-agent.sh
 create mode 100644 templates/CLAUDE.md.template
 create mode 100644 templates/README.md
 create mode 100644 templates/session-summary.md.template

diff --git a/README.md b/README.md
index 557b965..6c656e6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
-# homelab-agents
+# Homelab Agents
 
-Central storage for AI agent prompts
\ No newline at end of file
+Central storage for AI agent prompts shared across all VPS instances.
+
+## Structure
+- `agents/` - Agent prompt definitions
+- `templates/` - Template files for agents and session summaries
+- `scripts/` - Installation and utility scripts
+
+## Usage
+
+Clone this repository on any VPS:
+```bash
+git clone http://100.120.125.113:3000/pdm/homelab-agents.git ~/.homelab-agents
+```
+
+Update agents:
+```bash
+cd ~/.homelab-agents && git pull
+```
+
+## Available Agents
+
+- **sysadmin-session-closer** - Automatically closes and documents dev sessions
diff --git a/agents/README.md b/agents/README.md
new file mode 100644
index 0000000..bb6f90d
--- /dev/null
+++ b/agents/README.md
@@ -0,0 +1,6 @@
+# Agents
+
+Agent prompt definitions for use across the homelab.
+
+## sysadmin-session-closer
+Automatically closes development sessions and creates session summaries.
diff --git a/agents/sysadmin-session-closer.md b/agents/sysadmin-session-closer.md
new file mode 100644
index 0000000..845a788
--- /dev/null
+++ b/agents/sysadmin-session-closer.md
@@ -0,0 +1,18 @@
+# Sysadmin Session Closer Agent
+
+Automatically closes development sessions and generates session summaries.
+
+## Purpose
+This agent monitors active development sessions and automatically:
+1. Detects when a session is ending
+2. Captures session context and changes
+3. Generates a comprehensive session summary
+4. Updates git repositories with changes
+5. Cleans up temporary files
+
+## Features
+- Automatic session detection
+- Git integration for repository changes
+- Session summary generation with timestamps
+- Support for both homelab-agents and VPS project repositories
+- Intelligent change detection
diff --git a/scripts/README.md b/scripts/README.md
new file mode 100644
index 0000000..e6644d6
--- /dev/null
+++ b/scripts/README.md
@@ -0,0 +1,3 @@
+# Scripts
+
+Utility scripts for agent installation and management.
diff --git a/scripts/install-agent.sh b/scripts/install-agent.sh
new file mode 100755
index 0000000..7c89bf0
--- /dev/null
+++ b/scripts/install-agent.sh
@@ -0,0 +1,18 @@
+#!/bin/bash
+# Install agent script
+
+AGENT_NAME="${1:-}"
+HOMELAB_DIR="${HOME}/.homelab-agents"
+
+if [ -z "$AGENT_NAME" ]; then
+    echo "Usage: install-agent.sh <agent-name>"
+    exit 1
+fi
+
+if [ ! -f "$HOMELAB_DIR/agents/$AGENT_NAME.md" ]; then
+    echo "Error: Agent $AGENT_NAME not found"
+    exit 1
+fi
+
+echo "Installing agent: $AGENT_NAME"
+cat "$HOMELAB_DIR/agents/$AGENT_NAME.md"
diff --git a/templates/CLAUDE.md.template b/templates/CLAUDE.md.template
new file mode 100644
index 0000000..c15e76a
--- /dev/null
+++ b/templates/CLAUDE.md.template
@@ -0,0 +1,10 @@
+# Project Context
+
+## Overview
+{{PROJECT_OVERVIEW}}
+
+## Key Directories
+{{KEY_DIRECTORIES}}
+
+## Important Files
+{{IMPORTANT_FILES}}
diff --git a/templates/README.md b/templates/README.md
new file mode 100644
index 0000000..9e0a448
--- /dev/null
+++ b/templates/README.md
@@ -0,0 +1,3 @@
+# Templates
+
+Reusable templates for agent prompts and documentation.
diff --git a/templates/session-summary.md.template b/templates/session-summary.md.template
new file mode 100644
index 0000000..2f2891f
--- /dev/null
+++ b/templates/session-summary.md.template
@@ -0,0 +1,20 @@
+# Session Summary - {{DATE}}
+
+## Context
+Project: {{PROJECT_NAME}}
+Duration: {{START_TIME}} to {{END_TIME}}
+Developer: {{USER}}
+
+## Changes Made
+{{CHANGES}}
+
+## Files Modified
+{{FILES_MODIFIED}}
+
+## Git Status
+```
+{{GIT_STATUS}}
+```
+
+## Next Steps
+{{NEXT_STEPS}}