Fact Find
Fast, focused answers to specific factual questions about Bottlerocket with proper citations.
Purpose
Quickly find and cite concrete facts about Bottlerocket:
- Configuration values and defaults
- Partition schemes and disk layouts
- Systemd units and targets
- File paths and locations
- Version numbers and dependencies
When to Use
- Need a specific fact, not an explanation
- Question has a concrete, definitive answer
- Looking for "what is" or "where is" information
For broader questions about architecture or design, use deep-research instead.
Procedure
1. Search
Create a focused query with key terms:
crumbly search "specific terms from question"
Check top 3-5 results for relevant files.
2. Read
Read the most relevant files to find the answer:
# Pattern search for targeted reading
grep -n "relevant terms" path/to/file.md
# Full file if needed
cat path/to/file.md
3. If Documentation Is Insufficient
Crumbly indexes documentation, not source code. If you can't find the answer in docs, search the codebase directly:
# IMPORTANT: Always scope searches to specific directories!
# The forest is 80GB+ - unscoped searches will hang.
rg "search_term" --type rust bottlerocket/sources/
find bottlerocket/sources -name "*relevant_name*"
This indicates a documentation gap - note it in your Research Quality Indicator.
4. Answer with Citations
Provide a direct, concise answer with inline superscript citations and a Sources section:
Bottlerocket uses a dual partition scheme with sets A and B <sup>[1]</sup>. The default API socket is `/run/api.sock` <sup>[2]</sup>.
## Sources
<sup>[1]</sup> [`sources/updater/signpost/README.md`](../sources/updater/signpost/README.md)
- Partition set structure
<sup>[2]</sup> [`sources/api/README.md`](../sources/api/README.md)
- API socket configuration
Citation guidelines:
- Use
<sup>[1]</sup>,<sup>[2]</sup>, etc. inline with facts - Paths relative to the target repository
- Markdown links for file paths
- GitHub URLs for cross-repo references:
https://github.com/bottlerocket-os/REPO/blob/develop/FILE.md - Brief bullet points describing what each source provided
Validation
A good fact-find response:
- ✓ Directly answers the specific question
- ✓ Concise (2-4 sentences typically)
- ✓ Superscript citations inline
- ✓ Sources section with numbered references
- ✓ No unnecessary context or explanation
Research Quality Indicator
End your response with:
- ✅ Answered from documentation - Found in README files, design docs, or narrative documentation.
- ⚠️ Answered from source code - Had to read implementation files due to insufficient documentation.
- 🔍 Partial documentation - Required both docs and source code to answer fully.