# AI Agent Rules for Ruby Projects

**⚠️ READ AGENTS_RULES.md FOR COMPLETE DOCUMENTATION**

This is a quick reference. Full rules are in `AGENTS_RULES.md`.

## Quick Reference

### Workflow
1. **Plan** → Discuss with user
2. **Test** → Write failing tests first (TDD)
3. **Develop** → Implement with Ruby best practices
4. **Test** → `bundle exec rspec` (90% coverage minimum)
5. **Commit** → Get user approval first

### Ruby Best Practices
- Follow Ruby 3.0+ conventions
- Use RSpec for testing
- Maintain code quality with RuboCop
- Format code with RuboCop

### Testing
```bash
bundle exec rspec
bundle exec rspec --format documentation
```

### Git Rules
- ❌ NEVER `git stash`
- ❌ NEVER `git push` or `git push --force`
- ✅ ALWAYS ask user approval before commit

### Commit Format
```
<type>(agt): <description>

Types: feat, fix, refac, chore, doc, test
Example: feat(agt): add user authentication module
```

### Tools
```bash
bundle install    # Build
bundle exec rspec     # Test
ruby      # Run
```

---

**📖 For complete rules, examples, and detailed guidelines:**
**Read `AGENTS_RULES.md` in this directory**
