deep-dive

Trace root causes and crystallize requirements via a 2-stage interview process.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Hyeonjun0527/yeon --skill deep-dive-hyeonjun0527
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-dive
Source: https://github.com/Hyeonjun0527/yeon/tree/main/.codex/skills/deep-dive
Command: npx skills add https://github.com/Hyeonjun0527/yeon --skill deep-dive-hyeonjun0527

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Dive orchestrates a 2-stage pipeline that first investigates WHY something happened (trace) then precisely defines WHAT to do about it (deep-interview). The trace stage runs 3 parallel causal investigation lanes, and its findings feed into the interview stage via a 3-point injection mechanism — enriching the starting point, providing system context, and seeding initial questions. The result is a crystal-clear spec grounded in evidence, not assumptions.

Core Features & Use Cases

  • 2-stage pipeline: trace (causal investigation) -> deep-interview (requirements crystallization) with 3-point injection
  • Phase-based execution with persistent state across phases for resume
  • Robust handoff to omc-plan and autopilot execution with trace injection to initialize interview

Quick Start

Provide your problem statement to initiate the deep-dive flow and begin trace and interview.

Frequently Asked Questions about deep-dive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate ambiguous bug investigation findings into actionable requirements?

Ambiguous bug investigations translate into actionable requirements through a 2-stage trace and interview process. This pipeline runs parallel causal investigation lanes to find root causes, then injects those trace findings into a deep-interview to crystallize evidence-based specs.

What is the best way to structure requirements crystallization for early-stage product questions?

Requirements crystallization for early-stage product questions works best by orchestrating a structured trace phase before defining what to do. Multi-lane tracing investigates why a problem exists, and a 3-point injection mechanism feeds those findings into an interview stage for precise specifications.

Can I resume requirements planning workflows if an interview or trace phase is interrupted?

Requirements planning workflows support resuming interrupted phases through persistent state execution. The process manages brownfield and greenfield detection, saves progress across trace and interview stages, and ensures seamless handoff to execution without losing intermediate causal findings.

When do I need a structured trace before writing product requirements?

A structured trace is needed before writing product requirements when facing ambiguous problems or bug investigations. It identifies root causes across parallel causal investigation lanes, ensuring the final crystallized requirements are grounded in evidence rather than initial assumptions.

Does deep-dive handle handoff to execution plans after requirements are defined?

Deep-dive handles handoff to execution plans by injecting trace findings into the interview initialization. It delivers an end-to-end workflow that seamlessly transitions from crystallized requirements directly into omc-plan and autopilot execution for immediate downstream action.