Documentation

Guides.

Longer-form walkthroughs on specific topics. Most of these pair with a blog post — the guides are the reference version.

Guide

Writing comments

When a comment earns its place, when it's dead weight, and what the ai-slop/trivial-comment and ai-slop/narrative-comment rules remove automatically. With good/bad examples and a decision tree.

Read →

More coming

Topics planned: when to use as any (and when not to), refactoring eighty-line functions, monorepo config inheritance, architecture rules by example, and a cold-start guide for landing on a "97/100" repo with an angry agent.

In the meantime: the blog has related deep dives.