Skip to content

Guia de uso

Jump to bottom
Guillermo Rojo edited this page Jun 22, 2026 · 3 revisions

Guía de uso

ai-workspace-generator genera y adapta un workspace de IA para cualquier proyecto, de modo que Claude Code, GitHub Copilot, Codex y opencode sigan las mismas reglas, convenciones y flujo de trabajo.

Instalación

Requisito: Node.js ≥ 20. La forma más rápida 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

Desde el código fuente (alternativa):

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

El paquete se llama ai-workspace-generator; el comando instalado es ai-workspace. Para actualizar, repite la instalación rápida (la URL apunta siempre a la última release) o, desde el código, git pull && npm run build.

¿Sin Node todavía? Díselo 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 (comprueba git/Node y pregunta antes de instalar nada). Un binario autónomo sin Node está planificado aparte.

Configúralo con la IA (recomendado)

La forma preferida no es rellenar un asistente a mano, sino dejar que la IA configure el proyecto por ti. Abre tu repositorio en el agente (Claude Code, Copilot, Codex u opencode) y pídele que lo configure; ejecutará la skill /aiws-configure, que analiza tu código y te propone un workspace.config.yaml adaptado.

Hablas en lenguaje natural —“configura este proyecto para trabajar con IA”— y la IA hace el trabajo. Es propose-and-review: te propone, tú apruebas. Nada se aplica en silencio.

No hay comandos que memorizar: tras configurar, pides las cosas con naturalidad (“añade esta feature”, “actualiza esta librería”, “guarda los cambios”) y la IA aplica el flujo adecuado.

Alternativa: el asistente init 

cd /ruta/a/tu-repo
ai-workspace init   # detecta el stack y escribe workspace.config.yaml
ai-workspace sync   # tras editar AGENTS.md o la config, regenera (idempotente)

Tras configurar, lee AI-WORKSPACE.md: el índice de todo lo generado.

Se mantiene solo (v0.3.0)

El workspace vigila su propia coherencia y se autoaudita:

  • ai-workspace doctor revisa presupuesto de tokens, bloques huérfanos y ahora referencias colgantes y docs huérfanas (contrato de docs).
  • /aiws-audit genera un informe de auditoría fechado (solo lectura) de la salud del repo en docs/development/audits/ — el repo mejora a partir de su propio estado.
  • AGENTS.md es un hub limpio: las reglas por lenguaje/framework viven en references/stack/ y se cargan con el trigger nativo de cada agente (Copilot applyTo, skills cross-tool…), no inline.

Detalle completo: USAGE.md.

Clone this wiki locally