Orchestra-Research/Registro-de-Pesquisa-com-IA

O que Registro-de-Pesquisa-com-IA faz?

Grava a proveniência da pesquisa como um epílogo pós-tarefa, digitalizando o histórico da conversa ao final de uma sessão de codificação ou pesquisa para extrair decisões, experimentos, becos sem saída, afirmações, heurísticas e pivôs, escrevendo-os no diretório ara/ com tags de proveniência usuário-vs-IA. Use como epílogo de sessão — nunca durante a execução — para manter um rastro fiel e auditável de como um projeto de pesquisa realmente evoluiu.

Como usar

Após concluir uma sessão de trabalho (codificação, pesquisa, etc.), execute este comando para acionar a skill:

orchestra-research extract-provenance

Isso irá:

1. Digitalizar o histórico da conversa recente.
2. Identificar seções relevantes: decisões, experimentos, becos sem saída, afirmações, heurísticas e pivôs.
3. Escrever arquivos markdown em ara/ com a estrutura apropriada.
4. Adicionar tags de proveniência (ex: #autor:usuário ou #autor:IA) para cada registro.

Estrutura de saída

Os arquivos serão salvos em ara/ com a seguinte nomenclatura:

• decisoes.md
• experimentos.md
• becos-sem-saida.md
• afirmacoes.md
• heuristicas.md
• pivos.md

Cada arquivo contém uma lista de itens extraídos, com data/hora, descrição e tag de proveniência.

Requisitos

• Acesso ao histórico da conversa (API ou logs locais).
• Diretório ara/ deve existir ou ser criado pela skill.
• Permissão de escrita no diretório do projeto.

Notas

• Não usar durante a execução de tarefas para evitar contaminação do histórico.
• Ideal para projetos de pesquisa longos ou iterativos que precisam de rastreabilidade.
• Pode ser integrado em fluxos de CI/CD para registrar proveniência automaticamente.

Exemplo de saída

arquivo: ara/decisoes.md

# Decisões

## 2023-10-05 14:30

- **Decisão:** Utilizar a biblioteca XYZ para parsing de dados.
  - **Autor:** usuário
  - **Contexto:** Precisávamos de uma solução leve e bem documentada.
  - **Alternativas consideradas:** ABC parser, manual regex.

## 2023-10-05 15:00

- **Decisão:** Abandonar a abordagem de cache local.
  - **Autor:** IA
  - **Contexto:** Testes mostraram alta latência devido a I/O.
  - **Alternativas consideradas:** Cache distribuído com Redis.

arquivo: ara/experimentos.md

# Experimentos

## 2023-10-05 14:45

- **Experimento:** Testar performance do algoritmo A vs B.
  - **Autor:** IA
  - **Resultado:** Algoritmo A 20% mais rápido.
  - **Conclusão:** Seguir com Algoritmo A.