BrainRepo

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

Brain Location

Fixed path: INLINECODE0

This is not configurable. All brain data lives here.

First Run Check

Before any action, check if brainrepo is initialized:

1. 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. 1. Create brain at INLINECODE2
2. Create the folder structure:

CODEBLOCK0

1. 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

1. 4. Initialize git (optional):

CODEBLOCK1

1. 5. Confirm setup and show quick start commands

Core Concept

DUMP → PROCESS → RETRIEVE

1. 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

CODEBLOCK2

See references/structure.md for detailed breakdown.

Capture Rules

What to Capture (Immediately)

Type	Destination	Example
Quick thought	INLINECODE7	"Maybe we should..."
Decision made

Inbox/ or Notes/ | "Decided to use Next.js" | | Person info | People/ | New contact or update | | Project update | Projects/<name>/ | Meeting notes, progress | | Task/Todo | Tasks/index.md | "Need to finish X" | | Link/Article | Resources/ or Inbox/ | URL with context | | Personal growth | Areas/personal-growth/ | Health, habits, learning | | Family info | Areas/family/ | Important dates, notes |

What NOT to Capture

• - Casual chat without information value
• Temporary queries ("what time is it")
• Information easily searchable online

Note Format

Every note uses minimal frontmatter:

CODEBLOCK3

Use templates from assets/templates/ when creating new notes.

Daily Workflow

During Day

• - Dump everything to INLINECODE18
• Don't organize — just capture

Evening (5-10 min)

Process Inbox/:

1. 1. Each item → permanent home or delete
2. Update Journal/YYYY-MM-DD.md with summary
3. INLINECODE20

Weekly Review (Sunday, 15 min)

1. 1. Review all Projects/ — still active?
2. Check Areas/ — anything neglected?
3. Move completed projects to Archive/
4. Update INLINECODE21

See references/workflows.md for detailed workflows.

Commands

User says	Action
"Set up brainrepo"	Run onboarding, create structure
"Save this: [text]"

Capture to Inbox/ | | "New project: [name]" | Create Projects/name/ with template | | "Add person: [name]" | Create People/name.md with template | | "What do I know about X?" | Search & retrieve | | "Daily review" | Process Inbox/, update Journal/ | | "Weekly review" | Full system review |

Linking

Use [[wiki-links]] to connect notes:

CODEBLOCK4

Projects vs Areas

Projects	Areas
Have deadlines	No end date
Can be "done"

Maintained forever | | Specific outcome | Standard to uphold |

File Naming

• - Folders: INLINECODE23
• Files: INLINECODE24
• Dates: INLINECODE25
• People: INLINECODE26

References

• - Structure Guide — Detailed folder breakdown
• Workflows — Daily/weekly/monthly workflows
• Templates — Note templates