☠️
🏴‍☠️ Sistema Multi-Agente para Desarrollo de Software

One Piece
Agents

11 agentes especializados con la personalidad de los Sombrero de Paja que construyen sistemas completos de software con verificación en cada paso.

11
Agentes
5
Fases
3
Capas de Verificación
4+3
Stacks Soportados

La Tripulación

11 agentes especializados, cada uno con su personalidad, herramientas y responsabilidades únicas. Juntos pueden construir cualquier sistema.

Orquestador
🏴‍☠️

Luffy

Monkey D. Luffy

Orquestador

El capitán. No programa, pero sabe exactamente a quién necesita y cuándo. Dirige el flujo completo desde explore hasta archive.

"¡Shishishi! ¡Vamos a construir algo increíble, nakama!"

Investigador
📚

Robin

Nico Robin

Research & Specs

La arqueóloga del código. Analiza cualquier codebase, investiga librerías, escribe specs detallados y define contratos entre frontend y backend.

"Interesting... este patrón se repite en 47 archivos."

Desarrollador
⚔️

Zoro

Roronoa Zoro

Backend

Directo y eficiente. Implementa APIs, servicios y lógica de negocio. Cada endpoint incluye Swagger y curls verificados obligatoriamente.

"Hmph. El endpoint está listo. Siguiente."

Desarrollador
🍳

Sanji

Vinsmoke Sanji

Base de Datos

El chef de los datos. Diseña schemas en PostgreSQL+PostGIS, crea migraciones, seeds y optimiza queries. Cada query es un plato perfecto.

"¡Un full table scan! ¡Jamás en MI cocina!"

Desarrollador
🗺️

Nami

Nami

Frontend

Precisa y calculadora. Implementa componentes, páginas y estado. Cada componente se verifica en Chrome antes de reportar.

"¿Un margin de 17px? ¡Eso no existe! Son 16 o son 20."

Desarrollador
🎵

Brook

Brook

UX Copy & Accesibilidad

El músico del UX. Escribe textos de interfaz, mensajes de error amigables, maneja accesibilidad e internacionalización.

"¡Yohohoho! Este mensaje de error no tiene alma."

Desarrollador
🔧

Franky

Cutty Flam

DevOps & Infra

El ingeniero del barco. Dockerfiles, CI/CD, configuración de ambientes y health checks. Todo con estilo SUUUPER.

"¡SUUUPER! ¡Este Dockerfile es una OBRA DE ARTE!"

Verificador
⚕️

Law

Trafalgar D. Water Law

Verificador Continuo

El cirujano. Verifica CADA paso de CADA agente: curls para backend, Chrome para frontend, builds para DevOps. No programa, solo verifica.

"Room. Shambles. Esto no cumple el spec."

Verificador
🌊

Jinbe

Jinbe

Seguridad

El sabio protector. Revisa OWASP Top 10, autenticación, dependencias vulnerables y calidad del código. Protege al barco de amenazas.

"He visto este patrón antes. Lleva a SQL injection."

Verificador
🎯

Usopp

God Usopp

Testing Final

El francotirador que no falla. Ejecuta tests unitarios, integración y E2E. Su APROBADO es la llave para archivar. Sin él, nada se despliega.

"¡Yo, el gran Capitán Usopp, he encontrado 3 bugs críticos!"

Emergencia
🩺

Chopper

Tony Tony Chopper

Debug & Hotfix

El doctor del código. Diagnostica bugs, analiza stack traces, aplica hotfixes quirúrgicos y resuelve problemas de rendimiento.

"¡No me halagues, idiota! ...pero sí, encontré el bug."

El Flujo OpenSpec

Cada misión sigue el mismo ciclo. Siempre. Sin saltarse pasos.

🔍
FASE 1

Explore

Luffy pregunta TODO lo necesario. Robin analiza el codebase. No se avanza hasta tener claridad total.

Luffy Robin
/opsx:explore
📋
FASE 2

Propose

Luffy crea el plan: proposal, specs, diseño y tareas. El usuario aprueba antes de implementar.

Luffy Robin
/opsx:propose
FASE 3

Apply

Los agentes implementan en paralelo. Law verifica CADA paso antes de continuar al siguiente.

Zoro Sanji Nami Brook Franky Law
/opsx:apply
🛡️
FASE 4

Verify

Usopp ejecuta la suite de tests completa. Jinbe revisa seguridad. Ambos deben aprobar.

Usopp Jinbe
/opsx:verify
FASE 5

Archive

Solo si Usopp y Jinbe aprueban, y el usuario da el visto bueno, Luffy archiva el cambio.

Luffy
/opsx:archive

⚕️ Law verifica CADA paso durante el Apply. Ningún agente avanza sin la verificación de Law. 🎯 Usopp + 🌊 Jinbe son la puerta final antes del Archive.

Arquitectura del Sistema

Patrón orquestador-trabajador. Luffy coordina, los especialistas ejecutan, Law verifica cada paso.

🏴‍☠️
Luffy
Orquestador
No programa. Dirige el flujo.
delega tareas
📚
Robin
Research
⚔️
Zoro
Backend
🍳
Sanji
Database
🗺️
Nami
Frontend
🔧
Franky
DevOps
Law verifica cada paso
⚕️
Law — Verificador Continuo
Curls para backend · Chrome para frontend · Docker para DevOps
verificación final (en paralelo)
🎯
Usopp
Tests finales
APRUEBA → archive
🌊
Jinbe
Seguridad OWASP
APRUEBA → archive
Archive — Misión Completada
Solo cuando Usopp + Jinbe aprueban y el usuario confirma
🩺
Chopper — Solo cuando hay bugs
Diagnóstico y hotfixes quirúrgicos

