convez.ai
SkillDesenvolvimento WebAvançado
nomdedev

Agent Manager Template

nomdedev/agent-manager-template

Pipeline estruturado com 12 agentes e 7 fases para código de produção

Ver no GitHub
InicialPluginScore · de 0 a 100

Template profissional de engenharia assistida por IA para Claude Code com pipeline de 7 fases, 12 agentes especializados, 13 skills e 11 hooks de qualidade. Transforma Claude Code em um time de especialistas com papéis definidos trabalhando sob gates de controle de qualidade. Inclui CLI claudio para setup, verificação e auditoria em qualquer projeto.

Instalação

$npx convez-ai nomdedev/agent-manager-template

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
2
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Estruturar projetos Claude Code com padrões de qualidade
  • Implementar múltiplos agentes especializados com protocolos definidos
  • Automatizar code review, testes e segurança com hooks e skills
  • Auditoria e rastreamento de features através de ciclo de vida completo

Veredito

Solução madura para equipes que precisam formalizar trabalho em Claude Code. O pipeline de 7 fases e arquitetura de agentes especializados agregam rigor editorial real, mas exige investimento inicial em entender a metodologia. Recomendado para projetos complexos e medium+ teams.

README

A tradução para o português deste README ainda está na fila.

Agent Manager Template

Setup profesional de Claude Code: pipeline de 7 fases, 12 agentes, 13 comandos slash, 11 hooks, 10 skills — un comando para empezar.

Guía rápida: GETTING_STARTED.md · Referencia completa: docs/REFERENCE.md · Avanzado (opcional): docs/ADVANCED.md


Inicio rápido (3 comandos)

git clone https://github.com/nomdedev/agent-manager-template
cd agent-manager-template
pnpm setup && claudio doctor && pnpm dev

Sin argumentos, claudio abre un menú interactivo que explica cada opción. También: claudio guia (qué hace pipeline, agentes, hooks…).

Instalar en otro proyecto:

claudio init ./mi-proyecto --yes
claudio doctor

Tabla de contenidos


Que es esto

Agent Manager Template es un sistema de ingenieria asistida por IA para Claude Code. No es solo una estructura de carpetas: es una metodologia completa que define como un equipo de agentes especializados colabora para entregar software de calidad.

La idea central es simple: en lugar de que Claude Code sea un asistente general que hace todo, este template lo convierte en un equipo de especialistas con roles definidos, que trabajan bajo un pipeline secuencial con gates de calidad. Cada feature pasa por 7 fases obligatorias antes de llegar a produccion.

Que incluye:

  • CLI claudio (init, doctor, evoluciona) para instalar y verificar el setup
  • Pipeline de 7 fases con gates de salida verificables
  • 12 agentes especializados con permisos y protocolos definidos
  • 12 comandos slash (/audit, /security, /test, /review, /frontend, etc.)
  • 11 hooks que bloquean automaticamente operaciones peligrosas
  • 13 skills cargables on-demand (incl. audit-pipeline lifecycle)
  • 8 agentes lifecycle-audit (scope → production, GO/NO-GO)
  • Vault de Obsidian y Hermes Agent — opcionales (docs/ADVANCED.md)

CLI claudio — referencia completa

claudio init [target-dir] [--minimal] [--yes]

Punto de entrada recomendado. En este template instala dependencias y crea .env; en otros proyectos instala .claude/ y genera context.md, architecture.md, domain.md y memory.md.

claudio init
claudio init ./mi-proyecto --yes
pnpm setup    # alias de claudio init en este repo

claudio doctor

Verifica Node, .claude/, MCP paths, hooks y .env (en el template).

claudio evoluciona [target-dir] [--minimal] [--yes]

Instala el setup completo de Claude Code en un proyecto.

claudio evoluciona ./mi-proyecto --minimal

El wizard copia:

  • .claude/agents/ — 12 agentes especializados
  • .claude/commands/ — 12 comandos slash
  • .claude/hooks/ — 11 hooks de seguridad y calidad
  • .claude/skills/ — 10 skills especializados
  • .claude/rules/ — reglas del proyecto (incl. domain.md generado)
  • .claude/CLAUDE.md — 12 reglas de comportamiento
  • .claude/logs/pipeline-state.json — estado del pipeline

