decisions

SKILL.md

Decisions

Projects may have a decisions.md file for recording significant decisions.

When to Record Decisions

Record a decision when:

  • A significant choice was made after considering alternatives
  • The decision affects future work (even if no code was written)
  • You'd want to remember "why did we decide this?" later

Do NOT record:

  • Exploration or experiments that didn't pan out
  • Routine implementation choices
  • Decisions still being discussed

Recording Format

Append to the project's decisions.md:

Installs
3
First Seen
Mar 30, 2026