# Frailen, instalado por tu agente

> Tu agente de código puede leer todo el sitio, armar las fichas desde tu OpenAPI y preparar la integración en una rama. Tú revisas y apruebas; él nunca publica.

## Empieza con una línea

Cópiala en Claude Code, Cursor, Codex o cualquier agente que pueda leer una URL. Apunta a [get-started.md](https://frailen.com/es/get-started.md), una guía que tu agente sigue paso a paso en una rama.

```text
Prepara Frailen por mí. Lee https://frailen.com/es/get-started.md y síguelo.
```

En Claude Code, desde tu terminal:

```bash
claude "Prepara Frailen por mí. Lee https://frailen.com/es/get-started.md y síguelo."
```

## O el prompt completo

El mismo trabajo en un solo prompt, si prefieres verlo todo antes de pegarlo.

### Instala Frailen en este repositorio

```text
Lee https://frailen.com/es/llms.txt y https://frailen.com/es/desarrolladores.md. Después prepara Frailen en este repositorio, en una rama nueva:

1. Busca nuestra especificación OpenAPI, o las rutas de la API que un agente de soporte puede tocar. Escribe una ficha de Frailen por operación en herramientas/*.yaml, con su patrón, sus banderas de daño (dinero, masivo, terceros, sin_reversa), cómo se deshace y cómo se relee. Solo un GET puede ser una lectura.
2. Agrega POST /frailen/token a nuestro backend: canjea nuestra sesión firmada (un JWT ES256) por un token de API de ese mismo usuario, de 300 segundos o menos (RFC 8693).
3. Agrega la etiqueta del chat de Frailen al layout principal de la app.
4. Escribe tres casos del banco de pruebas en pruebas/ para nuestros pedidos de soporte más comunes.

No apruebes, publiques ni despliegues nada. Termina con un resumen de lo que hiciste y de lo que necesita una decisión de una persona.
```

## Un prompt para cada paso

Pega cualquiera en Claude Code, Cursor, Codex o cualquier agente que pueda leer una URL.

### Pregúntale si encaja con tu producto

```text
Lee https://frailen.com/es/llms-full.txt. Después mira nuestro código y dime si Frailen encaja con nuestro producto: qué operaciones de la API serían herramientas, cuáles tendrían daño, qué nos faltaría construir y qué preguntarías en la demo. No cambies nada.
```

### Arma las fichas desde nuestro OpenAPI

```text
Lee https://frailen.com/es/desarrolladores.md. Desde nuestra especificación OpenAPI, escribe las fichas de Frailen en herramientas/, una por cada operación que debería usar nuestro agente de soporte. Solo un GET puede ser una lectura. Ponle a cada escritura sus banderas de daño (dinero, masivo, terceros, sin_reversa), se_deshace_con si se deshace, y relee_con con el GET que prueba que quedó. Haz la lista de las operaciones que dejaste fuera y por qué.
```

### Agrega la ruta del token

```text
Lee https://frailen.com/es/desarrolladores.md. Agrega POST /frailen/token a nuestro backend (canje de tokens, RFC 8693): recibe nuestra sesión firmada como subject_token (un JWT ES256), la verifica contra nuestro JWKS y devuelve un token Bearer de ese mismo usuario que vence en 300 segundos o menos. Agrega pruebas. Nunca escribas la sesión ni el token en los registros.
```

### Monta el chat en la app

```text
Lee https://frailen.com/es/desarrolladores.md. Agrega el chat de Frailen a nuestra app: la etiqueta en el layout principal, con data-empresa y data-asercion apuntando a una ruta de nuestro backend que firme una aserción ES256 de 60 segundos para el usuario con sesión. Pásale como contexto la página actual y el objeto que tiene abierto.
```

### Escribe el banco de pruebas

```text
Lee https://frailen.com/es/desarrolladores.md. Escribe cinco casos del banco de pruebas de Frailen en pruebas/ para los pedidos que más recibe nuestro equipo de soporte. Cada caso lleva el mensaje del usuario, el estado final esperado leído con una herramienta GET y una regla escrita antes de correrlo. Un caso tiene que comprobar que otra cosa no cambió.
```

### Revisa la seguridad con tu agente

```text
Lee https://frailen.com/es/seguridad.md y https://frailen.com/es/llms.txt. Revisa el modelo de seguridad de Frailen contra nuestro producto: identidad y tokens, qué se guarda y por cuánto tiempo, el aislamiento entre empresas y cómo funciona el freno. Haz la lista de preguntas que nuestro equipo de seguridad debería hacer antes de un piloto, y de lo que Frailen dice que todavía no tiene.
```

### Calcula qué nivel les sirve

```text
Lee https://frailen.com/es/precios.md. Nuestro producto atiende unas [conversaciones al mes] conversaciones de soporte al mes. Calcula qué nivel de Frailen nos sirve, cuánto pagaríamos con esos precios de referencia y qué tope de gasto pondrías. Di qué números son supuestos.
```

## Lo que tu agente puede leer

- [https://frailen.com/es/llms.txt](https://frailen.com/es/llms.txt): el resumen, con enlaces.
- [https://frailen.com/es/llms-full.txt](https://frailen.com/es/llms-full.txt): todo el sitio en un archivo.
- Cada página en Markdown: agrega `.md` a su ruta, como https://frailen.com/es/precios.md o https://frailen.com/es/desarrolladores.md. La portada es https://frailen.com/es/index.md.
- En inglés, los mismos archivos sin /es: https://frailen.com/llms.txt.

## Reglas para tu agente

Agrega esto al AGENTS.md o al CLAUDE.md de tu repositorio:

```markdown
## Frailen
- Antes de tocar archivos de Frailen, lee https://frailen.com/es/llms.txt (y https://frailen.com/es/llms-full.txt si necesitas el detalle).
- Las fichas van en herramientas/*.yaml y los casos del banco en pruebas/*.yaml.
- Solo un GET puede ser una lectura. Toda escritura lleva sus banderas de daño; nunca quites una para que pase una prueba.
- Nunca escribas en registros ni subas al repositorio sesiones, tokens ni llaves.
- Tú preparas la integración en una rama. Una persona aprueba las herramientas y prende el agente con su passkey: tú nunca apruebas, publicas ni despliegas.
```

## Lo que viene

El CLI (`@frailen/cli`) y un servidor MCP para agentes de código están en construcción. Mientras tanto, tu agente trabaja con estos archivos y estos prompts.

Esta página en inglés: [/agentes.md](/agentes.md)
