why

Installation
SKILL.md

Why

Find the recorded reason for a design, then check whether it still applies. Current code shows what happens; it does not prove what its author intended.

Workflow

  1. Anchor the question. Find the relevant code, symbols, and behavior. Distinguish why it was introduced from why it should remain.
  2. Trace the record. Read the commits that introduced and changed it, following renames and linked PRs. Check relevant issues, design docs, tests, and comments. Search available session or incident records when the repository leaves a gap.
  3. Check the present. Compare the recorded reason with current callers, contracts, and behavior. Name any constraint that has changed.
  4. Separate evidence from inference. Treat an explicit reason as documented, converging clues as supported, and a reading of the code alone as inference. Report conflicting accounts and gaps.

Output

Answer the question first. Cite each reason at its source. Distinguish the original reason from the case for keeping the design today. If the reason is unknown, name the records checked and what remains unknown.

See also

Installs
1
First Seen
Oct 25, 2026
Security Audits