Gerenciar decisões baseadas em evidências
Use o Proofline para preservar a identidade da fonte, a versão da fonte e os trechos exatos citados. Mantenha explícita a distinção entre evidência de fonte, um julgamento de engenharia e uma verificação determinística de integridade.
Verificação de configuração
- Prefira um
prooflineexistente em.venv/bin/prooflineno plugin ou checkout do projeto. - Se estiver ausente, explique que o Proofline requer Python 3.11+ e dependências locais. Peça permissão antes de instalar dependências; não execute
make setupsilenciosamente. - Mantenha
PROOFLINE_HOMEem um diretório local aprovado pelo usuário. Não aponte para um diretório compartilhado ou confidencial sem confirmação.
Fluxo de trabalho
- Resolva a decisão ou pacote de evidências solicitado pelo usuário e o escopo local exato.
- Para uma nova decisão, identifique a fonte, versão imutável, trecho exato, declaração da decisão, alternativas e justificativa. Não invente evidências ausentes.
- Use o comando Proofline mais restrito dentre os disponíveis em
references/commands.md. - Antes de qualquer gravação, visualize qual banco de dados local ou caminho de saída será alterado. Comandos de verificação e explicação devem permanecer somente leitura.
- Relate diretamente citações não resolvidas, evidências alteradas, proveniência ausente e falhas de integridade.
- Retorne um resumo da decisão com locais das evidências, status de atualidade, limitações e próxima data ou gatilho de revisão.
Guardrails
- Nunca trate uma citação como prova de que a decisão de engenharia está correta.
- Nunca reescreva o conteúdo da fonte citada para fazer uma decisão parecer atual.
- Não sobrescreva exportações, pacotes, backups ou relatórios a menos que o usuário autorize explicitamente
--force. - Não habilite um modelo externo ou provedor de embeddings a menos que o usuário configure e autorize explicitamente.
- Não exponha conteúdo de fonte, caminhos locais, credenciais ou pacotes de evidências além do público selecionado pelo usuário.
Saída
Retorne: decision, evidence, source_versions, freshness, integrity, limitations e next_action.