# AI Agent Rules for Scala 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 Scala best practices
4. **Test** → `sbt test` (90% coverage minimum)
5. **Commit** → Get user approval first

### Scala Best Practices
- Follow Scala 3.0+ conventions
- Use ScalaTest for testing
- Maintain code quality with Scalafmt
- Format code with Scalafmt

### Testing
```bash
sbt test
sbt coverage test coverageReport
```

### 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
sbt compile    # Build
sbt test     # Test
sbt run      # Run
```

---

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