AGENTS.md

1# Spec
2 
3## Directory Structure
4 
5- `spec/features/` - System/feature tests (Capybara)
6- `spec/models/` - Model unit tests
7- `spec/requests/` - API/integration tests
8- `spec/services/` - Service tests
9 
10## Running Tests
11 
12```bash
13# Backend (RSpec) - prefer specific tests over running all
14bundle exec rspec spec/models/user_spec.rb              # Single file
15bundle exec rspec spec/models/user_spec.rb:42           # Single line
16bundle exec rspec spec/features                         # Directory
17bundle exec rake parallel:spec                          # Parallel execution
18```
19 
20### Docker
21 
22```bash
23bin/compose rspec spec/models/user_spec.rb   # Run specific tests in backend-test container
24bin/compose exec backend bundle exec rspec    # Run tests directly in backend container
25```
26 
27## Debugging CI Failures
28 
29```bash
30./script/github_pr_errors | xargs bundle exec rspec    # Run failed tests from CI
31./script/bulk_run_rspec spec/path/to/flaky_spec.rb     # Run tests multiple times
32```
33