Rule Documentation

Document Why, Not What

Comments should explain reasoning and context, not describe code

documentationcommentscontext

CLAUDE.md

Comments should explain why, not what. The code already says what it does. Comments should explain the reasoning, business context, or non-obvious constraints behind a decision.

Copy this block into your CLAUDE.md or agent config file to enforce it in your workflow.

get crystl