# Assumption Tracker

> Explicitly track, test, and validate assumptions - prevent blind spots

- Skill: `majiayu000/assumption-tracker` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/assumption-tracker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/assumption-tracker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/assumption-tracker

---


# Skill: assumption-tracker

## What I do

I surface and manage hidden assumptions. I ensure that every leap of faith in a design or plan is documented, tiered by risk, and systematically validated through evidence or testing.

## When to use me

- Before starting a new feature or architectural change
- When requirements are ambiguous or "common sense" is invoked
- During technical planning sessions to identify "we think" vs "we know"
- When evaluating third-party libraries or external API behaviours

## Core principles

1. **Surface the hidden** — If it isn't proven, it's an assumption.
2. **Tier by risk** — Focus validation on assumptions with high impact and low certainty.
3. **Validate early** — Use spikes, prototypes, or data lookups to turn assumptions into facts.
4. **Document outcomes** — Record whether an assumption was proven true or false.

## Patterns & examples

**Assumption Logging Format:**
| Assumption | Impact (H/M/L) | Certainty (H/M/L) | Validation Method | Status |
| :--- | :--- | :--- | :--- | :--- |
| "The legacy API supports concurrent writes." | High | Low | Run concurrency spike test | Pending |
| "Users prefer the sidebar over the top nav." | Medium | Medium | Review GA click maps | Validated |

**Validation Techniques:**
- **Spike:** Write a small, throwaway script to test a technical hypothesis.
- **Prototype:** Build a minimal UI to verify user interaction assumptions.
- **Data Lookup:** Query logs or databases to confirm usage patterns.

## Anti-patterns to avoid

- ❌ **"Trust me" logic** — Relying on seniority instead of evidence.
- ❌ **Validation lag** — Building a full system on unverified, high-risk assumptions.
- ❌ **Silent assumptions** — Failing to voice doubts during the planning phase.

## KB Reference

`~/vaults/baphled/3. Resources/Knowledge Base/AI Development System/Skills/Thinking-Analysis/Assumption Tracker.md`

## Related skills

- `critical-thinking` — Rigorous analysis of claims
- `epistemic-rigor` — Distinguishing belief from knowledge
- `prove-correctness` — Evidence-based validation
- `pre-action` — Deliberate thinking before execution