omp-dev-team

⚠️ En desarrollo — este paquete está en construcción activa. La estructura, agentes y skills pueden cambiar entre versiones menores.

Equipo de agentes especializados para omp (Oh My Pi) — arquitectura, backend, frontend, revisión de seguridad y documentación, listos para usar en cualquier proyecto con modelos gratuitos de OpenCode Zen.

¿Qué es esto?

omp-dev-team instala un set de subagentes preconfigurados para omp, cada uno con un rol específico, un modelo asignado y permisos ajustados a su función — como tener un pequeño equipo de desarrollo dentro de tu terminal, disponible en cualquier proyecto que abras.

No está atado a ningún proyecto en particular: los agentes se instalan a nivel global (~/.omp/agent/) y detectan la estructura del proyecto actual al trabajar.

Requisitos previos

Requisito	Notas
Bun ≥ 1.3.14	Runtime que usa omp
omp instalado	irm https://omp.sh/install.ps1 | iex (Windows) o curl -fsSL https://omp.sh/install | sh (Linux/macOS)
Node.js ≥ 18	Para correr el instalador de este paquete
Cuenta en OpenCode Zen (opcional pero recomendado)	Da acceso a los modelos gratuitos que usan los agentes — /login dentro de omp

Instalación

npm install @emiliom/omp-dev-team

El hook postinstall copia automáticamente los agentes y skills a:

• Windows: %USERPROFILE%\.omp\agent\agents\ y %USERPROFILE%\.omp\agent\skills\
• Linux/macOS: ~/.omp/agent/agents/ y ~/.omp/agent/skills/

No se requiere ningún paso adicional — al terminar la instalación, los agentes ya están disponibles en cualquier proyecto.

Instalación manual (sin npm)

Si prefieres no usar npm, puedes correr el instalador directo con npx contra el repositorio:

npx github:Emiliom027/omp-dev-team

Agentes incluidos

Agente	Rol	Modelo (gratuito, Zen)	Permisos
architect	Diseño de arquitectura y decisiones técnicas	Nemotron 3 Ultra Free	Solo lectura
backend	Lógica de servidor (PHP, Node, Python, etc.)	Big Pickle	Editar + ejecutar comandos
frontend	Interfaz de usuario (HTML/CSS/JS, frameworks)	MiMo V2 Flash Free	Solo editar
security-review	Revisión de vulnerabilidades antes de commit	GPT-5 Nano	Solo lectura
docs	Documentación técnica del proyecto	North Mini Code Free	Solo editar

Los modelos gratuitos de Zen cambian con el tiempo. Si alguno deja de estar disponible, edita el campo model en el archivo .md correspondiente (ver Personalización).

Uso

Dentro de cualquier proyecto, inicia omp normalmente:

omp

Invoca un agente específico por nombre:

@architect diseña la estructura de autenticación para este proyecto
@backend implementa el endpoint de login según lo que propuso architect
@frontend crea el formulario de login
@security-review revisa los cambios antes de hacer commit
@docs actualiza el README con el nuevo flujo de autenticación

También puedes dejar que el agente principal delegue automáticamente cuando detecte que una tarea encaja con la especialidad de alguno de ellos.

Coordinación automática (AGENTS.md)

Este paquete incluye un AGENTS.md que se instala en ~/.omp/agent/AGENTS.md y se carga automáticamente en cada sesión — no necesitas invocarlo. Le da al agente principal el contexto completo del equipo: quién es cada subagente, cuándo delegarle una tarea, y cuándo resolver algo directamente sin delegar.

Esto significa que puedes simplemente describir lo que necesitas y el agente principal decide solo si delega a @backend, pide una revisión con @security-review, etc.

Skills incluidas

Generales, útiles en cualquier proyecto y lenguaje:

Skill	Categoría
conventional-commits.md	Equipo completo
clean-code.md	Equipo completo
code-review.md	Equipo completo
debugging.md	Equipo completo
api-design.md	architect
database-design.md	architect
error-handling.md	backend
testing-fundamentals.md	backend
accessibility.md	frontend
responsive-design.md	frontend
owasp-top-10.md	security-review
secrets-management.md	security-review
technical-writing.md	docs
find-skills.md	Equipo completo — descubre skills existentes antes de crear nuevas
token-efficiency.md	Equipo completo — reduce consumo de tokens en tareas largas

Personalización

Los agentes son archivos Markdown con frontmatter — puedes editarlos directamente después de instalados:

~/.omp/agent/agents/backend.md

---
model: opencode-zen/big-pickle
tools:
  edit: true
  bash: true
---
Tu prompt personalizado aquí...

Cambios ahí no se sobrescriben a menos que vuelvas a correr npm install sobre este paquete.

Actualizar

npm update @emiliom/omp-dev-team

O reinstala para forzar la copia de la última versión de los agentes:

npm install @emiliom/omp-dev-team --force

Estructura del repositorio

omp-dev-team/
├── AGENTS.md         # Contexto global, se carga automaticamente
├── agents/
│   ├── architect.md
│   ├── backend.md
│   ├── frontend.md
│   ├── security-review.md
│   └── docs.md
├── skills/
│   ├── security-checklist.md
│   └── docs-format.md
├── install.js       # Ejecutado por el hook postinstall
├── package.json
└── README.md

Contribuir

Issues y pull requests son bienvenidos en github.com/Emiliom027/omp-dev-team.

Roadmap / En desarrollo

• Skills específicas por stack (PHP, Node, Python) como paquetes opcionales separados
• Integración probada con Claude Code Marketplace
• Más agentes especializados (ej. devops, qa)
• Tests automatizados del instalador

Licencia

MIT © Emiliom027