brainrepo

# BrainRepo

Your personal knowledge repository. Capture fast, organize automatically, retrieve instantly.

## Brain Location

**Fixed path:** `~/Documents/brainrepo/`

This is not configurable. All brain data lives here.

## First Run Check

**Before any action**, check if brainrepo is initialized:

1. Check if `~/Documents/brainrepo/` exists with expected structure (Inbox/, Projects/, Areas/)
2. If NOT found → **Run onboarding automatically**
3. If found → Proceed with user request

## Onboarding

Triggers automatically on first interaction, or when user says "set up brainrepo":

1. Create brain at `~/Documents/brainrepo/`
2. Create the folder structure:

```bash
mkdir -p <path>/{Inbox,Projects,Areas/personal-growth,Areas/family,Notes,Resources,Journal,People,Tasks,Archive}
```

3. Create initial files from templates in `assets/templates/`:
   - `Tasks/index.md` — task hub
   - `Areas/personal-growth/index.md` — personal growth area
   - `Areas/family/index.md` — family area

4. Initialize git (optional):
```bash
cd <path> && git init && git add -A && git commit -m "init: brainrepo"
```

5. Confirm setup and show quick start commands

## Core Concept

**DUMP → PROCESS → RETRIEVE**

1. **Dump** — Capture everything to Inbox/ (don't organize yet)
2. **Process** — Evening review: Inbox → permanent home
3. **Retrieve** — Ask AI to find anything

## Repository Structure

```
brainrepo/
├── Inbox/          # Quick capture (clear daily)
├── Projects/       # Active work with deadlines
├── Areas/          # Ongoing responsibilities (no deadline)
├── Notes/          # Permanent atomic knowledge
├── Resources/      # External links, articles, references
├── Journal/        # Daily notes (YYYY-MM-DD.md)
├── People/         # One note per person
├── Tasks/          # Centralized task tracking
└── Archive/        # Completed projects
```

See [references/structure.md](references/structure.md) for detailed breakdown.

## Capture Rules

### What to Capture (Immediately)

| Type...