Find the gap before it finds you.

Know Your Unknowns is a Claude Code plugin for discovering blind spots, shaping plans, and reviewing what changed during implementation.

From plan to reality

Before

What am I missing?

During

What changed, and why?

After

What should I verify before merging?

Make the unknowns visible while decisions can still change.

11 skillsUse the whole workflow or call one technique at a time.

2 agentsSupport independent investigation and review.

2 hooksGuard read-only work and prompt for deviation notes.

A working loop for uncertain tasks

Use /unknowns:unknowns-loop for a larger task, or invoke a single skill when you need one focused step.

blindspot inspects the work ahead. teach-me explains unfamiliar terms. interview helps turn missing decisions into a clearer request.

prototypes, brainstorm, and reference explore options. tweakable-plan orders decisions by how likely they are to change.

deviation-log records plan deviations. quiz checks understanding before merge. buy-in helps explain the result to reviewers.

Run these commands inside a Claude Code session. Start a new session or run /reload-plugins, then try /unknowns:blindspot test.

/plugin marketplace add ajitta/know-your-unknowns
/plugin install unknowns@know-your-unknowns

These are example prompts. The full README explains every skill and its triggers.

/unknowns:blindspot Add OAuth to this app

Investigate a domain or codebase before implementation.

/unknowns:tweakable-plan Add subscription renewal

Make a plan that exposes likely changes early.

/unknowns:quiz Quiz me before I merge this PR

Check what you understand about the finished work.