PIX Claude Dev Kit

CLI tool para configurar Specification-Driven Development com Claude AI em projetos PIX.

🚀 Instalação Global

npm install -g @pix/claude-dev-kit

📦 Uso

Inicializar em um projeto

cd seu-projeto-pix
pix-claude init

Gerar documentação SDD automaticamente

Após instalar, use a skill inteligente que analisa seu código:

# No Claude Code, execute:
/sdd-generate

Isso vai:

• Analisar seu codebase automaticamente
• Fazer 3-5 perguntas pontuais
• Gerar toda documentação SDD (CLAUDE.md, TECH_STACK.md, etc.)

Alternativa manual (legacy):

pix-claude customize              # Mostra guia manual
pix-claude customize --interactive # Wizard interativo

Validar instalação

pix-claude validate

Atualizar componentes

pix-claude update

Atualizar apenas componentes específicos:

pix-claude update --agents    # Apenas agents
pix-claude update --skills    # Apenas skills
pix-claude update --templates # Apenas templates

Nota: Arquivos SDD são específicos do projeto e não são atualizados. Re-execute /sdd-generate para regenerá-los.

📋 Fluxo de Trabalho

1. Instalar: pix-claude init
2. Gerar documentação: /sdd-generate (analisa código e gera SDD automaticamente)
3. Validar: pix-claude validate
4. Usar: /spec-pix:plan "Sua feature"

🎯 Skills Disponíveis

Setup

• /sdd-generate - Gerar documentação SDD automaticamente

Desenvolvimento

• /spec-pix:plan - Planejar nova feature
• /spec-pix:execute - Executar implementação
• /spec-pix:test - Executar testes
• /spec-pix:review - Revisar código
• /spec-pix:finalize - Finalizar feature
• /spec-pix:status - Ver status de features
• /spec-pix:continue - Sugestões de continuação

📚 Documentação

Após instalação, veja:

• .claude/QUICK_START.md - Início rápido
• .claude/SKILLS_GUIDE.md - Guia de skills
• .claude/specs/README.md - Documentação completa
• .claude-customize.md - Guia de customização

🛠️ O que é instalado?

Componentes fixos (atualizáveis via pix-claude update)

• 6 Agents especializados (spec-writer, tech-lead, dev-expert, qa-tester, doc-writer, code-reviewer)
• 8 Skills de workflow (sdd-generate + 7 spec-pix-*)
• Templates de specs/plans/progress

Documentação gerada (via /sdd-generate)

• CLAUDE.md (visão geral do projeto)
• Arquivos em .claude/sdd/ (gerados dinamicamente baseados no código):
  • TECH_STACK.md, ARCHITECTURE.md, DOMAIN_MODEL.md, API.md, etc.
  • Quantidade e tipos de arquivos variam conforme complexidade do projeto

📄 Licença

MIT