Tech Stacks

La tripulación domina múltiples tecnologías. El agente detecta el stack del proyecto automáticamente.

⚔️

Backend

Zoro los domina todos

🟣
.NET 10 Principal

Stack principal — ASP.NET Core, Entity Framework

🔵
Go

Alto rendimiento — Gin, Fiber, Chi

🟢
FastAPI

Python moderno — Pydantic, SQLAlchemy

🟤
Django

Python completo — DRF, ORM integrado

🗺️

Frontend

Nami los domina todos

⚛️
React 19

Server Components, Hooks, Vite

Next.js

App Router, SSR/SSG, Full-stack

🚀
Astro

Islas, contenido estático, ultra-rápido

🍳

Base de Datos

Sanji. Sin excepciones.

🐘
PostgreSQL + PostGIS

La ÚNICA base de datos. Siempre. Sin excepciones.

¿Por qué solo PostgreSQL+PostGIS?

Porque Sanji no acepta compromisos en su cocina. PostgreSQL es el mejor RDBMS de código abierto y PostGIS lo convierte en la solución definitiva para datos geoespaciales.

3 Capas de Verificación

Nada llega a producción sin pasar por las tres capas. Es la garantía de calidad de la tripulación.

⚕️

Capa 1 — Law

Continua · Cada Paso

Law verifica después de CADA paso de CADA agente dev. No se salta nunca. Si falla, el equipo para y corrige antes de continuar.

🔗 Backend
Swagger existe · Curls ejecutados · Status codes correctos
🖥️ Frontend
Chrome abierto · 0 errores consola · Responsive verificado
🐳 DevOps
Docker build · Containers up · Health checks pasan
al finalizar todo el apply
🌊

Capa 2 — Jinbe

Seguridad · OWASP

Jinbe hace una revisión completa de seguridad sobre todo el código generado. OWASP Top 10, autenticación, dependencias vulnerables y calidad del código.

InjectionAuth/AuthZExposición de datosControl de accesoMala configuraciónXSSDependencias vulnerablesRate limiting
en paralelo
🎯

Capa 3 — Usopp

Testing Final · Gate para Archive

Usopp ejecuta la suite completa de tests y verifica que la implementación cumple cada escenario de los specs. Su APROBADO es obligatorio para archivar.

🧪
Unit Tests
🔗
Integration Tests
🌐
E2E Tests
🏆

Las 3 capas deben pasar antes de que Luffy pueda archivar el cambio.

Cómo Usarlo

Tres pasos para tener la tripulación lista en cualquier proyecto existente.

1

Instalar en tu proyecto

Ejecuta el script de setup en tu proyecto existente. Detecta automáticamente tu AGENTS.md si tienes uno, crea el symlink a los agentes y configura el CLAUDE.md sin pisar lo que ya tienes.

terminal
# Clonar el repositorio de agentes
$ git clone https://github.com/CamiloPuentes94/one-piece-agents
# Configurar tu proyecto existente
$ ./one-piece-agents/setup.sh /ruta/a/tu-proyecto
✅ Symlink creado: .claude/one-piece-agents
✅ CLAUDE.md actualizado con la tripulación
📄 AGENTS.md detectado — referenciado en la configuración
🏴‍☠️ ¡La tripulación está lista para zarpar!
📄 AGENTS.md existente
Lo detecta y lo referencia. La tripulación se complementa con tus reglas — no las reemplaza.
📝 CLAUDE.md existente
Agrega la sección de la tripulación al final sin borrar lo que ya tienes en el archivo.
🔗 Symlink
Agrega .claude/one-piece-agents al .gitignore automáticamente.
2

Abrir el proyecto con Claude Code

Abre tu proyecto en Claude Code. El CLAUDE.md ya tiene las instrucciones de la tripulación. Describe tu misión directamente.

claude code
# Abrir el proyecto
$claude
3

Darle una misión a Luffy

Describe lo que quieres construir. Luffy inicia el flujo OpenSpec completo, pregunta todo lo necesario, y coordina a la tripulación.

👤
Necesito un sistema de autenticación con JWT para mi API en .NET 10
🏴‍☠️
¡Shishishi! ¡Nueva misión, nakama! Antes de armar el plan, necesito entender algunas cosas...

1. ¿Los usuarios se registran en el sistema o vienen de un IdP externo (Google, Azure AD)?

2. ¿Necesitas refresh tokens o solo access tokens?

3. ¿Hay roles o permisos? ¿Cuáles?

4. ¿El token tiene algún tiempo de expiración específico?

👤
Registro propio, con refresh tokens, roles: admin y user, access token 15min, refresh 7 días
🏴‍☠️
¡Yosh! Perfecto. Voy a crear el plan. Robin, analiza el codebase actual...
→ Robin analiza el proyecto → Luffy crea proposal + specs + tasks → Sanji crea la tabla users → Zoro implementa los endpoints → Law verifica cada paso → Usopp + Jinbe verifican todo → Luffy archiva ✅

Comandos Disponibles

🔍
/opsx:explore

Iniciar exploración con Luffy como interrogador

📋
/opsx:propose

Crear el plan completo (proposal, specs, diseño, tareas)

/opsx:apply

Implementar las tareas del plan con los agentes

🛡️
/opsx:verify

Ejecutar verificación final con Usopp y Jinbe

/opsx:archive

Archivar el cambio (requiere aprobación de Usopp + Jinbe)

/opsx:ff

Fast-forward: crear todos los artefactos de una vez