axel-pm/watch-n-learn / examples/find-your-unknowns
find-your-unknowns
VerifiedBefore turning an agent loose on a coding task, surface the decisions you never specified — the gaps between your prompt (the "map") and the real codebase (the "territory"). Runs six prompt patterns (blind-spot pass, brainstorm/prototype, interview-me, reference-as-map, implementation-notes logging, quiz-me) to enumerate unknowns and shape the architecture up front. Use when the user says "help me scope this before I build it", "what am I missing", "find my blind spots", "interview me about this feature", "I don't know this codebase / this domain, help me prompt better", "de-risk this before the big run", or "surface the unknowns" — and BEFORE kicking off a large or architecture-shaping agent run on an under-specified task.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| hooks/plan-mode-unknowns-nudge.shexecutable | script | 1.6 KB |
| references/prompt-patterns.md | markdown | 3.9 KB |
| settings-snippet.json | config | 747 B |
hooks/plan-mode-unknowns-nudge.sh
View on GitHub#!/usr/bin/env bash
# PreToolUse hook, matcher: ExitPlanMode
# Non-blocking nudge: fires as Claude presents a plan. Injects a reminder to
# surface unknowns (the find-your-unknowns skill) before the plan is finalized.
# Always exits 0 (allow) — never blocks. See ~/.claude/CLAUDE.md "## In plan mode".
cat >/dev/null # consume stdin payload, we don't need it
read -r -d '' NOTE <<'EOF'
Plan-mode backstop (find-your-unknowns): before finalizing this plan, confirm you surfaced
the decisions the request never specified — the gaps between the ask (the "map") and the
codebase (the "territory"). If this task is large, ambiguous, architecture-shaping, or in an
unfamiliar codebase/domain AND you have not yet done discovery, go back and run the relevant
patterns before presenting: blind-spot pass (unknown-unknowns), interview-me (prioritize
questions that change the architecture), reference-as-map, brainstorm/prototype (aesthetic
choices). Fold the surfaced unknowns and their resolutions into the plan, and include the
implementation-notes logging instruction so mid-build deviations keep surfacing. Skip only if
the task is small and fully specified. This is a reminder, not a block — the plan proceeds.
EOF
# Emit as compact JSON with additionalContext (jq if available, else hand-rolled escaping).
if command -v jq >/dev/null 2>&1; then
jq -n --arg ctx "$NOTE" \
'{hookSpecificOutput:{hookEventName:"PreToolUse", additionalContext:$ctx}}'
else
esc=${NOTE//\\/\\\\}; esc=${esc//\"/\\\"}; esc=${esc//$'\n'/ }
printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","additionalContext":"%s"}}\n' "$esc"
fi
exit 0
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |