Artefatos de Pesquisa
A pesquisa registra a evidência externa por trás de uma decisão: avaliações de tecnologia, comparações de bibliotecas, levantamentos de práticas do setor. A pesquisa é datada, com fontes e somente de acréscimo — um instantâneo do que a evidência dizia em um ponto no tempo, não uma opinião em evolução.
Este skill define como a pesquisa é organizada, formatada e indexada. O skill deep-research define como ela é coletada e verificada de forma cruzada; living-docs detém as decisões e issues que ela alimenta. Os três se compõem. Artefatos de pesquisa são conceitos OKF — consulte o skill okf-knowledge-format para as regras de frontmatter/arquivos reservados aplicadas aqui.
Como usar este skill (divulgação progressiva)
Este SKILL.md é um stub enxuto — um gatilho mais um roteador de tarefa→tópico. O CLI living-docs contém as regras completas de pesquisa, disciplina de fontes, estrutura e cadeia rastreável, e as divulga progressivamente. Antes de escrever qualquer coisa, carregue o tópico para sua tarefa:
living-docs guide --list— descubra todos os tópicos.living-docs guide <tópico> --skill research-artifacts— carregue aquele tópico.
A saída canalizada é JSON minificado (padrão para máquina); --plain para texto humano, --json para forçar JSON. Tópicos: regras, estrutura, relatório-de-pesquisa, índice-de-pesquisa, referências-gerais-de-pesquisa, sobre.
Este stub é um roteador puro (ADR 0017): ele dispara e aponta para tópicos — não contém regras embutidas. A disciplina de fontes e a cadeia pesquisa → decisão → issue são tópicos, carregados antes da escrita via guide rules --skill research-artifacts / guide structure --skill research-artifacts.
Quando invocar
- Registrando a saída de uma sessão de pesquisa em
docs/research/—living-docs guide relatório-de-pesquisa --skill research-artifacts. - Estruturando ou indexando uma nota de pesquisa (
docs/research/NNNN-<slug>.md+ a listagem do índice + o resumo geral) —living-docs guide índice-de-pesquisa --skill research-artifacts/guide referências-gerais-de-pesquisa --skill research-artifactspara os modelos,guide structure --skill research-artifactspara as regras de layout. - Impondo disciplina de fontes em um rascunho (fontes primárias, sinalização de conflitos de interesse de fornecedores, rótulos de inferência vs. fato, níveis de confiança, notas de falha de busca) —
living-docs guide rules --skill research-artifacts. - Estabelecendo a cadeia rastreável pesquisa → decisão → issue (uma recomendação aceita deve alcançar um ADR e depois issues, em
living-docs) —living-docs guide structure --skill research-artifacts.