Kit de agentes · cómo usarlo

Esta página es para quien ha comprado el Sistema de agentes de producto. Guárdala: es tu manual y se actualiza con cada versión.

0. Qué tienes entre manos

Una carpeta con diez especialistas de producto (investigación, creatividad, producto, negocio, diseño de interfaz, accesibilidad, tecnología, proveedores, lanzamiento y proyecto) que dirige Claude por ti. Recorren cinco fases, IDEA → SOLUCIÓN → MVP → V1 → PUBLICAR, y cada una termina con algo que puedes señalar: la tesis de tu idea, un prototipo que se toca, el producto funcionando en tu ordenador, la V1 y el producto en marcha a tu escala. Revisan cada cosa dos veces antes de consultarte, y cuando preguntan vienen con una recomendación y un clic, nunca más de tres preguntas juntas, siempre con un "no lo sé, decide tú". Puedes llegar con una idea, con un problema o sin nada. No necesitas saber de producto ni de programación. Solo de tu idea y de ciclismo.

1. Antes de empezar (una sola vez, 10 minutos)

Cuenta de Claude con plan Pro. Entra en claude.ai, crea la cuenta y contrata el plan Pro (unos 20 $ al mes). El plan gratuito no incluye Claude Code, y sin Claude Code el sistema no arranca.
La aplicación Claude Code. Descárgala en claude.ai/code para Mac o Windows, instálala y entra con la misma cuenta. Es la app desde la que vas a trabajar: se abre sobre una carpeta y lee lo que hay dentro.

Sobre los modelos: el sistema funciona con cualquier modelo que tengas activo. Con Opus va perfecto. Fable está disponible en Pro pero con un límite semanal; cuando se agote, sigue con Opus sin cambiar nada.

2. Conectar tu carpeta con tu equipo (3 minutos)

Descarga el ZIP desde el enlace de tu pedido. Es tu carpeta de proyecto: los agentes no van dentro, viven en el servidor de Fred's y llegan a la carpeta con tu código de acceso (empieza por FREDS-, viene en el correo de compra). Guárdalo: te lo pedirá el equipo la primera vez.
Descomprímelo. Aparece la carpeta FRED-AGENTS-SYSTEM. Esa carpeta es tu proyecto. Puedes renombrarla ("MiAppDeGravel", por ejemplo) y moverla a donde quieras.
⚠️ Muévela entera. Nunca los archivos de dentro. La carpeta lleva archivos ocultos que el Finder y el Explorador no enseñan. Si seleccionas el contenido y lo arrastras, se quedan atrás y el sistema no arranca. Arrastra o duplica siempre la carpeta completa.
Abre Claude Code y elige esa carpeta (no la que la contiene). Sabrás que estás bien si en la lista de archivos ves CLAUDE.md y EMPEZAR-AQUI.md.

Al abrir la sesión, Claude se presenta y te pide el código de acceso. Pégalo: la carpeta queda a tu nombre y conectada con tu equipo. Después te dirá que cierres la sesión y la vuelvas a abrir en la misma carpeta: la conexión se abre al iniciar. Si Claude Code te pregunta si la carpeta puede usar el servidor "freds", di que sí (una sola vez). A partir de ahí, cada vez que abras la carpeta, el equipo llega solo. Si en vez de eso Claude responde como si no hubiera nada, estás en la carpeta equivocada: ciérrala y abre la de dentro.

Necesitas conexión a internet mientras trabajas con el equipo. Tu proyecto y lo que aprenden tus agentes viven en tu ordenador; los especialistas y el método, en el servidor.

3. Los primeros quince minutos

