Primer workspace

Tu primer workspace

El objetivo: que tu repositorio tenga reglas, convenciones y un flujo seguro para la IA. Lo harás de la forma preferida —dejando que la propia IA lo configure— y verás también la alternativa manual.

1. Instala la herramienta. Requiere Node.js ≥ 20. Lo más rápido es el binario precompilado de la última release (sin clonar ni compilar):

   npm i -g https://github.com/grojof/ai-workspace-generator/releases/latest/download/ai-workspace-generator.tgz
   ai-workspace --version

   Alternativa: desde el código fuente

   git clone https://github.com/grojof/ai-workspace-generator.git
   cd ai-workspace-generator
   npm install && npm run build && npm link

   El comando instalado es ai-workspace. Para actualizar, repite la instalación rápida. ¿Aún no tienes Node? Dile a tu agente "instala ai-workspace desde https://github.com/grojof/ai-workspace-generator" y te guía la instalación según tu sistema operativo (pregunta antes de instalar nada).

2. Deja que la IA lo configure (recomendado). Abre tu repositorio en tu agente (Claude Code, Copilot, Codex u opencode) y pídele en lenguaje natural que lo configure para trabajar con IA. Ejecutará la skill /aiws-configure, que analiza tu código y te propone un workspace.config.yaml a medida. Es propose-and-review: la IA propone, tú apruebas. No se aplica nada en silencio.

3. (Alternativa) El asistente manual.

   cd /ruta/a/tu-repo
   ai-workspace init   # detecta el stack y escribe workspace.config.yaml

4. Revisa lo generado. Lee AI-WORKSPACE.md: es el índice de todo lo creado (instrucciones, skills, comandos, flujo SDD, documentación viva).

5. Trabaja en lenguaje natural. A partir de aquí no memorizas comandos: pides las cosas con naturalidad —“añade esta feature”, “actualiza esta librería”, “guarda los cambios”— y la IA aplica el flujo adecuado. Si editas AGENTS.md o la config, regenera con ai-workspace sync (idempotente).

Siguiente paso: mira un ejemplo real de principio a fin.