deep-interview
Skill4 starsChanged todayMITView on GitHub
[oh-my-agy] Socratic deep interview with quantitative ambiguity gating before planning or execution. Use when a request is broad, ambiguous, or missing acceptance criteria, or when the user says 'deep interview', 'interview me', 'ask me everything', 'don't assume', or 'ouroboros'. Supports --quick, --standard (default), --deep, --ideate, and --autoresearch.
22 other projects use a version of this, 2 of them edited.
Adopted by
Most recently taken up by
- xSolutions365/skillstheir own version, first seen Nov 16, 2026
- Yeachan-Heo/oh-my-claudecodetheir own version, first seen Nov 9, 2026
- lza6/claw-code-tingfengedited, first seen Nov 1, 2026
- Ji-Hu/agent_skilltheir own version, first seen Nov 1, 2026
- ihyonoo/skillstheir own version, first seen Oct 20, 2026
- klauswg/sasuketheir own version, first seen Oct 15, 2026
Used with
Projects with it also use ultrawork, visual-verdict and 3 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
zephyrpersonalSkillultrawork
Obsessive task completion mode (Sisyphus Mode) - activates maximum intensity work with todo continuation enforcement
Also in 5 projects that use this
LucasCooperBeySkillvisual-verdict
Structured visual QA verdict for screenshot-to-reference comparisons. Returns JSON scores driving edit iterations. Use after any UI implementation to verify visual fidelity.
Also in 3 projects that use this
woosikkimSkilldeepinit
Generate hierarchical AGENTS.md codebase maps for agent context
Also in 3 projects that use this
joker-yeSkillgit-master
Git expert for atomic commits, rebasing, and history management with style detection
Also in 3 projects that use this
thoughtbotSkilltrace
Run a scenario and record what actually happened.
Also in 4 projects that use this
Other versions22 projects use a version of this.
Word for word · 0
None found.
Edited · 2
- Yeachan-Heo/oh-my-codex★ 34k16% same
- lza6/claw-code-tingfeng★ 514% same
Wrote their own version · 20
- Yeachan-Heo/oh-my-claudecode★ 41ksame name
- Yeachan-Heo/oh-my-claude-sisyphus★ 41ksame name
- zereight/gitlab-mcp★ 2.1ksame name
- diodeme/Gold-Band★ 165same name
- devbrother2024/skills★ 91same name
- tranhieutt/software_development_department★ 71same name
- klauswg/sasuke★ 17same name
- jscraik/Agent-Skills★ 9same name
- sean2077/skills★ 5same name
- an8079/take-skills★ 4same name
10 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- rules/AGENTS.mdAGENTS.md
- ai-slop-cleanerSkill
- analyzeSkill
- askSkill
- autopilotSkill
- cancelSkill
- code-reviewSkill
- deep-researchSkill
- doctorSkill
- hudSkill
- loftSkill
- modernizeSkill
- performance-goalSkill
- prSkill
- ralplanSkill
- releaseSkill
- skillSkill
- teamSkill
- threat-modelSkill
- ultragoalSkill
- ultraqaSkill
- visual-ralphSkill
- wikiSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
26 rules. 0 are common, 15 are distinctive, and 11 are very specific to this project.
0
Common
Most of the 14 edited versions we read keep these.
15
Distinctive
This author's own choices. Worth a look.
11
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
Ask ONE question per round.
- Distinctive: line 36
Ask about intent and boundaries before implementation detail.
- Distinctive: line 38
Treat every answer as a claim to pressure-test.
- Distinctive: line 39
Do not rotate to a new dimension just for coverage while the current answer is still vague.
- Distinctive: line 40
Before crystallizing, complete at least one explicit pressure pass that revisits an earlier answer with a deeper assumption- or …
- Very specific: line 42
Always run preflight context intake before the first question.
- Distinctive: line 43
Treat existing repo language as evidence, not authority.
- Distinctive: line 45
Use scenario-based edge-case grilling when a boundary or handoff is unclear: invent one concrete scenario that stresses it, then ask one …
- Distinctive: line 47
If initial context is oversized, do not paste it into prompts.
- Very specific: line 54
When ambiguity depends on current external best practices or version-aware behavior, use $deep-research --quick before crystallizing.
- Distinctive: line 63
Do not hand off while ambiguity is above threshold unless the user explicitly opts to proceed with a warning.
- Very specific: line 64
Do not crystallize or hand off while Non-goals or Decision Boundaries remain unresolved, even if the score meets threshold.
- Very specific: line 69
Use Antigravity's ask_question tool for every interview round.
- Very specific: line 71
No-Questions Override: do not call ask_question or ask the user when they have explicitly said not to ("don't ask", "no questions", "do not …
- Distinctive: line 76
If one selected option would immediately need a follow-up to disambiguate the others, ask a single-answer round now and the follow-up next.
- Very specific: line 78
If ask_question is unavailable (for example in a headless run), ask exactly one concise plain-text question and wait for the answer.
- Very specific: line 79
If the user skips a question, record that as [from-user] skipped, lower confidence for that dimension, and choose the next-highest-leverage …
- Distinctive: line 88
Check whether the initial context or loaded snapshot is too large for safe prompt use.
- Distinctive: line 89
If no snapshot exists, create one containing: task statement.
- Distinctive: line 130
If oversized context has no recorded summary, the only allowed question is the summary request.
- Very specific: line 135
Use ask_question as described in <Asking_Questions>.
- Very specific: line 149
Use each mode at most once when triggered (Contrarian, Terminologist, Simplifier, Ontologist.
- Distinctive: line 153
When threshold is met (or on early exit with a warning, or at the hard cap):
- Very specific: line 156
Write the transcript summary to .omagy/interviews/{slug}-{timestamp}.md.
- Very specific: line 157
Write the execution-ready spec to .omagy/specs/deep-interview-{slug}.md following the 9-section template (including the Affected User Ideal …
- Distinctive: line 183
All dimensions >= 0.9: early crystallization is allowed.
“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<Purpose>
Deep Interview is an intent-first Socratic clarification loop that runs before planning or implementation. It turns vague ideas into execution-ready specifications by asking targeted questions: why the user wants the change, how far it should go, what stays out of scope, and what the agent may decide without confirmation.
</Purpose><Use_When>
- The request is broad, ambiguous, or missing concrete acceptance criteria.
- The user says "deep interview", "interview me", "ask me everything", "don't assume", or "ouroboros".
- The user wants to avoid misaligned implementation from underspecified requirements.
- A requirements artifact is needed before handing off to
$ralplan,$autopilot,$ultragoal, or$team. </Use_When>
<Do_Not_Use_When>
- The request already has concrete file/symbol targets and clear acceptance criteria.
- The user explicitly asks to skip planning/interview and execute immediately.
- The user only wants lightweight scoping or planning (use
$ralplan --light). - A complete PRD/plan already exists and execution should start. </Do_Not_Use_When>
<Depth_Profiles>
- Quick (
--quick): fast pre-PRD pass; threshold<= 0.30; max 5 rounds. - Standard (
--standard, default): full requirement interview; threshold<= 0.20; max 12 rounds. - Deep (
--deep): high-rigor exploration; threshold<= 0.15; max 20 rounds. - Ideate (
--ideate, profile or modifier): pre-Phase-2 divergent/convergent concept shaping (How Might Wereframing,5–8variations across 7 lenses,Painkiller vs Vitamin+ 6-Tier Differentiation,Must/Should/Might Be Trueaudit) saved to.omagy/artifacts/ideas/{slug}.mdwith a single-answerask_questionbridge into Phase 2 Socratic convergence; see ideation-lenses.md. - Autoresearch (
--autoresearch): Standard rigor, specialized for$deep-research --loopmission readiness (see below).
max rounds is a hard cap, not a target. Do not continue only to reach a round count. If no flag is given, use Standard. Optional per-repo overrides may live in .omagy/config.json under deepInterview (defaultProfile, quickThreshold, standardThreshold, deepThreshold, quickMaxRounds, standardMaxRounds, deepMaxRounds, enableChallengeModes). Ignore a malformed config. Explicit flags win.
</Depth_Profiles>
<Execution_Policy>
- Ask ONE question per round. Never batch several interview rounds into one form.
- Ask about intent and boundaries before implementation detail.
- Target the weakest clarity dimension each round, after applying the stage-priority rules below.
- Treat every answer as a claim to pressure-test. The next question should usually demand evidence or examples, expose a hidden assumption, force a tradeoff or boundary, or reframe root cause vs symptom.
- Do not rotate to a new dimension just for coverage while the current answer is still vague. Go one layer deeper first.
- Before crystallizing, complete at least one explicit pressure pass that revisits an earlier answer with a deeper assumption- or tradeoff-focused follow-up.
- Gather codebase facts yourself (or via the
exploresubagent) before asking the user about internals. Never ask the user for facts the repository can answer. - Always run preflight context intake before the first question. For brownfield work, it includes doc/context grounding: governing
AGENTS.md/GEMINI.mdfiles, README/getting-started docs, relevantdocs/contracts/plans/ADRs, existing.omagy/context/snapshots, and glossary/context files such asCONTEXT.md. - Treat existing repo language as evidence, not authority. If the user's term is fuzzy, overloaded, or conflicts with docs/code, surface the exact wording and ask which meaning governs.
- Cross-check user claims about current behavior against code or documented contracts. If docs and code disagree, ask a confirmation question that names both sources.
- Use scenario-based edge-case grilling when a boundary or handoff is unclear: invent one concrete scenario that stresses it, then ask one focused question about the expected outcome.
- Durable doc/glossary/ADR updates are opt-in and public-safe only. Recommend them in the handoff; never auto-create them from interview transcripts.
- If initial context is oversized, do not paste it into prompts. Make the first round a request for a prompt-safe summary (goals, constraints, success criteria, non-goals, decision boundaries, references to full sources). This gate blocks scoring, crystallizing, and handoff.
- Route facts before judgment. Before each round, classify the needed information as a discoverable fact, a fact needing confirmation, or a human decision. The interview with the human is for judgment.
- Two-Filter Question Gate + Owner-Decision Survival:
- Filter 1 (Material Fork): Does the answer change architecture, scope, schema, or file boundaries?
- Filter 2 (Unresolvable by Repo/Docs): Can this be answered by inspecting the repo or official docs? If yes, inspect—do not ask.
- Owner-Decision Survival: Unless the user explicitly asked for a deep Socratic grilling ("interview me", "ask me everything"), ask only decisions that are irreversible, destructive, spend-bearing, scope-defining, or change a public/external contract. For reversible engineering defaults, propose the recommended default and record it under
[adopted-default]if the user says "you decide" / "use best practices". - Open "Why" First, Outcome-vs-How Attribution & Anti-Goals: when the user hasn't stated why they want something, ask an open question first without steering option menus (
ask_questionwith concrete choices is used once intent/"why" is known and a named fork exists). Process steps (where files go, doing recon, writing docs) are agent calls stated as proposals rather than questions. Separate outcome-talk from how-talk: if the user only described desired outcomes, any implementation/howchoices proposed by the agent must be tagged[adopted-default](never[from-user]). Capture explicit anti-goals ("what would make this a failure even if it technically works") alongsideNon-goals, and play back multi-part design understanding in incremental 200–300 word chunks. When nothing material is open on the first turn, present a short design/spec for approval immediately.
- When ambiguity depends on current external best practices or version-aware behavior, use
$deep-research --quickbefore crystallizing. - Transcript/spec labels:
[from-code][auto-confirmed]: exact, high-confidence codebase facts with no prescription attached. Record them as context, not interview rounds.[from-code]: inferred or pattern-based findings that need a confirmation-style round.[from-research]: externally sourced facts (limits, compatibility, docs). Facts only, never decisions.[from-user]: goals, preferences, scope, non-goals, acceptance criteria, tradeoffs, and any decision-bearing interpretation.
- Auto-confirm only descriptive facts. If a finding implies what the feature should do, which pattern to follow, or what is in/out of scope, route the whole decision to the user as
[from-user]. - Re-score ambiguity after each answer and show progress transparently.
- Once ambiguity is at or below threshold, stop ordinary questioning and run the closure audit.
- Do not hand off while ambiguity is above threshold unless the user explicitly opts to proceed with a warning.
- Do not crystallize or hand off while
Non-goalsorDecision Boundariesremain unresolved, even if the score meets threshold. - Deep-interview is a requirements mode. Do not implement. </Execution_Policy>
<Asking_Questions>
Use Antigravity's ask_question tool for every interview round.
- No-Questions Override: do not call
ask_questionor ask the user when they have explicitly said not to ("don't ask","no questions","do not ask me","hands-off"). Instead, adopt best-practice defaults, record them as[adopted-default], and crystallize the spec directly. - One question per
ask_questioncall. Header line in the question text:Round {n} | Target: {weakest_dimension} | Ambiguity: {score}%, then the question. is_multi_select: false(single-answer) when exactly one answer should drive the next branch or the options are mutually exclusive: lane selection, primary failure mode, competing interpretations.is_multi_select: truewhen several options can all hold at once: all out-of-scope items, all success metrics, all deployment constraints.- If one selected option would immediately need a follow-up to disambiguate the others, ask a single-answer round now and the follow-up next. Do not hide a branching tree inside one multi-select.
- Options: 2-6 concrete, bounded choices written as the user's answer, formatted
Label — short description. Put the recommended option first with the(Recommended)prefix. Do not add an "Other" option: the UI always provides a write-in. - If
ask_questionis unavailable (for example in a headless run), ask exactly one concise plain-text question and wait for the answer. - If the user skips a question, record that as
[from-user] skipped, lower confidence for that dimension, and choose the next-highest-leverage question rather than re-asking verbatim. </Asking_Questions>
<Steps>Phase 0: Preflight context intake
- Derive a short task slug from the user's request.
- Load the latest relevant snapshot from
.omagy/context/{slug}-*.mdif one exists. - Check whether the initial context or loaded snapshot is too large for safe prompt use. If so, round 1 must request a prompt-safe summary.
- If no snapshot exists, create one containing: task statement; desired outcome; stated solution; probable intent hypothesis; known facts/evidence; constraints; unknowns; decision-boundary unknowns; likely codebase touchpoints; repo docs/rules/context inspected; terminology or doc/code conflicts; prompt-safe summary status (
not_needed|needed|recorded). - For brownfield tasks, inspect the applicable documentation/rule surface before the first user-facing round. Prefer exact, nearby sources over broad scans.
- Save to
.omagy/context/{slug}-{YYYYMMDDTHHMMSSZ}.md(UTC).
Phase 1: Initialize
- Parse the depth profile flag.
- Classify brownfield (existing codebase target) vs greenfield. For brownfield, collect relevant code context first (directly or via
explore). - Persist state. Standalone: write
.omagy/state/deep-interview-state.json. Inside Autopilot: do not create this file. Store the same fields understate.deep_interviewinautopilot-state.json.
{
"mode": "deep-interview",
"active": true,
"current_phase": "interview",
"started_at": "<ISO>",
"updated_at": "<ISO>",
"state": {
"slug": "<slug>",
"profile": "quick|standard|deep|ideate|autoresearch",
"type": "greenfield|brownfield",
"initial_idea": "<user input>",
"rounds": [],
"current_ambiguity": 1.0,
"threshold": 0.2,
"max_rounds": 12,
"challenge_modes_used": [],
"current_stage": "intent-first",
"current_focus": "intent",
"context_snapshot_path": ".omagy/context/<slug>-<ts>.md"
}
}- Announce the kickoff with profile, threshold, and current ambiguity, and surface
[oh-my-agy HUD](sidecar://oh-my-agy/hud/)once so the user can monitor the liveInterviewtab (ambiguity gauge, dimension bars, and readiness gates) in the Auxiliary Pane.
Phase 2: Socratic interview loop
Repeat until: ambiguity <= threshold and the readiness gates pass, the user exits with a warning, or max rounds are reached. Below threshold, do not open a new ordinary branch. Read scoring-and-templates.md for the full stage-priority ladder, ledgers, challenge modes, and spec templates.
2a) Generate the next question
If oversized context has no recorded summary, the only allowed question is the summary request.
Target the lowest-scoring dimension, respecting stage priority (Stage 1: Intent, Outcome, Scope, Non-goals, Decision Boundaries -> Stage 2: Constraints, Success Criteria -> Stage 3: Context Clarity for brownfield). Apply the 6-step follow-up pressure ladder and maintain the Breadth Ledger and brownfield Docs/Terminology Ledger defined in scoring-and-templates.md. Non-goals and Decision Boundaries are mandatory readiness gates.
2b) Ask the question
Use ask_question as described in <Asking_Questions>.
2c) Score ambiguity
Score each dimension in [0.0, 1.0] with a justification and gap:
- Greenfield:
ambiguity = 1 - (intent×0.30 + outcome×0.25 + scope×0.20 + constraints×0.15 + success×0.10) - Brownfield:
ambiguity = 1 - (intent×0.25 + outcome×0.20 + scope×0.20 + constraints×0.15 + success×0.10 + context×0.10)
Enforce readiness gates (Non-goals, Decision Boundaries, pressure pass, closure + 3-Question Predictability Check, Builder Check triage) & round caps (Dialectic Rhythm after 3 non-user turns, exit >= 4, max_rounds) per scoring-and-templates.md; crystallize at ambiguity <= 0.10.
2d) Report progress & persist state
Show the weighted breakdown table, readiness-gate status, and next focus dimension. Append the round (question, answer, label, scores) to state and refresh updated_at.
Phase 3: Challenge modes
Use each mode at most once when triggered (Contrarian, Terminologist, Simplifier, Ontologist; force Ontologist once if ambiguity stalls ±0.05 for 3 rounds) and record usage in state.challenge_modes_used. See scoring-and-templates.md for trigger rules.
Phase 4: Crystallize artifacts
When threshold is met (or on early exit with a warning, or at the hard cap):
- Configurable Custom Quality Gates (
qualityGates["deep-interview"]): after writing the spec in step 2, if.omagy/config.jsondefinesqualityGates["deep-interview"](strict no-op when absent/empty; reserved controller skills likedeep-interview,ralplan,code-review,ai-slop-cleanerare rejected to prevent self-recursion), run each configured gate skill in an independent subagent (Model: gate.model || "inherit"). Anyblockinggate returningreject/iteraterequires revising the spec before step 3;advisoryorunavailablegates are recorded without blocking. - Write the transcript summary to
.omagy/interviews/{slug}-{timestamp}.md. - Write the execution-ready spec to
.omagy/specs/deep-interview-{slug}.mdfollowing the 9-section template (including the Affected User Ideal State & Gap Table,[adopted-default]decision boundaries, and pressure/terminology audits) in scoring-and-templates.md.- For
--autoresearch, also generate.omagy/specs/deep-interview-autoresearch-{slug}.md(with the locked## Fidelityblock:as of,meaning check,source floor,derived numbers) and the launch bundle under.omagy/specs/autoresearch-{slug}/(mission.md,sandbox.md,result.json), markinglaunchReady: falseif placeholders or undecided fidelity fields remain, per scoring-and-templates.md.
- For
- Standalone: write state
current_phase:"complete",active:false,completed_at. Inside Autopilot: sethandoff_artifacts.deep_interviewto the spec path and advance Autopilot toralplan.
Phase 5: Execution bridge
Present handoff options with ask_question (single-answer, recommended option first). The spec is the requirements source of truth. Preserve intent, non-goals, decision boundaries, acceptance criteria, terminology grounding, and residual-risk warnings across the handoff.
$ultragoal(default durable execution): input is the spec. Convert it into durable goals with sequential completion tracking. It skips requirements discovery.$ralplan(recommended when architecture/test review is needed): treat.omagy/specs/deep-interview-{slug}.mdas requirements truth & bind it viaplan-hash --source-spec.$autopilot: planning plus execution from the clarified brief.$team: coordinated parallel execution against the shared spec.- Refine further: continue the interview loop.
Context-sensitive goal-mode suggestions: $deep-research --loop for validator-gated research projects, $performance-goal for measurable optimization work.
Optional stride contract: when the downstream workflow needs an explicit stop condition, store it as structured data under handoff_artifacts.deep_interview.execution_contract in Autopilot state, e.g. {"version":1,"execution_stride":"task|deliverable|milestone","selected_by":"user","completion_unit":"...","stop_condition":"..."}. Do not infer stride from task length.
Do NOT implement inside deep-interview. On handoff, activate the selected skill.
</Steps><Escalation_And_Stop_Conditions>
- User says stop/cancel/abort: persist state and stop.
- Ambiguity stalls for 3 rounds: force Ontologist once.
- Max rounds reached: proceed with an explicit residual-risk warning.
- All dimensions >= 0.9: early crystallization is allowed. </Escalation_And_Stop_Conditions>
<Final_Checklist>
- Preflight snapshot exists under
.omagy/context/. - Oversized context (if any) has a recorded prompt-safe summary before scoring or handoff.
- Ambiguity was shown each round, with intent-first priority and weakest-dimension targeting.
- At least one assumption probe and one pressure pass happened.
- Challenge modes fired when applicable.
- Transcript written to
.omagy/interviews/and spec to.omagy/specs/deep-interview-{slug}.md. - Brownfield questions used evidence-backed confirmation; terminology conflicts were resolved.
- Handoff options were offered. No direct implementation was performed. </Final_Checklist>
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

