Add simple workflow guide for homelab agents

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>
This commit is contained in:
Homelab Automation
2025-11-28 22:44:37 +00:00
parent aa204a105e
commit 43770a7895

61
WORKFLOW.md Normal file
View File

@@ -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`