---
paths:
  - "**/.claude/research/**"
  - "**/research/**"
  - "**/spike*"
---

# Research Rules

## Library Evaluation Checklist

1. **Bun compatible?** — Check runtime support explicitly
2. **Bundle size** — Check bundlephobia for frontend deps
3. **License** — MIT, Apache 2.0, BSD only. No GPL for SaaS.
4. **Maintenance** — Last commit, open issues, bus factor
5. **Native alternative?** — Can Web APIs or Bun APIs do this instead?

## API Evaluation

- Official docs only — never unofficial/community speculation
- Document: auth method, rate limits, data freshness, deprecation status, known limitations
- Check what the API CAN'T do — document prominently

## Documentation

- Store in `.claude/research/`. Lead with recommendation, then evidence.
- Include rejected options and why. Link primary sources.