Document Claude code readability conventions

[sdkennedy2]

Motivation

Clarify the repository guidance for AI-assisted code edits so generated changes favor readable, reviewable code over compact expressions.

Changes

Adds two Claude code style conventions:

• Comments should live on their own line above the code they describe, rather than beside code.
• Function calls should not be passed directly as arguments to other function calls; the inner result should be assigned to a named local first.

These rules make intermediate values easier to inspect, give comments room to explain intent, and reduce dense one-line expressions in future generated changes.

QA Instructions

Documentation-only change. Review the updated CLAUDE.md guidance and confirm the conventions are clear.

Blast Radius

No runtime impact. This only changes repository guidance for future Claude-generated edits.

Documentation

• How to reliably make frontend production changes
• PR Description Guidelines
• Deploy steps

[sdkennedy2]

• Document Claude code readability conventions #355 👈 (View in Graphite)
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.