CLAUDE.md

1# Project: [APP_NAME]
2 
3[One sentence: what the app does and who it serves.]
4 
5## Commands
6 
7```bash
8bin/dev                               # Start dev server and worker
9bin/rails spec                        # Full test suite (Suspenders rake task)
10bundle exec rspec spec/models         # Model specs only
11bundle exec rspec spec/requests       # Request specs only
12bundle exec rspec spec/path/to/file_spec.rb  # Run all tests in file
13bundle exec rspec spec/path/to/file_spec.rb:72  # Run just the test at line 72
14bundle exec rubocop                   # Lint
15bundle exec rubocop -a                # Auto-fix lint issues
16bin/rails db:migrate                  # Run migrations
17bundle audit                          # Check gem vulnerabilities
18bin/ci                                # Run all tests, linters, and security scanners
19bin/rails routes                      # View routes
20```
21 
22## Rules
23 
24Short constraints in .claude/rules/:
25 
26rules/models.md — models conventions
27rules/controllers.md — controller conventions
28rules/testing.md - **MUST write tests first** TDD guidelines
29rules/security.md — security guidelines
30rules/views.md — No logic in views, presenter usage, Turbo conventions
31rules/database.md — Indexes, N+1, migration rules, query guidelines
32