# AI Collab Core

Language-agnostic rules + Flutter/Dart patterns for AI-assisted development.

## Mission: Token Efficiency = Sustainable AI

**Core Philosophy:** Minimize tokens at every level - not just shorter responses, but efficient code that avoids iterations and bugs.

**Why:**
- **User:** Save money on API costs
- **AI:** Work more efficiently
- **Environment:** Less resources in data centers
- **Humanity:** Sustainable AI for everyone

**How:** Better rules → correct code first time → fewer bugs → quick fixes → less back-and-forth → massive token savings

Every rule in this system serves token efficiency.

## Structure

```
/rules/
  /project/        → Copy to project's .cursor/rules/
    /universal/    → Any language (Python, JS, Java, Go, etc.)
    /flutter/      → Flutter patterns
    /dart/         → Dart patterns
    /ai-workflow/  → AI collaboration patterns
  /user/           → Copy to Cursor global settings (applies to ALL projects)

/.cursor/rules/    → Meta-project rules (for maintaining THIS repo only)
/docs/             → Documentation (start at docs/index.md)
/prompts/          → Reusable task prompts
```

## Usage

### Quick Start (Recommended)
Click GitHub's **"Use this template"** button → creates new repo with clean history

### What to Copy
**Any language:** `rules/project/universal/` + `rules/project/ai-workflow/`  
**Flutter:** Entire `rules/project/` directory  
**Global settings:** `rules/user/` → Cursor global settings (applies to ALL your projects)

## For AI

- Rules have metadata headers (description, priority, globs)
- Start at `docs/index.md` for detailed documentation
- Apply `.cursor/rules/` when working on THIS repository
- Each .mdc file is self-documenting