Story map

How It Works

• 1
  Gather context

  Load the parent idea, project goals, related entities — solutions, segments, hypotheses — and existing specs to understand what is already decided before writing anything.

• 2
  Draft Why and Goals

  Articulate the motivation for this change and the specific metric or outcome it is intended to move, anchored to the team current OKRs.

• 3
  Document current state and proposal

  Describe what exists today and what is broken or missing, then describe the proposed solution with enough precision for engineering to estimate and start.

• 4
  Log decisions with rationale

  For every non-obvious choice, record why this option was chosen and what alternatives were rejected. This section is what makes the spec useful months later.