Fact Find
Respostas rápidas e focadas para perguntas factuais específicas sobre o Bottlerocket, com citações adequadas.
Propósito
Encontre rapidamente e cite fatos concretos sobre o Bottlerocket:
- Valores de configuração e padrões
- Esquemas de partição e layouts de disco
- Unidades e alvos do systemd
- Caminhos e locais de arquivos
- Números de versão e dependências
Quando Usar
- Precisa de um fato específico, não de uma explicação
- A pergunta tem uma resposta concreta e definitiva
- Procurando informações do tipo "o que é" ou "onde está"
Para perguntas mais amplas sobre arquitetura ou design, use deep-research.
Procedimento
1. Pesquisar
Crie uma consulta focada com termos-chave:
crumbly search "termos específicos da pergunta"
Verifique os 3-5 primeiros resultados em busca de arquivos relevantes.
2. Ler
Leia os arquivos mais relevantes para encontrar a resposta:
# Pesquisa de padrão para leitura direcionada
grep -n "termos relevantes" caminho/para/arquivo.md
# Arquivo completo, se necessário
cat caminho/para/arquivo.md
3. Se a Documentação For Insuficiente
O Crumbly indexa documentação, não código-fonte. Se você não encontrar a resposta na documentação, pesquise diretamente no código-fonte:
# IMPORTANTE: Sempre escopo as pesquisas para diretórios específicos!
# O repositório tem mais de 80 GB - pesquisas sem escopo podem travar.
rg "termo_de_busca" --type rust bottlerocket/sources/
find bottlerocket/sources -name "*nome_relevante*"
Isso indica uma lacuna na documentação - anote isso no Indicador de Qualidade da Pesquisa.
4. Responder com Citações
Forneça uma resposta direta e concisa com citações em sobrescrito inline e uma seção de Fontes:
O Bottlerocket usa um esquema de partição dupla com conjuntos A e B <sup>[1]</sup>. O socket da API padrão é `/run/api.sock` <sup>[2]</sup>.
## Fontes
<sup>[1]</sup> [`sources/updater/signpost/README.md`](../sources/updater/signpost/README.md)
- Estrutura do conjunto de partições
<sup>[2]</sup> [`sources/api/README.md`](../sources/api/README.md)
- Configuração do socket da API
Diretrizes de citação:
- Use
<sup>[1]</sup>,<sup>[2]</sup>, etc. inline com os fatos - Caminhos relativos ao repositório de destino
- Links Markdown para caminhos de arquivos
- URLs do GitHub para referências entre repositórios:
https://github.com/bottlerocket-os/REPO/blob/develop/FILE.md - Breves marcadores descrevendo o que cada fonte forneceu
Validação
Uma boa resposta de fact-find:
- ✓ Responde diretamente à pergunta específica
- ✓ Concisa (geralmente 2-4 frases)
- ✓ Citações em sobrescrito inline
- ✓ Seção de Fontes com referências numeradas
- ✓ Sem contexto ou explicação desnecessários
Indicador de Qualidade da Pesquisa
Encerre sua resposta com:
- ✅ Respondido a partir da documentação - Encontrado em arquivos README, documentos de design ou documentação narrativa.
- ⚠️ Respondido a partir do código-fonte - Precisou ler arquivos de implementação devido à documentação insuficiente.
- 🔍 Documentação parcial - Exigiu tanto documentação quanto código-fonte para responder completamente.