# Yujin Forge -- Manual de usuario

Asistente de desarrollo por voz para construir aplicaciones React + NAC-3. Pensado para que un acompañante o un chico aprendiendo a programar pueda operarlo sin tocar la terminal.

## Bienvenida

Yujin Forge te permite tres cosas simples:

- Leerte documentos por voz (PDF, Word, HTML, MD, EPUB, CSV, Excel, codigo fuente, txt, RTF).
- Tomar una especificacion de diseno y generar el codigo de una aplicacion automaticamente.
- Hablar con un asistente de IA que conoce tu proyecto y puede leer manifest, buscar en SPEC, editar componentes, hacer commits.

## Instalacion

El tecnico de la institucion ya tiene que haber instalado Yujin Forge en la computadora. Si te toca instalarlo:

1. Instala Node.js 18.17 o superior desde nodejs.org.
2. Abre una terminal y corre:

       npm install -g @yujin/forge-cli@alpha

3. Verifica con `yf --version`.
4. Corre `yf doctor` para revisar el estado.

## Primera ejecucion

Desde la carpeta de tu proyecto:

    yf chat

Se abre el navegador con el panel de Yujin. Hace click en el boton Claves (arriba a la derecha) y cargas las claves de API que el tecnico te paso. Cada clave se muestra UNA SOLA VEZ cuando la ingresas; despues se puede reemplazar pero no leer.

## Comandos por voz

Hace click en el boton del microfono y deci alguno de estos comandos. Yujin entiende espanol, ingles, portugues, frances, aleman, italiano, japones, chino, hindi y arabe.

Lo que decis | Que pasa
--- | ---
"Abrime el nombre" | Abre el documento.
"Siguiente" / "Que sigue" | Avanza al siguiente bloque.
"Buscar palabra" | Busca y lee la primera coincidencia.
"Marcame aca como nombre" | Pone un marcador.
"Volver a la marca nombre" | Vuelve a la marca.
"Recap" / "Resumen" | Releé los ultimos bloques.
"Abrime el manual" | Abre este manual en tu idioma.

## Ingesta de especificaciones

Arrastra un archivo de especificacion (PDF, Word, HTML, markdown, etc) al panel. Aparece una pantalla violeta con un kanji. Solta el archivo encima.

Yujin:

1. Lee el documento.
2. Le pide a Claude que extraiga requisitos, entidades, endpoints, componentes y un resumen.
3. Le pide a Claude que arme un plan de archivos a crear.
4. Te muestra el plan. Vos decis "aprobar" si esta bien.
5. Crea los archivos en tu carpeta de proyecto.
6. Si algo salio mal, decis "deshacer" y revierte todo.

## Solucion de problemas

El microfono no funciona
  El navegador pide permiso la primera vez. Si lo rechazaste por error, hace click en el candado al lado de la URL y cambia el permiso.
No entiende lo que digo
  Probemos otro proveedor de voz. Si solo tenes Google cargado, agrega tambien la clave de OpenAI (slot `openai`) en el modal de Claves; Whisper maneja mejor los acentos.
La voz suena mal
  Yujin habla con la voz de Google por defecto. Para una voz mas natural en espanol, carga la clave de ElevenLabs en el slot `elevenlabs`.
Quiero empezar de cero
  Cierra Yujin. Borra la carpeta `~/.yujin-forge/` (Linux/Mac) o `%USERPROFILE%\.yujin-forge\` (Windows). Volve a correr `yf chat` y carga las claves de nuevo.

## Soporte

Para soporte, escribe a pablo@rpaforce.com.

Documentacion tecnica: `docs/HITO_1_ARCHITECTURE.md` + `docs/USAGE.md` + `docs/RECAP_CLAUDE_COSTS.md` en el repositorio.