unknowns
v0.6.0Know your unknowns — an operational loop for finding and managing the gaps between the map (your plan) and the territory (the actual code and domain). Provides blind-spot investigation (blindspot), domain primers (teach-me), interviews, divergent prototypes, solution brainstorming, reference analysis, tweak-likelihood-ordered planning (plan), deviation notes (notes), independent verification, buy-in documents, and comprehension quizzes as skills/agents/hooks. Based on Thariq Shihipar's (Anthropic) 'Field Guide to Fable' talk and its 'Know your unknowns' example collection.
By choshLicense: MIT1 GitHub starsUpdated 2 weeks ago
Directory evidence
- Runtimes
- Claude Code
- Parsed components
- 11 skill or MCP entries
- Source updated
- Sep 6, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install unknowns for Claude Code
claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install unknowns@agent-plugin-marketplacePaste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/ajitta/know-your-unknownsClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.
Plugin files
├── .claude-plugin/plugin.json├── skills/blindspot/SKILL.md├── skills/brainstorm/SKILL.md├── skills/buy-in/SKILL.md├── skills/interview/SKILL.md├── skills/loop/SKILL.md├── skills/notes/SKILL.md├── skills/plan/SKILL.md├── skills/prototypes/SKILL.md├── skills/quiz/SKILL.md├── skills/reference/SKILL.md└── skills/teach-me/SKILL.md
Included Skills11
Blind-spot pass — investigate unknown unknowns before implementation and turn them into a better prompt. Use when the user says "blind spot pass", "what am I missing", "unknown unknowns", or before work in an unfamiliar codebase area. Not for routine, well-understood tasks.
Brainstorm the intervention — spread ~10 codebase-grounded candidates from ship-this-afternoon to quarter-long bet. Use on "brainstorm interventions", "show me options", or a problem named with no approach chosen. NOT for UI/design variants — use prototypes.
The buy-in doc — a ship-readiness pitch that leads with a working demo, pre-answers reviewer objections with evidence, states limitations, and names who must sign off. Use when the user says "buy-in doc", "prep me for review", or before requesting review/approval/merge.
Pre-implementation interview — the model asks the user the questions that turn known unknowns into decisions, biggest blast radius first. Use when the user says "interview me", "ask me questions before implementing", or requirements are incomplete and implementation has not started.
Run the know-your-unknowns workflow end to end (explore → question → plan → implement → verify → quiz) on significant or ambiguous work. Use on "unknowns loop", "run the operating loop", "know your unknowns". A bare "loop" means the built-in interval runner, not this skill.
Implementation notes — log significant deviations from the plan while working. Use automatically when implementation hits an unknown the plan did not cover, and on "implementation notes", "record a deviation", "where did we diverge from the plan?".
The tweakable plan — a plan sorted by likelihood-of-tweaking, not execution order, so the most changeable decisions get reviewed first. Use on "plan this", "make a plan", "tweakable plan". Not native plan mode: writes a reviewable pre-implementation document.
Divergent prototype fan-out — N (default 4) prototypes with clearly different design philosophies to react to. Use when the user says "divergent prototypes", "design options", or cannot say what they want ("know it when I see it") for a UI, dashboard, or API design.
Post-work comprehension quiz — explain what changed, then quiz the user so they can represent the work in a PR or handoff. Use when the user says "quiz me", "test my understanding", or right before creating or merging a PR for work the model largely implemented.
Point at a reference — treat a provided example as a map, not an answer, and prove comprehension before implementing. Use when the user says "use this as a reference", "make it like this", or supplies example code, a mockup, or a competitor's UX to build from.
Teach me my unknowns — an interactive explainer for a domain's vocabulary and mental model, so vague requests become precise. Use on "teach me", "make me an explainer", or when the user cannot name what they want. Blindspot investigates a codebase; teach-me teaches vocabulary.
Plugin manifests1
{
"name": "unknowns",
"version": "0.6.0",
"homepage": "https://github.com/ajitta/know-your-unknowns",
"repository": "https://github.com/ajitta/know-your-unknowns",
"description": "Know your unknowns — an operational loop for finding and managing the gaps between the map (your plan) and the territory (the actual code and domain). Provides blind-spot investigation (blindspot), domain primers (teach-me), interviews, divergent prototypes, solution brainstorming, reference analysis, tweak-likelihood-ordered planning (plan), deviation notes (notes), independent verification, buy-in documents, and comprehension quizzes as skills/agents/hooks. Based on Thariq Shihipar's (Anthropic) 'Field Guide to Fable' talk and its 'Know your unknowns' example collection.",
"author": {
"name": "chosh",
"email": "[email protected]"
},
"keywords": [
"unknowns",
"workflow",
"blind-spot",
"prompting",
"agentic-coding",
"html-artifacts"
],
"license": "MIT"
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[unknowns on Agent Plugins Marketplace](https://pluginsmp.com/plugins/unknowns)