Estas son las instrucciones para dejar todo listo y poder usar el método de la guía De Idea a Realidad. Sigue los pasos en orden. Si algo ya lo tienes instalado, sáltalo.
Requisito previo: Necesitas una cuenta en alguno de estos agentes de IA:
- Claude Code — requiere suscripción de pago. El plan mínimo es Claude Pro. Si no la tienes, suscríbete en claude.ai.
- Codex — tiene versión gratuita. Solo necesitas una cuenta de OpenAI en platform.openai.com.
Puedes usar cualquiera de los dos. Si no tienes preferencia y quieres empezar sin pagar, empieza con Codex.
Node.js es para los proyectos que vas a construir (aplicaciones web, backends, etc.). Sin él, el código que genere el agente no va a poder ejecutarse.
Ve a nodejs.org, descarga la versión LTS (el botón verde), e instálalo. Siguiente, siguiente, listo.
Visual Studio Code es un editor de código gratuito que te va a servir para revisar los archivos que genera el agente: planes, specs, código, y más.
Ve a code.visualstudio.com, descarga el instalador para tu sistema, e instálalo. Siguiente, siguiente, listo.
El agente lo necesita para gestionar los archivos de tus proyectos (llevar un historial de cambios, guardar versiones, etc.).
- Windows: Ve a git-scm.com, descarga el instalador y ejecútalo. Siguiente, siguiente, listo.
- Mac: Presiona
Cmd + Espacio, escribeTerminaly Enter. Ejecutagit --version. Si no está instalado, macOS te va a ofrecer instalarlo automáticamente.
La terminal es la pantalla negra donde vas a escribir comandos. Es donde vas a instalar el agente y desde donde va a correr.
- Windows: Puedes usar cualquiera de estas opciones:
- PowerShell — Presiona
Win + R, escribepowershelly Enter - Terminal de Windows — Búscala en el menú de inicio como "Terminal"
- Git Bash — Se instaló junto con Git; búscala en el menú de inicio como "Git Bash"
- PowerShell — Presiona
- Mac: Presiona
Cmd + Espacio, escribeTerminaly Enter. También puedes usar iTerm2 si lo tienes instalado.
Elige el agente que vas a usar e instálalo con el comando correspondiente:
Opción A: Claude Code (requiere suscripción Claude Pro)
npm install -g @anthropic-ai/claude-codeOpción B: Codex (tiene versión gratuita)
npm install -g @openai/codexSi en Windows te sale un error que dice "la ejecución de scripts está desactivada", ejecuta esto primero:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedAcepta con S si te pregunta. Luego vuelve a ejecutar el comando de instalación del agente.
Antes de abrir el agente, necesitas elegir dónde van a vivir tus proyectos.
- Abre el Explorador de archivos
- Ve al Disco C:
- Crea una carpeta nueva y llámala como quieras (por ejemplo:
proyectosocode) - Entra a esa carpeta
- Haz clic derecho dentro de la carpeta y selecciona:
- Windows 11: "Abrir en Terminal"
- Windows 10: "Git Bash aquí" o "Abrir ventana de PowerShell aquí"
- Mac: Desde Finder, menú Servicios > "Nueva Terminal en carpeta" (o arrastra la carpeta a la Terminal)
Esto es importante: el agente va a crear tu proyecto dentro de la carpeta donde abras la terminal.
En la terminal, escribe el comando según el agente que instalaste:
- Claude Code:
claude
- Codex:
codex
El agente se va a abrir y te va a pedir que inicies sesión con tu cuenta (Claude o OpenAI). Sigue las instrucciones que te da.
Superpowers es una colección de habilidades que mejoran cómo trabaja el agente: lo hacen planificar antes de ejecutar, revisar su propio trabajo, y más.
Si usas Claude Code, ejecuta estos dos comandos dentro del agente:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Si usas Codex, dile al agente exactamente esto:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
Codex va a descargar e instalar Superpowers automáticamente siguiendo esas instrucciones.
Una vez instalado, cierra el agente escribiendo /exit o cerrando la terminal.
Vuelve a abrir el agente (claude o codex según el que uses) y pega todo el contenido de la Parte 2 (abajo) directamente en el agente.
Eres mi asistente de setup. Necesito que configures mi entorno para trabajar con el método Planificar → Ejecutar → Iterar. Sigue estos pasos en orden. Si algo ya está instalado o configurado, sáltalo y pasa al siguiente.
PASO 0 — IDENTIFICAR AGENTE
- Determina qué agente eres: Claude Code o Codex
- Si eres Claude Code: el archivo de instrucciones del proyecto se llamará CLAUDE.md
- Si eres Codex: el archivo de instrucciones del proyecto se llamará AGENTS.md
- Guarda esta información, la vas a necesitar en el paso siguiente
PASO 1 — CREAR PROYECTO
- Pregúntame: "¿Cómo quieres llamar a tu proyecto?"
- Espera mi respuesta antes de continuar
- Verifica si ya existe una carpeta con ese nombre en el directorio actual
- Si ya existe: avísame y pregúntame si quiero usar otro nombre. NO sobreescribas nada.
- Si no existe: crea la carpeta con el nombre que te dé
- Dentro de la carpeta:
- git init
- Crea el archivo de instrucciones (CLAUDE.md o AGENTS.md según el agente que eres) con el contenido del BLOQUE A
- Crea docs/MASTER-PLAN.md con el contenido del BLOQUE B
- Crea los directorios docs/superpowers/specs/ y docs/superpowers/plans/
- Haz un commit: "setup: initial project with method configuration"
BLOQUE A — Contenido del archivo de instrucciones:
---
# Instrucciones del proyecto
## Método de trabajo
Antes de escribir código o crear cualquier cosa, SIEMPRE usa el skill brainstorming de superpowers para explorar la idea primero.
## Flujo obligatorio
Para cualquier tarea nueva:
1. Brainstorming — conversar sobre la idea, explorar opciones, definir el diseño
2. Spec — documentar el diseño acordado en docs/superpowers/specs/
3. Plan — crear el plan de implementación en docs/superpowers/plans/
4. Ejecución — implementar siguiendo el plan paso a paso
Nunca saltes directo a implementar. Siempre planifica primero.
## Master Plan
Mantén docs/MASTER-PLAN.md como la fuente de verdad del proyecto:
- Visión general del proyecto
- Sub-proyectos con tabla de pasos y estado (pendiente / en progreso / completo)
- Links a specs y plans relevantes
- Próximos pasos priorizados
Después de completar cada sub-proyecto o paso importante, actualiza el MASTER-PLAN.md.
## Idioma
Responde siempre en el idioma en que te hablo. El código, nombres de variables, commits y nombres de archivos se mantienen en inglés. Los documentos del proyecto (specs, plans, README) se escriben en el idioma del usuario.
## Stack por defecto
Cuando quiera construir una aplicación web, sugiere este stack por defecto:
- **Backend:** Express (Node.js) + TypeScript
- **Frontend:** React + TypeScript
- **Base de datos:** SQLite
Si pido otro stack, usa el que te pida. Este es solo el punto de partida sugerido.
## README de ejecución
Cuando termines de implementar cualquier cosa que se ejecute, deja en el README.md una sección "## Cómo ejecutar" con un único comando (ej: `npm run dev`) que levante todo lo necesario. El usuario no debería necesitar abrir múltiples terminales ni ejecutar pasos manuales.
## Comunicación con el usuario
El usuario puede no tener experiencia técnica. Aplica estas reglas siempre:
- **Antes de ejecutar cualquier comando**, explica en una línea qué hace y por qué lo estás ejecutando. Ejemplo: "Voy a ejecutar `npm install` — esto descarga las dependencias del proyecto, que son las librerías de código que necesita tu aplicación para funcionar."
- **Cuando uses un término técnico** que el usuario probablemente no conozca (dependencias, servidor, puerto, variable de entorno, etc.), explícalo brevemente en la misma oración o en paréntesis.
- **No asumas conocimiento previo.** Si algo puede no ser obvio para alguien que está aprendiendo, dale contexto sin sonar condescendiente.
- **Sé conciso.** Las explicaciones deben ser de una o dos oraciones, no lecciones. El objetivo es que el usuario entienda qué está pasando, no que aprenda a fondo.
- **Cuando el usuario tenga que hacer algo por su cuenta** (crear una API key, configurar una cuenta, obtener un token, etc.), nunca digas simplemente "crea una API key en OpenAI". Da instrucciones paso a paso: a qué URL ir, qué botones o secciones buscar, qué copiar, y dónde pegarlo. El usuario no sabe dónde está nada.
---
BLOQUE B — Contenido de docs/MASTER-PLAN.md:
---
# Master Plan — [NOMBRE DEL PROYECTO]
**Última actualización:** [FECHA DE HOY]
---
## Visión
[Se define durante el brainstorming inicial]
---
## Sub-proyectos
[Se crean a medida que se planifica]
---
## Próximos pasos
| Acción | Tipo | Prioridad |
|--------|------|-----------|
| Definir la idea con brainstorming | Con IA | Alta |
---
## Archivos clave
[NOMBRE DEL PROYECTO]/
├── CLAUDE.md / AGENTS.md
├── docs/
│ ├── MASTER-PLAN.md
│ └── superpowers/
│ ├── specs/
│ └── plans/
---
PASO 2 — RESUMEN Y CIERRE
- Muéstrame un resumen de todo lo que se instaló/configuró y lo que se saltó (porque ya existía)
- Al final dime: "Tu entorno está listo. Ahora pídeme que hagamos un brainstorming para planificar tu proyecto."
Listo, ya puedes continuar con la guía.