whyspec

Use when planning a code change, capturing decisions before coding, or setting up the Decision Bridge.

Use after coding to preserve reasoning — resolves the Decision Bridge with actual outcomes.

Use when encountering any bug, test failure, or unexpected behavior — before proposing fixes.

Use when starting implementation, continuing work, or executing tasks from a WhySpec plan.

Use when looking for why something was built a certain way or finding past decisions.

Use when reviewing the full story of a change — intent, design, tasks, and Decision Bridge delta.