From 43770a7895aac3c15e759730cd0286b4d52ea569 Mon Sep 17 00:00:00 2001
From: Homelab Automation <automation@homelab>
Date: Fri, 28 Nov 2025 22:44:37 +0000
Subject: [PATCH] Add simple workflow guide for homelab agents
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Added WORKFLOW.md with streamlined instructions for:
- One-line VPS setup via curl bootstrap script
- Simple 3-step project workflow
- Key rules for where to run finish-up agent
- Quick reference table

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 WORKFLOW.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 WORKFLOW.md

diff --git a/WORKFLOW.md b/WORKFLOW.md
new file mode 100644
index 0000000..0ad3a35
--- /dev/null
+++ b/WORKFLOW.md
@@ -0,0 +1,61 @@
+# Homelab Agents Workflow
+
+Simple workflow for using agents across multiple VPS instances.
+
+---
+
+## Setup New VPS (One Time)
+
+```bash
+# Install agents from Gitea
+source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)
+```
+
+Done! Agents are now available in Claude Code.
+
+---
+
+## Working on Projects
+
+### 1. Navigate to Your Project Directory
+```bash
+cd ~/vps-system-apps
+# or
+cd ~/my-project
+```
+
+### 2. Do Your Work
+Edit files, configure systems, write code...
+
+### 3. When Done, Run Finish Up
+In Claude Code, say: **"finish up"**
+
+The agent automatically:
+- Creates session summary: `{project-name}-{hostname}-session-summary.md`
+- Updates CLAUDE.md and README.md
+- Commits and pushes to: `http://100.120.125.113:3000/pdm/{project-name}.git`
+
+---
+
+## Key Rules
+
+**✓ DO:** Run `finish-up` from your project directory (~/vps-system-apps)
+- Session summary goes to: vps-system-apps repository
+
+**✗ DON'T:** Run `finish-up` from ~/.homelab-agents
+- Would go to homelab-agents repository (only for agent updates)
+
+---
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Install agents on new VPS | `source <(curl -s http://100.120.125.113:3000/pdm/homelab-agents/raw/branch/main/scripts/bootstrap-agents.sh)` |
+| Check current directory | `pwd` |
+| End work session | "finish up" in Claude Code |
+| Update agents | `cd ~/.homelab-agents && git pull` |
+
+**Repository Pattern:**
+- Agents: `http://100.120.125.113:3000/pdm/homelab-agents.git`
+- Projects: `http://100.120.125.113:3000/pdm/{directory-name}.git`