104 lines
2.9 KiB
Markdown
104 lines
2.9 KiB
Markdown
# Claude Code Agents
|
|
|
|
Shared repository for Claude Code AI agents across machines.
|
|
|
|
## 📦 Contents
|
|
|
|
This repository contains 13 specialized Claude agents:
|
|
|
|
### Core Agents
|
|
- **documentation-keeper** - Automatically updates server documentation when services change
|
|
- **homelab-optimizer** - Analyzes homelab infrastructure and provides optimization recommendations
|
|
|
|
### GSD (Get Shit Done) Agent System
|
|
Complete workflow system for structured project development:
|
|
|
|
- **gsd-project-researcher** - Researches domain ecosystem before roadmap creation
|
|
- **gsd-roadmapper** - Creates project roadmaps with phase breakdown
|
|
- **gsd-phase-researcher** - Researches implementation approaches before planning
|
|
- **gsd-planner** - Creates executable phase plans with task breakdown
|
|
- **gsd-plan-checker** - Verifies plans will achieve phase goals
|
|
- **gsd-executor** - Executes plans with atomic commits and state management
|
|
- **gsd-verifier** - Verifies phase goal achievement through analysis
|
|
- **gsd-integration-checker** - Verifies cross-phase integration and E2E flows
|
|
- **gsd-debugger** - Investigates bugs using scientific method
|
|
- **gsd-codebase-mapper** - Explores codebase and writes structured analysis
|
|
|
|
## 🚀 Setup on New Machine
|
|
|
|
### Initial Clone
|
|
```bash
|
|
# Clone to Claude's agents directory
|
|
git clone https://gitea.pressmess.duckdns.org/admin/claude-agents.git ~/.claude/agents
|
|
|
|
# Or if directory exists, pull into it
|
|
cd ~/.claude/agents
|
|
git init
|
|
git remote add origin https://gitea.pressmess.duckdns.org/admin/claude-agents.git
|
|
git pull origin main
|
|
```
|
|
|
|
### Configure Git
|
|
```bash
|
|
git config --global user.name "admin"
|
|
git config --global user.email "admin@server-ai.local"
|
|
```
|
|
|
|
## 🔄 Syncing Changes
|
|
|
|
### Push Changes
|
|
```bash
|
|
cd ~/.claude/agents
|
|
git add .
|
|
git commit -m "Description of changes"
|
|
git push origin main
|
|
```
|
|
|
|
### Pull Changes
|
|
```bash
|
|
cd ~/.claude/agents
|
|
git pull origin main
|
|
```
|
|
|
|
### Quick Sync Script
|
|
```bash
|
|
# Add to ~/.bashrc or create ~/sync-agents.sh
|
|
sync-agents() {
|
|
cd ~/.claude/agents
|
|
git pull origin main
|
|
echo "✓ Agents synced from Gitea"
|
|
}
|
|
```
|
|
|
|
## 📝 Adding New Agents
|
|
|
|
1. Create new agent file: `nano ~/.claude/agents/my-new-agent.md`
|
|
2. Commit and push:
|
|
```bash
|
|
cd ~/.claude/agents
|
|
git add my-new-agent.md
|
|
git commit -m "Add my-new-agent: description"
|
|
git push origin main
|
|
```
|
|
|
|
## 🌐 Repository
|
|
|
|
**Gitea URL**: https://gitea.pressmess.duckdns.org/admin/claude-agents
|
|
|
|
**Clone URL**: `https://gitea.pressmess.duckdns.org/admin/claude-agents.git`
|
|
|
|
## 🔐 Authentication
|
|
|
|
Uses admin credentials for Gitea access. Credentials are stored in git remote URL (URL-encoded).
|
|
|
|
To update credentials:
|
|
```bash
|
|
cd ~/.claude/agents
|
|
git remote set-url origin https://admin:PASSWORD@gitea.pressmess.duckdns.org/admin/claude-agents.git
|
|
```
|
|
|
|
## 📚 Related
|
|
|
|
- **Skills sync**: Managed by [Skillshare](https://github.com/runkids/skillshare) at `~/.claude/skills/`
|
|
- **Server docs**: `/home/jon/SERVER-DOCUMENTATION.md`
|