🧬 Cuéntale a Lagune qué es tu proyecto y lo convierte en tus reglas de seguridad (o, si no lo describes, las deduce a partir del propio proyecto).
El charter es la capa rectora: un conjunto de principios que ponen la seguridad por delante y que todas las fases posteriores deben respetar. Piensa en él como la comprobación en tiempo de compilación de la postura de seguridad de tu proyecto.
Cómo usarlo
- Describirlo
- Dejar que Lagune proponga
/lagune-charter Mi proyecto es una tienda online de videojuegos. Los clientes añaden productos a un carrito y pagan con tarjeta de crédito o por transferencia bancaria. Pueden ver sus pedidos y el estado de cada uno.
/lagune-charter
Veo una biblioteca de pagos, un sistema de inicio de sesión y un modelo de pedidos vinculado a un cliente. Parece una tienda online que vende algo. Los clientes pagan y hacen el seguimiento de sus propios pedidos... ☁️
Lo que deduce
Lagune toma tu descripción o tu PRD como guía, deduce lo que implica para la seguridad y luego lee el proyecto para ir más allá de lo que mencionaste. Por ejemplo:
- Un carrito que guarda pedidos implica que hay una base de datos:
- p. ej.,
"¿Dónde se guardan los datos?","¿Quién puede acceder a ellos?","¿Se filtran?".
- p. ej.,
- Que los clientes puedan ver sus propios pedidos implica algún tipo de inicio de sesión o control de acceso:
- p. ej.,
"¿Puede un cliente acceder a los pedidos de otro?","¿Están protegidas las sesiones?".
- p. ej.,
- Aceptar pagos con tarjeta y por transferencia implica que hay dinero y datos sensibles en juego:
- p. ej.,
"¿Se guardan los datos de las tarjetas?","¿Se verifican los pagos?".
- p. ej.,
Tu descripción y el proyecto se suman: tu descripción marca la intención, y la lectura de las dependencias, el README y la configuración saca a la luz lo que no mencionaste. Si algo importante sigue sin estar claro, Lagune te hace una pregunta breve y sencilla en lugar de suponer.
A partir de ahí, Lagune crea un conjunto de reglas de seguridad a medida para el proyecto, que puedes revisar y ajustar siempre que lo necesites.
- También puedes definir tus propias reglas de seguridad para el proyecto.
- Cuantos más detalles relevantes des, mejor será el informe final:
- Explica el proyecto, cómo funciona y qué ocurre por dentro.
- ¿Quién es el usuario final? ¿Qué pueden hacer los usuarios y qué no?
- Los detalles de comportamiento valen tanto como los técnicos.
- La memoria del charter se guarda en
.lagune/memory/charter.md.
Las categorías que registra
Las especializaciones, el conocimiento de seguridad que las fases posteriores cargan bajo demanda, se incorporan al catálogo de tu proyecto por categoría. Mientras tu proyecto no tenga ninguna categoría registrada, el charter registra cada una que justifique su lectura, como el lenguaje de tu proyecto, las llamadas a un LLM o los contenedores, y las nombra en su resumen.
Una vez registradas las categorías, el charter las deja como están y solo menciona las categorías que tu proyecto aún no usa. Cámbialas tú mismo cuando quieras:
npx lagune write add --categories python
npx lagune write remove --categories python
Siguiente paso
Con las reglas fijadas, identifica qué hace realmente tu sistema: /lagune-detect.
Preguntas frecuentes
El charter es la capa rectora de Lagune, un conjunto de principios que ponen la seguridad por delante y que todas las fases posteriores deben respetar. Piensa en él como la comprobación en tiempo de compilación de la postura de seguridad de tu proyecto.
En .lagune/memory/charter.md.
Sí. Lagune propone reglas a partir de tu descripción y de tu código, y puedes reformularlas, eliminarlas, añadir otras o acotar su alcance.
Solo mientras no haya ninguna registrada. En ese caso registra cada categoría que justifique su lectura, como tu lenguaje o las llamadas a un LLM. Una vez registradas, nunca las cambia.