brainrepo

---
name: brainrepo
description: >
  Your personal knowledge repository — capture, organize, and retrieve everything using PARA + Zettelkasten.
  Triggers on: "save this", "remember", "note", "capture", "brain dump", daily/weekly
  reviews, searching stored knowledge, managing projects/areas/people. Works with any AI agent that reads
  markdown. Stores everything as .md files in a Git repo for Obsidian, VS Code, or any editor.
---

# 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