seven-samurai-agents

Claude Agents Repository

Repositorio centralizado de agentes personalizados para Claude Code. Facilita la instalación y sincronización de agentes especializados en diferentes proyectos de desarrollo.

Descripción

Este repositorio proporciona una colección de agentes de Claude especializados y un script de sincronización que permite instalarlos fácilmente en cualquier proyecto local. Los agentes están diseñados para tareas específicas de desarrollo, desde arquitectura de software hasta testing y QA.

Agentes Disponibles

Los agentes están organizados en plugins por dominio tecnológico. Cada plugin contiene agentes especializados y skills ejecutables.

General Plugin

Agentes agnósticos de lenguaje que funcionan en cualquier proyecto.

1. Architect Agent ([general/agents] architect)

Especialista en Arquitectura de Software

Agente enfocado en análisis, evaluación y recomendación de soluciones arquitectónicas sin escribir código de implementación.

Capacidades:

• Análisis profundo de arquitectura de proyectos
• Evaluación de patrones de diseño (Clean Architecture, Hexagonal, etc.)
• Recomendaciones de arquitectura con pros/cons
• Planificación detallada de desarrollo por fases
• Generación de diagramas (Mermaid)
• Estimaciones de tiempo y recursos
• Documentación técnica completa (ADRs)

Cuándo usar:

• Diseño de nuevas funcionalidades
• Refactorización de sistemas existentes
• Evaluación de opciones técnicas
• Planificación de proyectos
• Documentación de arquitectura

Python Development Plugin

Agentes y skills especializados para desarrollo Python backend.

2. Backend Python Agent ([python-development/agents] backend-py)

Desarrollo Backend Python con Clean Architecture

Agente especializado en desarrollo backend Python usando Clean Architecture y Hexagonal Architecture (Ports & Adapters).

Stack Tecnológico:

• FastAPI 0.68.2+
• SQLAlchemy 2.0+ (PostgreSQL)
• MongoEngine (MongoDB)
• Alembic 1.14.0+
• Python 3.11+

Capacidades:

• Implementación de Clean Architecture/Hexagonal Architecture
• Desarrollo de APIs REST con FastAPI
• Gestión de bases de datos (PostgreSQL, MongoDB)
• Migraciones con Alembic
• Aplicación de principios SOLID
• Patrones de diseño (Repository, Interactor, DTO)
• Seguridad y autenticación (JWT, OAuth 2.0)
• Optimización de queries y performance

Cuándo usar:

• Desarrollo de APIs REST
• Implementación de casos de uso (Interactors)
• Creación de repositorios y adaptadores
• Migraciones de base de datos
• Refactorización hacia arquitectura limpia

3. QA Backend Python Agent ([python-development/agents] qa-backend-py)

Testing y QA para Backend Python

Agente especializado en testing, QA y chaos engineering para sistemas backend Python.

Capacidades:

• Testing unitario con Pytest
• Testing de integración
• Testing end-to-end
• Chaos engineering
• Cobertura de código (>90% objetivo)
• Testing de performance
• Testing de seguridad
• Generación de fixtures y mocks
• Análisis de código estático

Cuándo usar:

• Escribir tests unitarios e integración
• Aumentar cobertura de código
• Implementar chaos engineering
• Validar seguridad del código
• Testing de performance

4. Reviewer Backend Python Agent ([python-development/agents] reviewer-backend-py)

Code Review Automatizado para Backend Python

Agente especializado en revisión de código que combina las perspectivas del Architect, Backend-Py y QA para proporcionar reviews completas de PRs.

Capacidades:

• Análisis de arquitectura y patrones de diseño
• Validación de calidad de código (type hints, SOLID, DRY)
• Revisión de tests y cobertura (>90% objetivo)
• Detección de vulnerabilidades de seguridad
• Evaluación de performance y queries
• Generación de feedback estructurado con scores
• Decisión de APPROVE/REQUEST_CHANGES

Cuándo usar:

• Code reviews automatizados en GitHub PRs
• Validación de calidad antes de merge
• Asegurar estándares de arquitectura
• Verificar cobertura de testing
• Auditorías de seguridad

5. Reviewer Library Python Agent ([python-development/agents] reviewer-library-py)

Code Review para Librerías Python

Agente especializado en revisión de código para librerías Python, enfocado en API design, documentación y distribución de paquetes.

Cuándo usar:

• Revisión de PRs en proyectos de librería Python
• Validación de diseño de API pública
• Verificación de documentación y ejemplos
• Auditoría de estructura de paquete

6. Backend Python Celery Skill ([python-development/skills] backend-py-celery)

Desarrollo de APIs y Tareas Celery

Skill ejecutable para desarrollo de rutas FastAPI y tareas programadas Celery con Clean Architecture.

Capacidades:

• Creación de endpoints FastAPI con dependency injection
• Implementación de tareas Celery programadas
• Generación de boilerplate para Clean Architecture
• Integración con repositorios centralizados