Spec v0.1 · Convención abierta · MIT
Dale a tus agentes de IA
criterio donde acaba el prompt.
NORTH.md es una convención abierta: un archivo markdown que declara el propósito, la ambición y los trade-offs precalculados de un proyecto para personas y agentes de IA. Cuando les toca adivinar, los agentes tienden a entregar la versión segura e incremental. Este archivo les dice hasta dónde llegar y cómo desempatar.
Es la capa de dirección de un modelo de cinco capas que proponemos, junto a CONSTITUTION.md (límites), AGENTS.md (cómo), DESIGN.md (aspecto) y SOUL.md (quién).
Un modelo propuesto
Cinco archivos. Cinco preguntas.
Los agentes ya leen varios archivos de contexto. Proponemos verlos como cinco capas, desde los límites que un proyecto nunca cruza hasta la dirección que lleva. Es un modelo, no un estándar, y la mayoría de los repositorios usará solo algunas capas.
- L1 Límites Fronteras Comunidad · agentconstitution.dev
CONSTITUTION.md
Principios innegociables y fronteras.
- L2 Cómo Ejecución agents.md
AGENTS.md
Cómo compilar, probar y trabajar en el repositorio.
- L3 Aspecto Diseño Google Labs
DESIGN.md
Tokens de diseño y la razón de cada uno.
- L4 Quién Persona soul.md
SOUL.md
La persona, los valores y el tono del agente.
- L5 Por qué Dirección Especificación v0.1
NORTH.md
Propósito, ambición y trade-offs precalculados: por qué y hasta dónde.
Ninguna capa sustituye a otra. Los límites (L1), la ejecución (L2), el aspecto (L3) y la persona (L4) responden cada uno a su pregunta. NORTH.md responde a la que queda abierta: por qué existe el proyecto y hasta dónde empujar.
Ver la comparativa completa →Siete secciones. Un archivo.
Cada una responde a una pregunta que, sin ella, el agente tendría que adivinar.
- Estrella Polar El destino, en una frase. Ni el roadmap ni el próximo trimestre.
- El Listón Lo que cuenta como terminado: medible, por encima de la media del sector y defendido por controles.
- Apuestas Asimétricas Dónde el proyecto apuesta 10x y dónde 1.1x es lo correcto.
- Anti-Objetivos Lo que el proyecto rechaza aunque sea fácil o rentable. Decidido una vez, con su motivo.
- Trade-offs por Defecto Los dilemas recurrentes, resueltos de antemano, cada uno con la condición que lo invierte.
- Disparadores de Ambición Preguntas breves, para personas y prompts, que amplían el alcance cuando el equipo piensa en pequeño.
- Reversibilidad Qué decisiones son puertas de un solo sentido y cuáles de doble sentido. Las primeras se deliberan; por las segundas se pasa rápido.
Adóptalo en diez minutos
Copia la plantilla, rellena las siete secciones y enlázala desde los archivos que tus agentes ya leen. Un primer borrador lleva diez minutos. Uno bueno lleva más, y ahí está el valor.
- Guárdalo en la raíz del repositorio como
NORTH.md - Enlázalo desde
CLAUDE.mdo AGENTS.md. - Opcional: añade el badge a tu README.
<!-- NORTH.md spec: v0.1 -->
# NORTH.md
## 1. North Star
[One sentence. The destination, not the roadmap.]
## 2. The Bar
[What quality threshold counts as "shipped".]
## 3. Asymmetric Bets
[Where we go 10x. Where we accept 1.1x.]
## 4. Anti-Goals
[What we refuse, even when easy or profitable.]
## 5. Trade-off Defaults
| Trade-off | Default | Flip when |
|---|---|---|
| Speed vs. safety | Safety on core logic; speed on internal tools | An internal tool starts writing core data |
| Build vs. buy | Buy infrastructure; build core product | Vendor breaks unit economics |
## 6. Ambition Triggers
[Phrases that escalate scope when we are thinking too small.]
## 7. Reversibility
[One-way doors flagged. Two-way doors = move fast.]Añade el badge
Una línea en tu README. Indica que el repositorio tiene un NORTH.md y enlaza a la especificación.
Enlaza a northfile.dev [](https://northfile.dev)