comment-conventions

Language-agnostic code commenting and docblock conventions — present-tense comments, dev-focused content, mandatory docblocks on new functions/methods/components, a 3-source-line descending-length cap on docblock prose, and a no-chatter rule for inline comments (no prose walls, no business-logic essays, no step-by-step narration in the code path). Auto-fixes non-compliant docblocks and inline-comment walls on existing functions in the file being edited, leaving unusually long deliberate docblocks alone. Ships a PostToolUse hook that auto-validates Rule 4 on every Edit/Write.