Brainforge Second Brain

Personal AI memory and knowledge system — 13 Pydantic AI agents backed by Mem0, Supabase/pgvector, and Voyage AI. Exposed via FastMCP server and Click CLI.


Core Principles

@sections/01_core_principles.md


PIV Loop Methodology

@sections/02_piv_loop.md


Context Engineering

@sections/03_context_engineering.md


Git Save Points

@sections/04_git_save_points.md


Decision Framework

@sections/05_decision_framework.md


Tech Stack

@sections/07_tech_stack.md


Architecture

@sections/08_architecture.md


Code Style

@sections/09_code_style.md


Testing

@sections/10_testing.md


Common Patterns

@sections/11_common_patterns.md


Dev Commands

@sections/12_dev_commands.md


On-Demand Guides

All guides in reference/. Load when the task requires it.

GuideWhen
layer1-guideNew project CLAUDE.md setup
system-foundationsLearning system mental models
piv-loop-practicePIV Loop practical application
validation-discipline5-level validation pyramid
file-structureFile location lookup
command-design-frameworkSlash command design
subagents-deep-diveSubagent creation
archon-workflowArchon tasks / RAG

Template System: This project uses the modular @sections architecture. Sections 01-05 = methodology. Sections 07-12 = application (tech stack, architecture, style, testing, patterns, commands).