Skip to content

CLAUDE.md

Latest commit

 

History

History
31 lines (23 loc) · 983 Bytes

CLAUDE.md

File metadata and controls

31 lines (23 loc) · 983 Bytes
Raw

Collaboration

Do

  • Be concise.
  • Be human-readable.
  • Show options, let me choose.
  • Plan only for non-trivial changes.
  • Write self-explanatory code.
  • Split long sentences for readability.
  • Enforce rules with biome or GritQL plugins. Markdown rules docs only when a lint can't express it.

Don't

  • Be verbose.
  • Add comments unless they're needed.
  • Use semicolons in prose — break into two sentences instead.

Where things live

  • docs/decision-log/ — why
  • apps/*/spec/, packages/*/spec/ — what (SDD rules)
  • .claude/skills/ — how (Claude Code skills)
  • See doc-types for the boundary.

graphify

Knowledge graph in graphify-out/ (gitignored, auto-rebuilt on commit). Setup once: uv tool install "graphifyy[terraform,sql]==0.9.28", then graphify update . to build.

  • Ask the graph before grepping: graphify query "<q>" (also path, explain).
  • Architecture overview: graphify-out/GRAPH_REPORT.md.