Área de clientes de Retama
Los clientes de Retama no tienen que escribir para saber cómo va su proyecto. Entran con una invitación y una passkey. Dentro ven el avance por fases con las decisiones explicadas para ellos, y hablan con el estudio en una conversación por proyecto. Lo interesante está detrás: nadie actualiza ese avance a mano.
Cómo funciona
El área de clientes
Es una aplicación Astro con renderizado en servidor sobre Cloudflare Workers, con la base de datos y los archivos guardados en la UE. Solo se entra por invitación: el enlace sirve una vez y caduca a los siete días, y la persona registra una passkey en lugar de una contraseña.
Cada proyecto muestra sus fases con lo que el cliente podrá hacer al terminarlas y lo que Retama necesita de él, la documentación con el motivo de cada decisión, los presupuestos y las facturas en PDF y una conversación con el estudio.
Cada cliente solo ve lo suyo. Una capa de acceso obligatoria toma la organización de la sesión, nunca de la petición, y un recurso ajeno responde igual que uno que no existe. Cada escritura se guarda junto a su entrada en un registro de auditoría al que solo se puede añadir.
El avance sale del repositorio
Los proyectos de Retama se construyen con Ospec-Workflow, así que cada cambio pasa por la CLI ospec y queda registrado con su evidencia. Cuando un cambio llega a la rama de integración, el CI ejecuta ospec snapshot, que junta el roadmap, los cambios cerrados, el changelog y los textos escritos para el cliente en un JSON versionado.
El repositorio lo publica con una credencial que solo sirve para ese proyecto, y la app lo valida contra su contrato. Si algo no cuadra lo rechaza, y el cliente sigue viendo la última versión buena. La app nunca lee los repositorios.
El estado de cada fase sale de git. Está en curso cuando se abre su cambio, pasa a «En pruebas» al fusionarse y a «En producción» con su release. El cliente ve lo mismo que el equipo sin que nadie tenga que acordarse de actualizar nada.
El playbook de Retama
Encima de ospec va un playbook privado: un marketplace de plugins para Claude Code con las reglas del estudio, desde la privacidad hasta la forma de entregar, y skills auditadas de diseño, redacción, SEO y Cloudflare. Cada sesión de trabajo arranca con esas reglas cargadas, sea un proyecto propio o de un cliente.
El reparto es deliberado. Lo genérico vive en Ospec-Workflow, que es abierto y sirve a cualquiera. Lo propio de Retama, como el contrato del área de clientes o la marca, se queda en el playbook, que nombra los comandos de ospec y exige una versión mínima pero nunca lo sustituye.
Una de sus skills da de alta un proyecto en el área: crea la organización y el proyecto con sus invitaciones a través del conector, y después comprueba que ha llegado el primer snapshot.
Gestión desde Claude
La propia app expone un servidor MCP con OAuth 2.1 que solo el estudio puede autorizar, siempre con su passkey. Las consultas son directas. Cualquier cambio, como contestar a un cliente o marcar una factura como pagada, pide dos llamadas: la primera enseña lo que va a pasar y devuelve un código que caduca en minutos, y la segunda lo ejecuta junto a su entrada de auditoría.
Así el círculo se cierra. El cliente pide algo, el agente lo construye bajo ospec con las reglas del playbook, el CI publica el avance y el cliente lo ve en su área y responde desde ella. La propia área de clientes se construye igual y publica su avance en sí misma.