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:
61
WORKFLOW.md
Normal file
61
WORKFLOW.md
Normal 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`
|
||||||
Reference in New Issue
Block a user