Convenciones
Este archivo es la referencia corta sobre cómo se nombran, estructuran y escriben las cosas dentro de tu cerebro. Ninguna de estas reglas es preciosa. Existen para que tú (y la IA que te ayuda) puedan encontrar cualquier cosa en seis meses sin pensar.
Si eres nuevo, lee esto una vez y sigue. Vas a absorber los patrones usándolos.
Nombrar notas
Los archivos dentro de wiki/ usan slugs en kebab-case sin prefijo numérico. Minúsculas, palabras separadas por guiones, sin espacios, sin mayúsculas, sin guiones bajos.
Bien:
wiki/people/jane-doe.mdwiki/projects/abrir-cafeteria.mdwiki/decisions/mudarme-a-berlin-2026.mdwiki/concepts/efecto-red.md
Mal:
wiki/people/Jane_Doe.mdwiki/projects/Abrir Cafeteria.mdwiki/decisions/d-001-mudarme-a-berlin.md
Las notas diarias usan la fecha ISO-8601: wiki/daily/2026-05-13.md. La carpeta wiki/daily/ se crea la primera vez que escribes una nota diaria, no viene en un cerebro recién creado. Los resúmenes de fuentes llevan la fecha adelante para que ordenen cronológicamente: wiki/sources/2026-05-13-reporte-q2.md.
Las carpetas llevan el tipo
La carpeta te dice el tipo de cada página que contiene. wiki/people/ tiene personas, wiki/decisions/ tiene decisiones, wiki/concepts/ tiene conceptos. La carpeta refleja el tipo de la página. El nombre de archivo es el slug. El contenido es el contenido.
La plataforma también mantiene un pequeño encabezado de metadatos al tope de cada página wiki (type, title, status, created, updated, y aliases y tags opcionales). Nunca escribes ese encabezado a mano. La plataforma lo escribe y actualiza automáticamente cuando las páginas se ingestan o editan a través de tu chat de IA. Puedes leerlo, pero no necesitas tocarlo.
Cuando crees una nota a mano, déjala en la carpeta que coincide con su tipo. Si no encaja claramente en ninguna, ponla en wiki/notes/ hasta que encuentre un lugar.
El frontmatter lo gestiona la plataforma, no es obligatorio
La plataforma antepone un bloque YAML pequeño al tope de cada página ingestada. Se ve así:
---
type: concept
title: efecto-red
status: active
created: 2026-05-13
updated: 2026-05-13
---
No lo llenas tú mismo. La plataforma lo escribe durante el ingest. En notas escritas a mano, el frontmatter es opcional y nada se rompe sin él. El único campo que quizás quieras agregar manualmente es aliases (ver abajo).
Wikilinks para interno, markdown links para externo
Las referencias internas usan corchetes dobles: [[jane-doe]]. Las referencias externas usan el link markdown estándar: [a16z](https://a16z.com).
Esto es mecánico, no estilístico. Los wikilinks son cómo el cerebro se vuelve un grafo. Obsidian, graphify y el linter leen [[...]] como una conexión de primera clase entre notas. Los markdown links se tratan como salientes a la web.
Si te encuentras escribiendo el mismo nombre dos veces en una nota, enlaza el segundo. El tú del futuro le va a agradecer al tú del presente.
Una idea por nota
Una nota debería ser sobre una sola cosa. Si estás leyendo una nota y tres temas distintos pelean por atención, divídela. Enlaza las piezas.
Las notas que tratan de cubrir demasiado son difíciles de enlazar. Una página de "persona" debería ser sobre la persona. El proyecto que esa persona corre lleva su propia página en wiki/projects/. El deal que cerraste con ella lleva un resumen de fuente en wiki/sources/. Todas se referencian entre sí.
Este es el hábito de notas atómicas. Notas chicas, bien tituladas, bien enlazadas, componen. Notas grandes y dispersas se pudren.
Fecha cada hecho
Cuando anotes algo que es verdad hoy pero podría no serlo el año que viene, menciona la fecha.
Al 2026-05-13, Jane es VP de Ingeniería en Acme. Reporta al CTO.
Esa sola fecha le dice a la IA (y al tú del futuro) cuándo empezar a desconfiar del hecho. Sin ella, una nota estancada se ve idéntica a una fresca.
Los campos created y updated del frontmatter ayudan, pero las fechas en línea son más fuertes porque sobreviven al copia-pega y a las reescrituras de la IA.
Nada de em-dashes
Usa comas, paréntesis o un punto y una oración nueva. El em-dash es una gran herramienta en ficción, un problema en un cerebro que quieres buscar. La búsqueda y reemplazo se tropieza con él, el texto generado por IA se apoya en él, y después de un año el cerebro se lee como si lo hubiera escrito un ejército de consultores.
Esta es una regla que la IA dentro de tu cerebro tiene que seguir consistentemente. Si ves uno, edítalo. Va a entrenar a la IA a soltar el hábito también.
Aliases para páginas canónicas
El campo aliases en el frontmatter lista las grafías alternativas para la misma entidad:
---
type: person
aliases: [Jane D., J. Doe, Jane Doe-Smith]
---
Esto evita que el cerebro cree tres páginas distintas para la misma persona cada vez que alguien se menciona por un apodo. Cuando ingestas un export de WhatsApp y tu amiga aparece como "Janito", agrégalo a sus aliases en su página canónica. El próximo ingest va a enlazar las menciones nuevas a la persona correcta.
Lo mismo aplica para organizaciones (Acme, Acme Corp, Acme Inc.) y conceptos (efecto red, efectos de red, ley de Metcalfe).
Una página canónica por entidad, cada variante en aliases. Esta es la pieza más útil de higiene que puedes practicar. El cerebro que hace esto es el doble de útil que el que no.
Cuando tengas dudas
Pregúntale a la IA. "Tengo una nota sobre X, dónde debería vivir?" es un prompt de una línea que usualmente devuelve la respuesta correcta. El cerebro está diseñado para que la IA sea tu encargado de archivos. Úsala.