Cómo trabajamos

Context

Plantilla del archivo de reglas

Lo que tu agente lee antes que cualquier otra cosa, listo para copiar.

Este documento en markdown, para leerlo con un agente.

# La plantilla

El archivo que tu agente lee antes que cualquier otra cosa. Cópialo a la raíz
de tu carpeta de trabajo y reemplaza lo que esté entre corchetes.

Guárdalo con el nombre que use tu herramienta: algunas leen `AGENTS.md`, otras
`CLAUDE.md`, otras lo toman como instrucciones del proyecto. El contenido es el
mismo.

Los apéndices son archivos aparte. Empieza sin ninguno: cuando el archivo raíz
pase de dos pantallas, saca a un apéndice el bloque que solo aplica a un tipo
de pedido.

---

# Cómo se trabaja en esta carpeta

Esta carpeta es la operación comercial de [tipo de negocio]. La usan personas y
agentes. Todo lo que importa está en archivos de texto; nada importante vive
solo en una conversación.

## Primer paso de cada turno

1. Clasifica el pedido antes de actuar.
2. Lee los apéndices que apliquen antes de responder, editar o ejecutar. Un
   pedido que cruza dos dominios carga los dos.
3. Las reglas cargadas siguen activas todo el turno.
4. Si el pedido cambia a mitad de conversación, vuelve a clasificar.

| Si el pedido trata de | Lee también |
|---|---|
| Propuestas, precios, correos a clientes, research de mercado | `reglas/comercial.md` |
| Cómo me respondes a mí: tono, largo, formato | `reglas/tono.md` |
| [Tu tercer dominio, cuando aparezca] | [su archivo] |

## Qué hay acá

| Carpeta | Para qué |
|---|---|
| `00-empresa/` | Datos fiscales, marca, decisiones de la empresa |
| `01-lineas/` | Qué vendemos: precios, argumentos, objeciones, aprendizajes |
| `02-cuentas/` | Un directorio por cliente: ficha, reuniones, propuestas, contratos |
| `03-propuestas/` | Solo el índice y el correlativo global |
| `04-casos/` | Trabajo entregado que sirve para vender |
| `05-operacion/` | Agenda, plantillas, procedimientos, decisiones |
| `06-discovery/` | Problemas de cliente antes de que exista propuesta |
| `99-archivo/` | Descontinuado. Se consulta, no se edita |

## Dónde va cada cosa

| Situación | Acción |
|---|---|
| Cliente nuevo | Copiar `02-cuentas/_plantilla/` a `02-cuentas/<slug>/` |
| Reunión | `02-cuentas/<slug>/reuniones/<fecha>-<tema>.md` |
| Propuesta | `02-cuentas/<slug>/propuestas/<numero>-<fecha>/propuesta.md`, con el número tomado del índice global |
| Precio o argumento nuevo | El archivo comercial de la línea en `01-lineas/` |
| Aprendizaje de un negocio | `01-lineas/<linea>/aprendizajes.md` |
| Decisión de proceso | `05-operacion/decisiones/<fecha>-<tema>.md` |
| No encaja en ninguna | Preguntar antes de crear una carpeta nueva |

## Fuentes de verdad

Estos datos se leen de su archivo y no se copian a ningún otro:

- Datos fiscales propios: `00-empresa/fiscal.md`
- Datos fiscales del cliente: `02-cuentas/<slug>/cuenta.md`
- Precios vigentes: `01-lineas/<linea>/comercial/precios.md`
- Contrato de metadatos: `05-operacion/frontmatter.md`
- Correlativo de propuestas: `03-propuestas/INDICE.md`

Si un dato falta o dice pendiente, se pregunta. No se completa con un valor
parecido de otro cliente ni con una estimación.

Cuando un sistema conectado ([ERP, correo, calendario]) y un archivo digan
cosas distintas, manda [el que corresponda] sobre [qué dato exactamente].

## Reglas duras

1. Un dato vive en un solo archivo. El resto lo referencia.
2. Todo archivo de entidad lleva frontmatter con `type`, `slug`, `status`,
   `owner` y `updated`.
3. Nombres de archivo en minúscula con guiones. Fechas como `2026-08-14`.
   Montos siempre con su moneda al lado.
4. Nunca inventar cifras, fechas, nombres ni resultados. Si no está en un
   archivo o en una fuente citada, no existe.
5. No presentar una inferencia como un hecho, ni declarar algo verificado sin
   haberlo comprobado. Si no se pudo comprobar, decirlo y nombrar qué falta.
6. Nunca escribir contraseñas, llaves ni tokens en estos archivos.
7. Antes de una acción difícil de revertir (enviar, publicar, borrar, firmar),
   proponer y esperar confirmación explícita en ese momento. Un plan aprobado
   antes no es autorización.
8. Después de dos intentos fallidos con el mismo enfoque, detenerse y reportar
   qué falló, qué se probó y dos alternativas.
9. Una corrección del usuario vale para el resto de la sesión, no solo para ese
   mensaje.

## Cómo se escribe

- [Idioma] neutro, directo, sin adornos.
- Frases cortas. Preferir una tabla a un párrafo cuando hay datos.
- Nada de superlativos sin respaldo ni palabras de relleno.
- Una pregunta a la vez, y esperar la respuesta. No juntar cuatro al final de
  un texto largo.
- En documentos que ve el cliente: sin emojis y con la ortografía completa.

## Al empezar cualquier tarea

1. Leer este archivo y los apéndices que apliquen.
2. Leer el archivo de la entidad involucrada (la cuenta, la línea).
3. Si falta información para decidir, preguntar y esperar.

## Al terminar

Actualizar el archivo que corresponda y su campo `updated`. Un trabajo que no
quedó escrito en la carpeta no ocurrió.