O que PDL-Standard faz?
Uma habilidade do Codex que permite confirmar o que uma IA entendeu e como planeja responder antes de agir, usando pseudocódigo legível.
Visão Geral
O PDL-Standard (Plano de Decisão Lógica Padrão) é um protocolo para que assistentes de IA, como o Codex, comuniquem seu entendimento e plano de ação ao desenvolvedor antes de executar qualquer alteração. Isso promove transparência, reduz riscos e permite correções no início do processo.
Como Usar
- Faça uma solicitação ao assistente (ex.: "Refatore esta função para usar async/await").
- O assistente responde com um PDL estruturado em bloco de código contendo:
- Compreensão: O que a IA interpretou sobre o problema.
- Plano: Etapas lógicas que pretende seguir (em pseudocódigo).
- Impacto: Arquivos ou partes do sistema que serão afetados.
- Revise o PDL e, se necessário, solicite ajustes.
- Confirme com "aprovar" ou "OK" para que a IA execute o plano.
Exemplo de PDL
# Compreensão
- O usuário deseja substituir callbacks aninhados por async/await no arquivo `dataService.js`.
- A função `fetchData` será refatorada para usar `async/await`.
# Plano
1. Adicionar `async` à declaração de `fetchData`.
2. Substituir `new Promise((resolve, reject) => { ... })` por `try/catch` com `await`.
3. Atualizar chamadas da função para usar `await` (se estiverem em funções `async`).
# Impacto
- `src/dataService.js`: bloco principal alterado.
- `src/controllers/*.js`: possíveis atualizações se dependências diretas.
Benefícios
- Prevenção de erros: Evita que a IA execute ações indesejadas.
- Colaboração: Permite que o desenvolvedor guie e corrija o entendimento da IA.
- Documentação: O PDL serve como um registro do raciocínio aplicado.
- Controle: Desenvolvedor mantém a palavra final antes de qualquer execução.
Plataformas Suportadas
- Codex (OpenAI) – principal plataforma alvo.
- Pode ser adaptado para outros assistentes de codificação (Cursor, Claude Code, etc.) com modificações.
Notas Técnicas
- O formato PDL é texto simples legível por humanos, não requer parser especial.
- Os comandos "aprovar" ou "OK" disparam a execução; outros comandos podem solicitar revisão.
- Para segurança, o assistente não deve executar o plano sem confirmação explícita.
Habilidade original: paragon-ux/PDL-Standard