Cuenta en dos o tres frases lo que tienes en la cabeza, como se lo contarías a un amigo. Puede ser una idea, un problema que te gustaría resolver o solo ganas de crear algo para la bici: si no tienes la idea, el equipo busca lo que duele de verdad entre ciclistas, te enseña dónde y eliges. Nada de formularios.
Lo que no pueda deducir de lo que has contado te lo pregunta en una sola tanda, con botones: quién hay detrás (tú, un profesional, una tienda o un club) y qué ambición económica tiene el producto (sin coste, gratis con un gasto pequeño, o cobrar y crecer). Se responde con un clic.
Te entrega un borrador de tu idea escrito por el equipo, con sus supuestos marcados, y te pregunta solo lo que cambiaría ese borrador. Reaccionar a algo concreto es mucho más fácil que responder en abstracto.
Cada respuesta termina con la frase exacta que puedes escribir para seguir. Normalmente, siguiente.

4. Cómo se trabaja a partir de ahí

Tu panel es Producto/00-ESTADO.md. Un solo archivo: dónde estamos, qué toca, qué está bloqueado. Si prefieres preguntar, escribe ¿qué toca?.
Todo el trabajo queda escrito en la carpeta Producto/: la verdad del proyecto, la idea, las decisiones, las preguntas, los riesgos. No hace falta que los leas. Están ahí para que nada se pierda entre sesiones.
Cada puerta se cierra con dos revisiones de dos especialistas distintos. Si algo no pasa, el sistema lo devuelve antes de molestarte. Y al cerrarla ves en cinco líneas qué se exploró, qué se decidió y por qué: sin abrumarte, pero sabiendo que detrás hay un método.
El equipo defiende una primera versión simple, que se explique en una frase y se cuente sola de un ciclista a otro. Cuando recorta por eso, te dice por qué.
Si no te apetece decidir, escribe sigue tú: avanza con borradores y supuestos y solo para cuando de verdad te necesita.
Puedes cerrar y volver cuando quieras. Al abrir de nuevo la carpeta, retoma exactamente donde lo dejaste.
Tus agentes aprenden de tu caso y suben de nivel cuando una regla se confirma. Lo ves en tu panel, y ese aprendizaje es tuyo: vive en tu carpeta y ninguna versión nueva lo toca.

5. Las palabras que mueven el sistema

Escribes	Qué pasa
`siguiente`	Avanza al siguiente paso.
`sigue tú`	Piloto automático hasta la próxima decisión importante.
`¿qué toca?`	Te dice en qué punto estás y qué viene ahora.
`modo aprendizaje`	Te explica el porqué de cada paso mientras trabaja. Para quien quiere aprender el oficio.
`cierra sesión`	Actualiza el panel y te cuenta qué ha aprendido tu equipo hoy.
`evolucionar`	Empaqueta tus agentes con lo que han aprendido, para llevártelos a tu siguiente proyecto.

6. Cuando toque construir y probar

El código de tu producto vive en la carpeta App/. Se crea sola cuando llega el momento.
El MVP se construye delante de ti, por trozos que puedes usar de principio a fin. Después de cada uno el equipo te pregunta qué le cambiarías, y lo que digas entra en esa misma fase. La das por cerrada tú, cuando te sirve para tu problema.
Antes de pedirte ninguna cuenta ni clave de ninguna plataforma, verás tu producto entero funcionando con datos de prueba y un recorrido guiado. Las cuentas se piden después, con instrucciones paso a paso.
Probar con personas: con tres basta. El equipo trae mensajes listos para copiar para tu club, tu grupo o tu tienda, y un guion de quince minutos. Siempre te pregunta antes si quieres hacerlo tú: si no, tira de fuentes públicas y sigue. Si no tienes acceso a ciclistas, baja de nivel: siempre hay algo que puedes hacer.
Sobre el aspecto: antes del prototipo verás tu propia pantalla principal dibujada en dos o tres direcciones distintas, con apps que ya conoces como referencia, y eliges mirando. Después, cada pantalla se prueba con datos imposibles (un nombre larguísimo, mil elementos, nada) y la revisa alguien del equipo que no la ha construido. Si algo te parece soso o recargado, dilo así: el equipo sabe qué tocar.

7. Las mejoras llegan solas

Tu compra incluye un año de mejoras del sistema, y no tienes que instalar nada: cuando publiquemos una versión nueva, tu equipo trabaja con ella la próxima vez que abras la sesión y te lo dice en una línea. Recibirás también un correo contándote qué cambia. Tu proyecto, tu código y lo que han aprendido tus agentes no se tocan: viven en tu ordenador y ninguna versión los modifica.

