Assumption Archaeologist
- Updated June 26, 2026
- Bouwles/assumption-archaeologist
Assumption Archaeologist is a Claude Code marketplace plugin that records load-bearing implicit code assumptions in ASSUMPTIONS.md so developers can review and track what the code silently depends on.
About
Assumption Archaeologist is a Claude Code marketplace plugin that excavates implicit, load-bearing assumptions embedded in code and records them in a living ASSUMPTIONS.md. Developers invoke it during review when unstated beliefs about timezones, sorting, auth, or nullability need documentation before they cause production bugs. It never scans in the background; search and verify run only when you call the slash commands.
- Command-only—no background hooks or silent token burn
- /assumptions:search writes load-bearing entries to ASSUMPTIONS.md
- /assumptions:verify updates addressed or stale statuses
- Dedupes via hidden aa:id markers without clobbering notes
- Default scope is git-changed files
Assumption Archaeologist by the numbers
- Data as of Jul 10, 2026 (Skillselion catalog sync)
/plugin marketplace add Bouwles/assumption-archaeologistAdd your badge
Show developers this marketplace is listed on Skillselion. Paste this into your README.
| Last updated | June 26, 2026 |
|---|---|
| Repository | Bouwles/assumption-archaeologist ↗ |
What unstated assumptions in your code will become production bugs because nobody wrote them down?
Install Assumption Archaeologist to surface load-bearing implicit code assumptions into ASSUMPTIONS.md via explicit /assumptions commands.
Who is it for?
Developers reviewing or hardening codebases who want an explicit, living assumptions register without ambient scanning cost.
Skip if: Teams wanting continuous automatic static analysis without invoking commands or those who do not maintain markdown engineering docs.
What you get
ASSUMPTIONS.md gains deduped entries with risk, status lifecycle, and verification updates while source files stay read-only except for that doc.
Plugins in this marketplace
1 plugin - install individually after you add the marketplace.
Recommended Marketplaces
FAQ
Does it edit my source files?
Search is read-only on source; the only write target is ASSUMPTIONS.md at the repo root.
What counts as load-bearing?
An assumption is recorded only if falsifying it would cause a real bug; trivia is skipped to keep the doc dense.
Can I edit ASSUMPTIONS.md by hand?
Yes—re-runs dedupe via aa:id markers and refresh details without overwriting your notes or status edits.