interviewing-plans/SKILL.md
Conduct dependency-aware plan interviews that interrogate every design branch until assumptions are resolved and shared understanding is explicit. Use when scoping features, refactors, architecture, migrations, or any plan with interdependent decisions.
npx skillsauth add sanurb/skills interviewing-plansInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Run a relentless, dependency-ordered interview until every decision in the plan is explicit, consistent, and acknowledged by both sides.
Use this skill when user asks for any of:
ask tool by default for branch decisions.decided, deferred-with-owner, or out-of-scope.MAP -> INTERVIEW -> RECONCILE -> COMPLETE
^ |
|--------------|
openblocked (waiting on dependency)decideddeferredout-of-scopeFor next eligible branch (open + dependencies resolved):
ask.After each branch decision, run consistency checks against prior decisions:
If conflict exists, stop traversal and resolve conflict first.
Only finish when:
open branches remainblocked branches remaindeferred branch has owner + trigger to revisitSelection order:
When discovery reveals a missing branch:
For each decision, probe at least 3 dimensions:
Escalate when needed:
Always end each response with:
---
Phase: <MAP|INTERVIEW|RECONCILE|COMPLETE>
Current branch: <id + name>
Resolved this turn: <decision ids or none>
Blocked by: <dependencies or none>
Next branch: <id + name>
Shared understanding: <0-100%>
Use this compact ledger internally and expose when useful:
| Branch | Status | Depends On | Decision |
|--------|--------|------------|----------|
| B0 Goal | decided | - | ... |
| B1 Constraints | decided | B0 | ... |
| B4 Architecture | open | B0,B1,B2,B3 | - |
Do not exit interview mode early unless user explicitly requests to stop. If user requests summary midstream, summarize and continue at next unresolved dependency.
| File | Purpose | |------|---------| | decision-branches.md | Canonical branch tree, dependency order, and branch-specific probe questions |
development
Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub, GitLab, fp, or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `fp-plan`, `fp-implement`, `fp-review`, `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
development
Build a throwaway prototype to flush out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
tools
Control herdr (a terminal-native agent multiplexer) from inside it. Manage workspaces and tabs, split panes, spawn sibling agents, read pane output, and wait for state changes — all via CLI commands that talk to the running herdr instance over a local unix socket. Use when running inside herdr (HERDR_ENV=1). Do not use outside herdr.
documentation
Compact the current conversation into a handoff document for another agent to pick up.