PDD - Patch-Driven Development

Entregue mudancas seguras em sistemas reais.

PDD e um framework orientado a CLI para bugfix e evolucao de features em sistemas existentes.
Ele padroniza como o time investiga, planeja, valida e documenta mudancas.

Versoes por idioma: README padrao | English

Por que usar PDD

• Execucao worktree-first para desenvolvimento paralelo mais seguro
• Artefatos estruturados de mudanca (delta-spec, patch-plan, verification-report)
• Fluxo consistente para Cursor, Claude Code e GitHub Copilot
• Quality gates nativos (doctor, validacao e checagens de CI)

Instalacao

Requisitos:

• Node.js >= 18
• Git disponivel no PATH

Executar sem instalacao global (recomendado):

npx @pcoliveira90/pdd --version

Instalacao global (opcional):

npm install -g @pcoliveira90/pdd
pdd --version

Inicio rapido

# 1) Inicialize o PDD no repositorio atual
npx @pcoliveira90/pdd init --here

# 2) Rode um fluxo de correcao
npx @pcoliveira90/pdd fix "login nao salva incomeStatus"

Comandos principais

pdd init --here
pdd doctor
pdd status
pdd fix "descricao do bug" [--dry-run] [--no-validate] [--open-pr]
pdd version

Comando de analise por IA:

pdd-ai --provider=openai --task=analysis "descricao do bug"

Resumo do fluxo

1. Entender comportamento atual e causa raiz
2. Gerar artefatos em changes/<change-id>/
3. Validar testes/lint/build
4. Preparar artefatos de PR e revisar na IDE

Alinhamento entre IDEs

O PDD mantem intencoes equivalentes entre ferramentas:

• Cursor: .cursor/commands/pdd-*.md
• Claude Code: .claude/commands/pdd-*.md
• GitHub Copilot: .github/prompts/pdd-*.prompt.md

Documentacao

• docs/getting-started.md
• docs/installation-and-setup.md
• docs/fix-workflow.md
• docs/manifesto.md

Objetivo

Motor de execucao confiavel para mudancas seguras em software real.