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

### Swift Best Practices
- Follow Swift 5.9+ conventions
- Use XCTest for testing
- Maintain code quality with SwiftLint
- Format code with swift-format

### Testing
```bash
swift test
swift test --enable-code-coverage
```

### 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
swift build    # Build
swift test     # Test
swift run      # Run
```

---

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