dev-deep-dive

Trace causes and crystallize requirements for ambiguous production incidents.

520|175|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/EvolutionAPI/evo-nexus --skill dev-deep-dive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-deep-dive
Source: https://github.com/EvolutionAPI/evo-nexus/tree/main/.claude/skills/dev-deep-dive
Command: npx skills add https://github.com/EvolutionAPI/evo-nexus --skill dev-deep-dive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Two-stage investigation combines causal tracing with requirements crystallization to resolve problems where the cause and the scope are unclear.

Core Features & Use Cases

  • Stage 1: Causal trace to generate competing hypotheses, collect evidence, apply lenses, and save a trace report.
  • Stage 2: Requirements crystallization to surface unstated assumptions, define scope boundaries, identify missing acceptance criteria, and save a spec.
  • Stage 3: Synthesis to merge the trace report and the requirements spec and hand off to planning.

Quick Start

Initiate a two-stage investigation by performing causal tracing followed by requirements crystallization when both the cause and the scope of a problem are unclear.

Frequently Asked Questions about dev-deep-dive

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

FAQPage Schema
What is two-stage investigation for root cause analysis?

Two-stage investigation is a method that combines causal tracing to generate competing hypotheses with requirements crystallization to clarify scope for ambiguous issues. It enforces a structured workflow that concludes with synthesized handoffs to planners for production incidents and cross-team problems.

How do I conduct a causal trace for production incidents with unclear causes?

Conduct a causal trace by generating competing hypotheses, collecting evidence, and applying analytical lenses to the production incident. Save the resulting findings as a trace report in your workspace to document the root cause investigation before moving to requirements crystallization.

When do I need requirements crystallization for engineering workflows?

Requirements crystallization is needed for strategic initiatives lacking defined outcomes or cross-team problems requiring structured handoffs. It surfaces unstated assumptions, defines scope boundaries, and identifies missing acceptance criteria, saving these details as a spec for planners.

What is the best way to structure handoffs for cross-team problems?

The best way to structure cross-team handoffs is through synthesis, merging the causal trace report and requirements spec into a unified deliverable. This ensures planners receive both the identified root causes and the crystallized scope boundaries for the ambiguous problem.

Can I use this investigation method for strategic initiatives lacking defined outcomes?

Yes, you can use this investigation method for strategic initiatives lacking defined outcomes. The requirements crystallization stage specifically surfaces unstated assumptions and defines scope boundaries, making it suitable for resolving ambiguous strategic problems.