claudio hermes <subcomando>

Gestion de Hermes Agent con Obsidian como knowledge database.

SubcomandoDescripcion
installInstala Hermes Agent en el sistema
init [perfil]Crea ~/.hermes/ con SOUL.md + memoria inicial. Perfiles: programmer, writer, researcher
optimize [ruta]Sincroniza Obsidian vault → MEMORY.md + skills de Hermes
statusEstado de ~/.hermes/ y sus componentes
gepaInstrucciones para optimizar skills del agente con GEPA (auto-evolucion)

Opciones globales

claudio --help      Muestra la ayuda
claudio --version   Muestra la version instalada

Documentación detallada


Stack tecnologico

CategoriaTecnologia
RuntimeNode.js 20+
LenguajeTypeScript 5.x (ESM)
Package managerpnpm
Framework APIFastify
ValidacionZod
TestingVitest + Supertest
Coveragev8 (threshold 80%)
LinterESLint + Prettier
AI SDKOpenAI SDK / Anthropic SDK
DeployVercel

Comandos de desarrollo

pnpm install          # Instalar dependencias

# CLI
pnpm run claudio evoluciona           # Wizard interactivo
pnpm run claudio evoluciona ./target  # Instalar en directorio especifico
pnpm run claudio hermes install       # Clonar repo hermes-agent (solo git)

# Servidor de ejemplo
pnpm run dev          # Desarrollo con hot-reload (http://localhost:3000)
pnpm run build        # Compilar TypeScript a dist/
pnpm start            # Iniciar en produccion

# Calidad
pnpm run lint         # Ejecutar ESLint
pnpm run lint:fix     # ESLint con auto-fix
pnpm run format       # Formatear con Prettier

# Tests
pnpm test             # Todos los tests
pnpm run test:unit    # Solo tests unitarios
pnpm run test:int     # Solo tests de integracion
pnpm run test:e2e     # Solo tests end-to-end
pnpm run test:watch   # Tests en modo watch

Variables de entorno

cp .env.example .env
VariableDescripcionRequerida
NODE_ENVdevelopment / production / testSi
PORTPuerto del servidor (default: 3000)No
OPENAI_API_KEYAPI key de OpenAISi (para AI)
LOG_LEVELdebug / info / warn / errorNo

Pipeline lifecycle de auditoría

Complementa el pipeline de 7 equipos (orchestration.md) con un ciclo de 8 fases orientado a calidad por disciplina:

FaseAgente lifecycle
0 Intakelifecycle-scope-auditor
1 Arquitecturalifecycle-architecture-auditor
2 Diseñolifecycle-design-auditor
3 Seguridadlifecycle-security-auditor
4 Códigolifecycle-code-auditor
5 Testinglifecycle-test-auditor
6 DevExlifecycle-devex-auditor
7 Producciónlifecycle-production-auditor (GO/NO-GO)

Instalación: automática con claudio evoluciona → genera docs/AUDIT_STANDARDS.md, docs/AUDIT_AGENTS.md y 8 agentes.

Uso: /audit-pipeline [feature-id] o skill audit-pipeline.

Documentación: docs/AUDIT_PIPELINE.md


Adaptarlo a tu proyecto

claudio init ./mi-proyecto        # genera .claude/ + domain.md + context.md + audit lifecycle
claudio doctor

Refiná .claude/architecture.md y el glosario en .claude/rules/domain.md cuando el proyecto crezca. Obsidian es opcional → docs/ADVANCED.md.

Tipos de proyecto soportados

TipoAjuste necesario
API RESTMantener las capas, ajustar los services
Web App (React/Next.js)Agregar frontend layer, activar frontend-expert
CLI ToolReemplazar API layer por CLI parser (Commander/yargs)
MicroservicioAgregar communication layer (message queue)
ScraperReemplazar Agent service por Scraper con Playwright

Licencia

MIT

Ver o original no GitHub

Bom para

Relacionados