convez.ai
AgenteAutomaçãoAvançado
aveloz89

Claude Methodology

aveloz89/claude-methodology

Metodologia completa com agentes Claude para ciclo fullstack assistido

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema de agentes especializados, hooks e workflows para desenvolvimento fullstack com Claude Code. Implementa orquestração automática de brainstorming, design, implementação, review e merge com 8 agentes dedicados e 10 hooks de automação.

Instalação

$npx convez-ai aveloz89/claude-methodology

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
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 dias
Versão
—
Issues abertas
3
Contribuidores
2

Casos de uso

  • Estruturar fluxos de desenvolvimento fullstack com revisão de segurança e QA integrada
  • Automatizar enforçamento de TDD, test coverage (≥80%) e regras de merge
  • Coordenar múltiplos agentes especializados (arquiteto, devs, QA, security) em paralelo

Veredito

Solução robusta e bem arquitetada para equipes que querem CI/CD inteligente com agentes Claude. Exige conhecimento técnico solid (gitflow, testing, Docker) mas entrega automação real no ciclo de desenvolvimento.

README

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

Claude Code Methodology

Sistema de agentes especializados, hooks de automatización y workflows para desarrollo fullstack con Claude Code.

Qué incluye

Agentes (8)

AgenteModeloRol
orchestratoropusCoordina todo el flujo: brainstorming → diseño → implementación → review → merge
architectopusDiseña soluciones, define contratos/schemas, descompone en tareas atómicas
backend-devsonnetImplementa backend con TDD, gitflow, verificación pre-commit
frontend-devsonnetImplementa frontend (capa delgada, cero lógica de negocio)
db-specialistsonnetDiseño de esquemas, migraciones, optimización de queries
security-revieweropusAuditoría OWASP Top 10, secrets, dependencias (read-only)
qa-frontendsonnetUX, accesibilidad, componentes, estado UI, tests frontend, coverage ≥ 80%
qa-backendsonnetContratos de API, lógica de negocio, datos, tests backend, coverage ≥ 80%

Hooks (10)

HookEventoQué hace
pre-commit-guardPreToolUse (Bash)Corre tests antes de cada commit. Detecta pnpm/yarn/npm/pytest
pre-push-guardPreToolUse (Bash)Bloquea push directo a main
block-admin-mergePreToolUse (Bash)Bloquea gh pr merge --admin que bypasea branch protections
block-force-pushPreToolUse (Bash)Bloquea git push --force / -f
block-hard-resetPreToolUse (Bash)Bloquea git reset --hard
pre-merge-checkPreToolUse (Bash)Bloquea gh pr merge si hay comentarios, reviews o checks pendientes
post-pr-createPostToolUse (Bash)Instruye al orquestador para disparar security-reviewer + qa-frontend/qa-backend (según capas del diff) al crear un PR
session-start-contextSessionStartMuestra branch, último commit, estado de .planning/
context-monitorPostToolUse (Bash)Avisa cuando el contexto se está agotando (35% warning, 25% critical)
docker-refreshPostToolUse (Bash)Detecta si servicios Docker necesitan restart/rebuild después de push o PR. Respeta hot reload

Skills (1)

SkillQué hace
/new-projectScaffold de proyecto con gitflow, GitHub Actions CI/CD, CLAUDE.md

Workflow

Idea → Brainstorming (orchestrator pregunta) → Brief
  → Architect diseña + escribe schemas/contratos
  → Devs implementan con TDD (Red → Green → Refactor)
  → PR creado → Security + QA (qa-frontend y/o qa-backend según capas) review en paralelo
  → Si hay issues → Dev corrige en mismo PR → Re-review
  → Todos aprueban → Merge

Reglas enforced

  • 80% test coverage mínimo para mergear
  • Dual review obligatorio (security + QA frontend/backend según capas del diff)
  • TDD obligatorio (test antes que código)
  • Build debe compilar antes de commit
  • No push directo a main
  • No stubs/TODOs en código mergeado
  • Frontend delgado — cero lógica de negocio
  • Estado persistente en .planning/ — sobrevive cambios de sesión

Instalación

git clone https://github.com/TU_USUARIO/claude-methodology.git
cd claude-methodology
./install.sh --symlink   # Symlinks (cambios en repo se reflejan)
./install.sh --copy      # Copia independiente

Estructura

claude-methodology/
├── agents/
│   ├── architect.md
│   ├── backend-dev.md
│   ├── frontend-dev.md
│   ├── db-specialist.md
│   ├── qa-frontend.md
│   ├── qa-backend.md
│   └── security-reviewer.md
├── hooks/
│   ├── pre-commit-guard.sh
│   ├── pre-push-guard.sh
│   ├── block-admin-merge.sh
│   ├── block-force-push.sh
│   ├── block-hard-reset.sh
│   ├── pre-merge-check.sh
│   ├── post-pr-create.sh
│   ├── session-start-context.sh
│   ├── context-monitor.sh
│   └── docker-refresh.sh
├── skills/
│   └── new-project/
│       └── SKILL.md
├── settings.json
├── install.sh
└── README.md

Stack-agnóstico

Los agentes detectan el stack del proyecto leyendo CLAUDE.md. Funcionan con:

  • Node.js (pnpm/yarn/npm) + TypeScript/JavaScript
  • Python (pip/poetry) + pytest
  • Cualquier framework — el CLAUDE.md del proyecto define convenciones

El architect escribe schemas en la herramienta del proyecto (Zod, Pydantic, Go structs, etc.).

Ver o original no GitHub

Bom para

Relacionados