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