System-End/hackatime
1
0
Fork 0
mirror of https://github.com/System-End/hackatime.git synced 2026-04-19 22:15:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add AGENT.md

Browse source
This commit is contained in:
Zach Latta 2025-05-28 16:38:32 -04:00
parent 8162d5e480
commit f82da334db
1 changed files with 22 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
AGENT.md Normal file
View file

@ -0,0 +1,22 @@
# AGENT.md - Rails Hackatime/Harbor Project
## Commands
- **Tests**: `rails test` (all), `rails test test/models/user_test.rb` (single file), `rails test test/models/user_test.rb -n test_method_name` (single test)
- **Lint**: `bundle exec rubocop` (check), `bundle exec rubocop -A` (auto-fix)
- **Console**: `rails c` (interactive console)
- **Server**: `rails s -b 0.0.0.0` (development server)
- **Database**: `rails db:migrate`, `rails db:create`, `rails db:schema:load`, `rails db:seed`
- **Security**: `bundle exec brakeman` (security audit)
## Docker Development
- Start: `docker compose run --service-ports web /bin/bash`
- Setup DB: `bin/rails db:create db:schema:load db:seed`
## Code Style (rubocop-rails-omakase)
- **Naming**: snake_case files/methods/vars, PascalCase classes, 2-space indent
- **Controllers**: Inherit `ApplicationController`, use `before_action`, strong params with `.permit()`
- **Models**: Inherit `ApplicationRecord`, extensive use of concerns/enums/scopes
- **Error Handling**: `rescue => e` + `Rails.logger.error`, graceful degradation in jobs
- **Imports**: Use `include` for concerns, `helper_method` for view access
- **API**: Namespace under `api/v1/`, structured JSON responses
- **Testing**: Minitest with fixtures, parallel execution enabled