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`