🧠 peter-brain

Tu segundo cerebro en Markdown, manejado por agentes de Claude Code.

Sistema operativo personal basado en la metodología PARA (Projects, Areas, Resources, Archives) y diseñado para usuarios de Claude Code.

¿Qué es esto?

Un repo template para armar tu propio "second brain" donde notas, decisiones, tareas, proyectos y agentes ejecutores viven en archivos Markdown locales. Claude Code es la interfaz: capturás, procesás y ejecutás todo desde una terminal con comandos slash.

¿Por qué un template y no una app?

Vos sos el dueño: son archivos Markdown en tu disco. Sin SaaS, sin lock-in, sin precio mensual.
Versionado: cada cambio queda registrado en git.
Sincronizable: poné el repo en Google Drive, iCloud, Dropbox o donde quieras.
Extensible: agregás comandos y agentes propios cuando los necesités.
Visual opcional: si abrís la carpeta con Obsidian, tenés un dashboard tipo kanban automático.

¿Cómo arrancar?

Pre-requisitos

Claude Code instalado.
(Opcional) git. Si lo tenés, cada cambio queda versionado y podés volver atrás; si no, el sistema funciona igual y lo único que no vas a tener es el historial.
(Opcional) Obsidian si querés el dashboard visual.
(Opcional) Una cuenta de Google si vas a usar los MCPs de Gmail/Calendar/Drive.

Instalación

# 1. Cloná el template (o usá "Use this template" en GitHub)
git clone https://github.com/[tu-usuario]/peter-brain.git mi-peter-brain
cd mi-peter-brain

# 2. Abrí Claude Code en la raíz
claude

# 3. Pegá esto y seguí los pasos:
> Leé bootstrap.md y guiame para personalizar mi peter-brain.

¿Sin git? Bajá el ZIP desde GitHub —botón verde Code → Download ZIP—, descomprimilo, renombrá la carpeta a mi-peter-brain y seguí desde el paso 2. No necesitás instalar nada más.

El bootstrap.md te va a preguntar tu nombre, qué áreas iniciales querés crear (opcional), y deja el sistema listo en 5 minutos.

Estructura

peter-brain/
├── .claude/                  # Config de Claude Code: CLAUDE.md, commands, agents
│   ├── CLAUDE.md             # Instrucciones globales para Claude
│   ├── commands/             # 9 slash commands listos para usar
│   └── agents/               # 3 sub-agentes (research, writer, executor)
├── PARA/
│   ├── projects/             # Trabajo activo con outcome y deadline
│   ├── areas/                # Responsabilidades permanentes (trabajo, salud, etc.)
│   ├── resources/            # Material de referencia
│   └── archives/             # Proyectos cerrados o pausados
├── inbox/backlog.md          # Captura rápida sin clasificar
├── recurring/                # Tareas que se repiten en cadencia fija
├── skills/                   # Skills opcionales (ej: debrief)
├── mission-control.md        # Dashboard kanban (requiere Obsidian + Dataview)
└── bootstrap.md              # Setup guiado (corré una vez al instalar)

Cada proyecto/área tiene la trinidad: knowledge.md (decisiones acumuladas) + todo.md (tareas) + log.md (bitácora de sesiones).

Comandos disponibles

Comando	Para qué
`/capture "idea"`	Captura rápida al inbox, sin clasificar
`/process-inbox`	Procesa items del inbox y los rutea a su lugar
`/debrief [name]`	Cierre de sesión: resumen + actualizar knowledge/todo/log
`/show-tasks [filter]`	Lista pendientes filtrados
`/run-task [id]`	Dispara el sub-agente que corresponde
`/review-recurring`	Revisa qué recurrentes ejecutar hoy
`/start-project "name + desc"`	Crea un proyecto/área nuevo con la trinidad
`/read-meeting-notes [src]`	Procesa notas de meetings y rutea tareas
`/para-init [scan]`	Audita la estructura PARA y propone gaps

Personalización avanzada

Roles activables (modo "X")

Si querés activar contextos específicos (ej: "modo estratega", "modo coach"), seguí el patrón SSOT + wrappers documentado en .claude/CLAUDE.md sección "Convención para roles activables". TL;DR:

Definí el rol en PARA/areas/[name]/role/[rol].md (la fuente única de verdad).
Creá un wrapper fino en .claude/commands/[rol].md que apunte al SSOT.

MCPs

mcp-config.json viene con Gmail, Calendar y Drive configurados como referencia. Necesitás regenerar credenciales propias en ~/.config/peter-brain/ (la guía oficial está en la doc de cada MCP).

Sub-agentes

Los 3 sub-agentes que vienen:

research-agent: investigación web. Read-only.
writer-agent: drafts (emails, posts). No envía.
executor-agent: ejecuta acciones reales vía MCPs. Siempre pide confirmación antes de algo irreversible.

Podés agregar los tuyos en .claude/agents/.

Inspiración

PARA Method (Tiago Forte) — la arquitectura base.
AI second brain de Meta — el concepto de "knowledge worker + agentes".
Dotfiles culture — versionar tu setup personal en git.

Licencia

MIT. Usalo, modificalo, vendelo, lo que quieras. Si te resulta útil, una mención al repo me alegra el día.

Contribuir

PRs y issues bienvenidos. Si armaste un command o agente que te resultó útil, mandalo — la comunidad lo agradece.