Cuando termine el año, sigues trabajando para siempre con la última versión que alcanzaste. Si quieres seguir recibiendo mejoras, podrás renovar en freds.cc. Y si algún día el servicio cerrara de forma definitiva, recibirías esa versión como paquete para usar en local, sin coste.

Qué produce el equipo y qué no: una V1 en marcha a la escala que pida tu idea. Para muchos, eso es tenerla en el móvil o el ordenador, usarla con su grupo y seguir mejorándola; si quieres llegar a tiendas de apps, cobrar y abrirlo a la gente, la última fase te lleva hasta el final. Las cuentas, los pagos y la publicación los haces tú con el equipo delante, y lo que necesite un profesional (datos personales a escala, menores, fiscalidad) el equipo te lo dice y nunca lo da por hecho.

8. Tu acceso

Tu carpeta queda conectada a tu nombre con tu código: el equipo te saluda con él. Vale para tres ordenadores y para tantos proyectos como quieras: si cambias de ordenador o empiezas otro proyecto, vuelve a pegar el código. Todo lo que crees con él es tuyo. El código y la llave de tu carpeta no se pueden compartir, regalar ni revender: cada consulta al servidor va ligada a tu pedido, y si una llave aparece donde no debe, el acceso se revoca. Si vas a enviar tu carpeta a alguien (por ejemplo para una sesión de consultoría), pídele antes a Claude que retire tu llave (./activar-licencia.sh --desactivar). Las condiciones completas están en LICENCIA.md, dentro de la carpeta.

9. Problemas frecuentes

Abro Claude Code y responde como si no hubiera nada.: Has abierto la carpeta que contiene el proyecto, no el proyecto. Cierra y abre la carpeta de dentro, la que tiene CLAUDE.md.
Claude dice que faltaba una carpeta del sistema y la ha restaurado.: Normal: algunos descompresores pierden la carpeta oculta y se repara sola. Cierra la sesión y vuelve a abrirla en la misma carpeta.
Moví los archivos a otra carpeta y ya no funciona.: La carpeta oculta se quedó atrás. Vuelve a descomprimir el ZIP, mueve la carpeta entera, y copia dentro tu carpeta Producto/ (y App/ si existe). O ejecuta ./reparar.sh dentro de la carpeta.
Dice que la carpeta no está activada o que no hay agentes.: Todavía no has pegado tu código de acceso, o no has cerrado y vuelto a abrir la sesión después de pegarlo. Está en el correo de compra; pégalo en Claude Code, cierra, vuelve a abrir. Si no lo encuentras, escríbenos con tu número de pedido.
Dice que no llega al servidor.: No hay conexión a internet, o el servidor está caído un momento. Sin conexión no hay agentes: tu proyecto sigue ahí y puedes leerlo, pero el equipo no trabaja. Cierra la sesión y vuelve a abrirla cuando tengas red.
Se ha agotado el límite de Fable.: Sigue con Opus. El sistema no depende de ningún modelo concreto. Si trabajas mucho a diario, el plan Max de Claude da cinco veces más uso.
Quiero empezar otro proyecto.: Escribe evolucionar en el proyecto actual: te da un ZIP con tu carpeta, tu acceso y lo que han aprendido tus agentes, sin nada de este proyecto. Descomprímelo en otra carpeta y empieza.
¿Funciona en Windows?: Sí, con la app de Claude Code para Windows. Los scripts de activar y evolucionar los ejecuta Claude por ti; no tienes que abrir ninguna terminal.
¿Y con Codex o con otras herramientas?: Hoy el sistema está probado con Claude Code. El servidor habla un estándar (MCP) que otras herramientas entienden, y la compatibilidad con Codex está en el plan.

10. Soporte

Escribe a soporte@freds.cc con tu número de pedido y, si puedes, una captura de lo que ves. Responde una persona, no un robot. Y si algo del sistema te chirría, cuéntalo: es la forma en que mejora.