Skip to content

axel-pm/watch-n-learn / examples/find-your-unknowns

find-your-unknowns

Verified

Before 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.

FileKindSize
SKILL.mdskill md5.2 KB
hooks/plan-mode-unknowns-nudge.shexecutablescript1.6 KB
references/prompt-patterns.mdmarkdown3.9 KB
settings-snippet.jsonconfig747 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
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall