Working with AI Tools

Omaship is designed to work seamlessly with AI coding assistants like Claude Code and Cursor.

Why Rails Works Well with AI

• Convention over configuration — Predictable file locations
• Two decades of patterns — Extensive training data
• Consistent structure — Every Rails app follows the same layout

CLAUDE.md

Every Omaship project includes a CLAUDE.md file at the root. This provides project-specific context to AI tools:

• Project architecture overview
• Key conventions and patterns
• Important files and their purposes
• Common tasks and how to accomplish them

Update this file as your project grows. The more context you provide, the better AI tools perform.

Tips for Effective AI Coding

Be Specific About Location

Reference Existing Patterns

"Add a new model following the same pattern as app/models/user.rb"

Use Rails Commands

AI tools understand Rails generators:

"Run 'rails generate model Product name:string price:decimal' and create a ProductsController with index and show actions"

ast-grep Rules

Omaship includes ast-grep rules that enforce code quality patterns. AI tools respect these rules when generating code. See sgconfig.yml for the full list.

Getting Help

If an AI tool gets stuck, provide more context:

• Share relevant file contents
• Describe the expected behavior
• Point to similar working code