admin/claude-agents
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add 68 new specialized agents from lst97 and dl-ezo collections

Browse Source 
- Development: frontend-developer, backend-architect, react-pro, python-pro, golang-pro, typescript-pro, nextjs-pro, mobile-developer
- Data & AI: data-engineer, data-scientist, ai-engineer, ml-engineer, postgres-pro, graphql-architect, prompt-engineer
- Infrastructure: cloud-architect, deployment-engineer, devops-incident-responder, performance-engineer
- Quality & Testing: code-reviewer, test-automator, debugger, qa-expert
- Requirements & Planning: requirements-analyst, user-story-generator, system-architect, project-planner
- Project Management: product-manager, risk-manager, progress-tracker, stakeholder-communicator
- Security: security-auditor, security-analyzer, security-architect
- Documentation: documentation-expert, api-documenter, api-designer
- Meta: agent-organizer, agent-creator, context-manager, workflow-optimizer

Sources:
- github.com/lst97/claude-code-sub-agents (33 agents)
- github.com/dl-ezo/claude-code-sub-agents (35 agents)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
admin
2026-01-30 02:55:50 +00:00
parent 41f8767f3c
commit fccefcf3f9
74 changed files with 6527 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

316
README.md
View File

@@ -1,103 +1,273 @@
# Claude Code Agents
# Claude Code Comprehensive Agent Collection
Shared repository for Claude Code AI agents across machines.
**Language**: [English](README.md) | [日本語](README_JA.md)
## 📦 Contents
A complete collection of specialized sub-agents for Claude Code that enable end-to-end software development automation, from requirements analysis to production deployment and ongoing maintenance.
This repository contains 13 specialized Claude agents:
## 🎯 Overview
### Core Agents
- **documentation-keeper** - Automatically updates server documentation when services change
- **homelab-optimizer** - Analyzes homelab infrastructure and provides optimization recommendations
This repository contains a comprehensive set of Claude Code sub-agents designed to handle complete software development lifecycles with minimal human intervention. The agents are organized into six categories covering every aspect of modern software development.
### GSD (Get Shit Done) Agent System
Complete workflow system for structured project development:
## 📦 Agent Categories
- **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
### 1. Requirements & Analysis
**Purpose**: Transform business needs into detailed technical specifications
## 🚀 Setup on New Machine
- **requirements-analyst** - Analyzes user needs and creates detailed functional specifications
- **user-story-generator** - Creates comprehensive user stories and acceptance criteria
- **business-process-analyst** - Analyzes business processes and translates to technical requirements
- **requirements-validator** - Validates requirements for completeness and consistency
### Initial Clone
```bash
# Clone to Claude's agents directory
git clone https://gitea.pressmess.duckdns.org/admin/claude-agents.git ~/.claude/agents
### 2. Design & Architecture
**Purpose**: Create robust, scalable system designs
# 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
- **system-architect** - Designs comprehensive system architectures and technology stacks
- **data-architect** - Designs data models, schemas, and integration strategies
- **interface-designer** - Designs user interfaces and API specifications
- **security-architect** - Designs security frameworks and data protection strategies
- **design-reviewer** - Reviews and validates system designs for quality
### 3. Implementation & Development
**Purpose**: Handle all aspects of code development and quality assurance
- **code-reviewer** - Performs comprehensive code quality assessments
- **test-suite-generator** - Generates comprehensive test coverage
- **code-refactoring-specialist** - Safely improves code structure and reduces technical debt
- **security-analyzer** - Identifies vulnerabilities and security issues
- **performance-optimizer** - Analyzes and optimizes code performance
- **api-designer** - Designs clean, RESTful APIs with proper specifications
- **documentation-generator** - Creates technical documentation and code comments
- **dependency-manager** - Manages package dependencies and resolves conflicts
- **database-schema-designer** - Designs efficient database schemas and migrations
- **git-manager** - Manages Git operations, commit organization, and repository maintenance
- **cicd-builder** - Creates and configures CI/CD pipelines
### 4. Project Management
**Purpose**: Coordinate and manage the entire development process
- **project-planner** - Creates comprehensive project plans and timelines
- **risk-manager** - Identifies and creates mitigation strategies for project risks
- **progress-tracker** - Monitors project progress and identifies blockers
- **qa-coordinator** - Establishes quality standards and coordinates testing
- **stakeholder-communicator** - Manages stakeholder communication and reporting
### 5. Deployment & Operations
**Purpose**: Handle production deployment and ongoing operations
- **project-orchestrator** - Master coordinator for end-to-end project execution
- **deployment-ops-manager** - Handles production deployment and operational monitoring
- **uat-coordinator** - Coordinates user acceptance testing with business stakeholders
- **training-change-manager** - Creates training materials and manages system adoption
- **project-template-manager** - Manages project templates and quick setup for common project patterns
### 6. Meta-Management
**Purpose**: Optimize Claude Code itself for maximum efficiency
- **context-manager** - Monitors session context and manages information for continuity
- **session-continuity-manager** - Ensures seamless transitions between Claude Code sessions
- **memory-manager** - Optimizes Claude Code memory usage and project documentation
- **workflow-optimizer** - Analyzes and optimizes development workflows and agent usage
- **resource-monitor** - Monitors resource usage and suggests optimization strategies
- **agent-creator** - Dynamically creates new specialized agents when project needs arise
## 🚀 Key Features
### Complete Automation
- **End-to-end development**: From requirements to production deployment
- **Intelligent orchestration**: Agents automatically coordinate and sequence work
- **Dynamic specialization**: Create new agents for unique project needs
- **Session continuity**: Maintain context across long development sessions
### Professional Quality
- **Industry best practices**: Each agent follows established methodologies
- **Comprehensive testing**: Automated test generation and quality assurance
- **Security-first**: Built-in security analysis and compliance checking
- **Production-ready**: Full deployment and operational support
### Scalable Architecture
- **Modular design**: Use individual agents or complete workflows
- **Context preservation**: Efficient memory management for long projects
- **Resource optimization**: Monitor and optimize Claude Code usage
- **Template-driven**: Quick project setup with proven patterns
## 💡 Use Cases
### Complete Project Automation
```
User: "Create a library management system for our company"
Result: Fully functional web application with database, API, frontend, tests, documentation, and deployment
```
### Configure Git
```bash
git config --global user.name "admin"
git config --global user.email "admin@server-ai.local"
### Specialized Development Tasks
```
User: "Review this authentication code for security issues"
Agent: security-analyzer performs comprehensive security audit
```
## 🔄 Syncing Changes
### Push Changes
```bash
cd ~/.claude/agents
git add .
git commit -m "Description of changes"
git push origin main
### Long-term Project Management
```
User: "Manage the development of a multi-tenant SaaS platform"
Agent: project-orchestrator coordinates all phases with appropriate specialists
```
### Pull Changes
```bash
cd ~/.claude/agents
git pull origin main
## 📋 Installation
1. **Clone or copy agent definitions** to your project's `.claude/agents/` directory:
```bash
mkdir -p .claude/agents
# Copy the agent definition files to this directory
```
2. **Verify installation**:
```bash
ls .claude/agents/
# Should show all agent files (.md format)
```
3. **Start using agents** in Claude Code:
```
Use the project-orchestrator agent to build a complete web application
```
## 🎮 Usage Examples
### Starting a New Web Application
```
"I want to build a task management web application with user authentication, real-time updates, and mobile responsiveness. Handle everything from requirements to deployment."
```
### 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"
}
The **project-orchestrator** will:
1. Use **requirements-analyst** to gather detailed requirements
2. Coordinate **system-architect** and **data-architect** for design
3. Manage implementation with development agents
4. Handle testing, deployment, and documentation
5. Provide training materials for end users
### Code Quality Review
```
"Review my e-commerce checkout process for security vulnerabilities, performance issues, and code quality."
```
## 📝 Adding New Agents
Multiple agents coordinate:
- **security-analyzer** checks for vulnerabilities
- **performance-optimizer** identifies bottlenecks
- **code-reviewer** ensures best practices
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
### Long-term Project Management
```
"Manage the development of our new customer portal over the next 6 months with regular stakeholder updates."
```
## 🌐 Repository
The system provides:
- Automated project planning and risk management
- Regular progress tracking and reporting
- Quality gates and testing coordination
- Stakeholder communication management
**Gitea URL**: https://gitea.pressmess.duckdns.org/admin/claude-agents
## 🔧 Agent Workflow Patterns
**Clone URL**: `https://gitea.pressmess.duckdns.org/admin/claude-agents.git`
### Sequential Pattern
Requirements → Design → Implementation → Testing → Deployment
## 🔐 Authentication
### Parallel Pattern
Multiple development agents working simultaneously on different components
Uses admin credentials for Gitea access. Credentials are stored in git remote URL (URL-encoded).
### Adaptive Pattern
**agent-creator** generates specialized agents for unique requirements
To update credentials:
```bash
cd ~/.claude/agents
git remote set-url origin https://admin:PASSWORD@gitea.pressmess.duckdns.org/admin/claude-agents.git
### Continuous Pattern
Meta-management agents provide ongoing optimization and monitoring
## 📝 Agent Definition Format
Each agent follows Claude Code's standard format:
```markdown
---
name: agent-name
description: Detailed description with examples and usage patterns
---
Comprehensive system prompt defining the agent's expertise, responsibilities, and methodologies.
```
## 📚 Related
## 🔄 Agent Interactions
- **Skills sync**: Managed by [Skillshare](https://github.com/runkids/skillshare) at `~/.claude/skills/`
- **Server docs**: `/home/jon/SERVER-DOCUMENTATION.md`
### Master Coordinator
- **project-orchestrator** manages overall project flow
- Automatically selects and sequences appropriate agents
- Handles inter-agent communication and dependency management
### Specialized Teams
- **Requirements Team**: Gather and validate project needs
- **Design Team**: Create technical architecture and specifications
- **Development Team**: Implement, test, and optimize code
- **Operations Team**: Deploy and maintain production systems
- **Meta Team**: Optimize Claude Code usage and continuity
## 📚 Documentation
Each agent includes:
- **Detailed description** with usage examples
- **Specific use cases** and trigger conditions
- **Expected outputs** and deliverables
- **Integration patterns** with other agents
## 🎯 Complete Automation Example
### Input
```
"Create a library management system for our company"
```
### Automated Process
1. **Requirements Analysis**: Stakeholder needs → Technical specifications
2. **System Design**: Architecture → Database design → API design → UI design
3. **Implementation**: Backend → Frontend → Testing → Documentation
4. **Quality Assurance**: Code review → Security analysis → Performance optimization
5. **Deployment**: Production setup → CI/CD pipeline → Monitoring
6. **Handover**: User training → Documentation → Support procedures
### Output
- Fully functional web application
- Complete test suite with high coverage
- Production deployment with monitoring
- User documentation and training materials
- Ongoing maintenance procedures
## 🤝 Contributing
We welcome contributions! Please:
1. Follow the established agent definition format
2. Include comprehensive examples and documentation
3. Test thoroughly with real projects
4. Ensure agents integrate well with existing workflows
5. Submit clear documentation of agent capabilities
## 📄 License
MIT License - feel free to use, modify, and distribute these agents for any purpose.
## 🙏 Acknowledgments
Designed to work seamlessly with [Claude Code](https://claude.ai/code) and follows all established patterns and best practices for sub-agent development.
## 📞 Support
For issues, questions, or suggestions:
- Open an issue in this repository
- Check the Claude Code documentation at https://docs.anthropic.com/en/docs/claude-code
- Review agent examples and usage patterns
---
*Transform your development process with intelligent automation. From a single requirement to a production system - let the agents handle the complexity while you focus on the vision.*
## 🚀 Quick Start
1. **Copy agents** to your project's `.claude/agents/` directory
2. **Start Claude Code** in your project
3. **Say**: "Use the project-orchestrator to build [your project description]"
4. **Watch** as the system handles everything from requirements to deployment
**That's it!** The agents will coordinate automatically to deliver a complete, production-ready solution.