Skip to content

Optimize Agent Rules for Suspenders #789

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
stevepolitodesign merged 1 commit into from
Apr 29, 2026
Merged

Optimize Agent Rules for Suspenders #789

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 5 additions & 19 deletions rails/ai-rules/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,35 +1,21 @@
# thoughtbot project architecture and coding standards for Rails development using agents

See the folder `rules` for language-specific guidelines, testing conventions,
and other standards.

> **Usage:**
>
> 1. Copy the content of this file.
> 2. Create a new file in the root of your project called `.claude/CLAUDE.md`.
> 3. Update the information in the new file to match your project.
> 4. Paste the content of this file into the new file.
> 5. Copy the rules folder into `.claude/`

## Project: [APP_NAME]
# Project: [APP_NAME]

[One sentence: what the app does and who it serves.]

## Commands

```bash
bin/rails server # Start dev server
bin/dev # Start dev server and worker

@stevepolitodesign stevepolitodesign Apr 29, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is an improvement since background jobs are supported with this command.

bin/rails spec # Full test suite (Suspenders rake task)
bundle exec rspec spec/models # Model specs only
bundle exec rspec spec/requests # Request specs only
bundle exec rspec spec/path/to/file_spec.rb # Run all tests in file
bundle exec rspec spec/path/to/file_spec.rb:72 # Run just the test at line 72
bundle exec rake standard # Lint
bundle exec rake standard:fix # Auto-fix lint issues
Comment on lines -27 to -28

@stevepolitodesign stevepolitodesign Apr 29, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These commands aren't supported on new Rails applications.

bundle exec rubocop # Lint
bundle exec rubocop -a # Auto-fix lint issues
bin/rails db:migrate # Run migrations
bin/rails suspenders:db:migrate # Migrate + annotate
bin/rails suspenders:cleanup:organize_gemfile # Sort Gemfile
Comment on lines -30 to -31

@stevepolitodesign stevepolitodesign Apr 29, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These commands no longer exist.

bundle audit # Check gem vulnerabilities
bin/ci # Run all tests, linters, and security scanners
bin/rails routes # View routes
```

Expand Down
12 changes: 12 additions & 0 deletions rails/ai-rules/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# thoughtbot project architecture and coding standards for Rails development using agents

See the folder `rules` for language-specific guidelines, testing conventions,
and other standards.

> **Usage:**
>
> 1. Copy the content of this file.
> 2. Create a new file in the root of your project called `.claude/CLAUDE.md`.
> 3. Update the information in the new file to match your project.
> 4. Paste the content of this file into the new file.
> 5. Copy the rules folder into `.claude/`
Loading