jeffecom

Sistema de workflow unificado para Claude Code — pipeline de orquestracao, memory bank, hooks e quality gates.

Instalacao

npx jeffecom

Isso instala no diretorio do seu projeto:

• .claude/hooks/ — 10 hooks + shared library
• .claude/commands/ — 26 slash commands
• .claude/rules/ — 11 regras de qualidade
• .claude/config/ — configuracao centralizada
• memory-bank/ — documentacao persistente
• CLAUDE.md — instrucoes do projeto

Com BMAD-METHOD (opcional)

npx jeffecom --with-bmad

Adiciona 12+ agent personas, 30+ workflows step-file (PRD, architecture, code review, sprint) do BMAD-METHOD.

Uso

Novo usuario? Comece pelo Guia de Inicio Rapido.

Apos instalar, abra Claude Code no projeto e use:

/configurar          # Configura MCPs, permissoes, plugins, safety
/carregar            # Carrega contexto do projeto (7 fases)
/orq <descricao>     # Executa pipeline de orquestracao (ate 9 fases)

Commands

| Comando | Descricao | |---------|-----------| | /orq | Pipeline de orquestracao (ate 9 fases: analyze, plan, implement, docs, test, security, review, refactor, deploy) | | /configurar | Configuracao interativa (MCPs, permissoes, plugins, safety) | | /validate | Validacao completa da stack (type-check, lint, testes, build) | | /status | Status do projeto (git, memory bank, saude) | | /carregar | Carrega contexto do projeto (7 fases) | | /squad | Visualiza pipeline de orquestracao | | /agents | Lista agents do pipeline | | /bootstrap | Scaffold de modulos, features e documentos | | /compact | Compacta contexto (salva checkpoint antes) | | /memory-init | Inicializa Memory Bank | | /memory-status | Status do Memory Bank | | /memory-update | Atualiza Memory Bank | | /metrics | Metricas da sessao de trabalho | | /release | Release com semantic versioning | | /restore | Restaura checkpoint do memory bank | | /docs | Gera/atualiza documentacao | | /prd | Criar PRD guiado (BMAD workflow) | | /code-review | Code review adversarial | | /quick-spec | Spec tecnico rapido (4 steps) | | /sprint | Sprint planning | | /retro | Retrospectiva de sprint | | /research | Research estruturado (market, domain, tech) | | /security-audit | Auditoria de seguranca OWASP standalone | | /analyze | Analise de escopo e complexidade sem pipeline | | /reviewer | Code review rapido baseado em patterns | | /refactor | Refatoracao standalone com metricas | | /db | Database migrations e ferramentas | | /deploy | Deploy com multiplas estrategias | | /setup | Setup inicial do projeto |

Pipeline de Orquestracao

FASE 1: ANALYZE   → Classifica L0-L5, mapeia escopo e riscos
FASE 2: PLAN      → Cria plano com steps e criterios (L1+)
FASE 3: IMPLEMENT → Executa plano, edita codigo, valida types
FASE 4: DOCS      → Gera/atualiza documentacao (L2+)
FASE 5: TEST      → Roda tsc, testes, valida criterios (L1+)
FASE 6: SECURITY  → Audit OWASP, deps, secrets (L3+)
FASE 7: REVIEW    → Code review, qualidade, aderencia (L1+)
FASE 8: REFACTOR  → Simplificacao DRY/KISS (L4+)
FASE 9: DEPLOY    → Deploy com rollback (L5 obrigatorio, L2+ condicional)

Hooks

| Hook | Evento | Funcao | |------|--------|--------| | session-start | SessionStart | Contexto + infra + stack | | validate-config | SessionStart | Valida config.json + alerta problemas | | confirmation-gate | PreToolUse (Edit/Write) | Verifica AskUserQuestion | | pipeline-state | PreToolUse (EnterPlanMode) | Detecta artefatos + valida gates | | post-edit-pipeline | PostToolUse (Edit/Write) | Quality checks + lint fix + tracking | | context-monitor | PostToolUse (Edit/Write) | Warnings 15%/8% (1M ctx) | | changelog-reminder | PostToolUse (Write) | Nudge CHANGELOG | | save-checkpoint | PreCompact | Checkpoint ACTIVE.md | | statusline | Notification | Barra visual | | update-active | Stop | Lembrete ACTIVE.md |

Configuracao

Apos instalar, use /configurar para customizar:

• MCPs: Context7, Playwright, GitHub, Filesystem, Fetch
• Permissoes: Permissivo, Moderado ou Restrito
• Pipeline: Interactive ou Yolo
• Quality Gates: Plan approval, testes, review, docs
• Safety: Bloqueia .env, secrets, force push
• TDD: Opcional (red-green-refactor)

Configs armazenadas em .claude/config/config.json e .claude/settings.json.

BMAD-METHOD

O jeffecom integra opcionalmente o BMAD-METHOD, um framework de desenvolvimento agil com IA.

A integracao adiciona:

• Agent Personas: Agents ganham identidade, estilo e principios (Analyzer→Mary/John, Planner→Winston, Implementer→Amelia, Tester→Quinn)
• 30+ Workflows: PRD guiado, code review adversarial, sprint planning, research estruturado
• Step-File Architecture: Micro-files sequenciais com just-in-time loading
• WIP Tracking: Resume automatico de trabalho interrompido

# Instalar BMAD em projeto ja com jeffecom:
node .claude/bin/bmad-setup.js

Re-instalacao

npx jeffecom --force    # Sobrescreve hooks, commands, rules
npx jeffecom --dry-run  # Mostra o que seria feito

Requisitos

• Node.js >= 18.0.0
• Claude Code CLI

Licenca

MIT