Project Engineering OS

Dale a tu IA un buen punto de partida.

Prepara tu proyecto, encuentra su contexto y continúa con la IA que ya usas.

Descargar Companion para Windows · Empezar · Documentación · Estado del proyecto

Tu proyecto, con una forma de trabajar clara

Elige la carpeta donde trabajas y cuenta qué quieres hacer. Companion te muestra qué va a preparar, organiza contexto con referencias a tus archivos y te ayuda a continuar desde ahí. Sirve para investigación, software, videojuegos, contenido y trabajo general; cada recorrido prepara lo que le corresponde.

La idea nació al querer llevar la forma de trabajar de mi propio proyecto a otros: entender antes de cambiar, dejar claras las decisiones y comprobar el resultado. El método se adapta a tu trabajo y a tus herramientas. Los archivos y decisiones que ya tienes se revisan antes de añadir algo.

Empieza con Companion

1. Descarga Companion 0.3.6 para Windows x64 desde Releases.
2. Revisa el archivo e instálalo siguiendo la guía de instalación. Si ya tenías una versión previa, el instalador te ofrecerá reparar, actualizar o desinstalar de forma limpia.
3. Abre la app, escribe el nombre y el objetivo de tu proyecto, elige con qué perfil te identificas y marca qué vas a hacer.
4. Delimita el tipo específico de tu proyecto y describe tu visión en lenguaje natural. Companion creará PROJECT_VISION.md conservando intactos todos tus archivos originales.
5. Elige entre Instalación rápida (en segundo plano) o "Que mi IA se encargue" para delegar la configuración a tu IA de confianza mediante el prompt de activación estructurado.

No necesitas preparar Node, npm o Git por tu cuenta para empezar con la app. Cuando un proyecto de software necesita herramientas, Companion muestra qué descargará y dónde antes de pedirte que continúes. No descarga modelos de IA.

El instalador no tiene certificado de editor: Windows puede advertirte al abrirlo. Comprueba el SHA-256 publicado; un hash coincidente verifica el archivo, no sustituye la firma del editor.

Consulta qué está publicado y qué sigue en desarrollo.

Así se ve Companion 0.3.2

Ventana real de la aplicación 0.3.2, ejecutada desde el código del commit d744c47 el 19 de septiembre de 2026. No es una captura del instalador. Procedencia y galería de pantallas.

Qué te ayuda a hacer

• Empezar con lo que ya tienes. Revisar tu carpeta y conservar archivos existentes.
• Encontrar de dónde sale una respuesta. Buscar en texto, PDF con texto y DOCX, con línea, página o párrafo.
• Dar contexto a tu IA. Revisar las instrucciones y los fragmentos antes de copiarlos.
• Trabajar por cambios comprobables. En software, preparar instrucciones, OpenSpec, verificaciones y recuperación.
• Retomar el proyecto. Consultar lo preparado y detectar cuándo necesita una nueva comprobación.

Un PDF escaneado necesita reconocimiento de texto antes de poder buscarlo. Los formatos no leídos se señalan. Abrir un chat web no le entrega automáticamente tus archivos. La guía del usuario explica el recorrido y los límites.

El método que se lleva a cada proyecto

Para un cambio de software, el recorrido es:

entender la solicitud → acordar la spec → implementar → comprobar
                    → revisar riesgos y deuda → cerrar por PR

Una spec describe qué debe hacer el cambio y cómo comprobarlo. OpenSpec conserva ese acuerdo; las tareas, pruebas y revisión ayudan a que el resultado coincida. Si queda un problema, se registra y se decide cómo atenderlo. Conoce el flujo SDD y sus controles.

Las skills son guías de trabajo para el agente; MCP permite conectarlo con herramientas. Se evalúan según lo que necesita el proyecto, sus permisos, licencia y compatibilidad. El núcleo incluye un catálogo revisable, no una instalación automática de todas las herramientas de un proyecto de referencia. La matriz de compatibilidad distingue instrucciones generadas de integraciones realmente verificadas.

Si prefieres la terminal

El núcleo 1.0.0 sigue disponible para automatización y para Windows, macOS y Linux. Necesitas Git, npm y Node ^22.22.0 || ^24.18.0; recomendamos Node 24 LTS. En una carpeta Git vacía:

npx --yes [email protected] bootstrap --target .
npm ci
npm run openspec:init
npm run project-os:opsx:adapt
npm run project-os:check
npm run project-os:doctor

Después, abre tu agente y sigue el prompt router, Prompt 00 y Prompt 01 cuando corresponda. La guía CLI cubre el inicio completo, carpetas existentes y decisiones manuales.

project-os upgrade --target . --check
project-os debt check --root .
project-os rollback --target . --transaction <id>

Los comandos de comprobación leen sin reparar. El rollback es una acción explícita con verificación de ownership. Recuperación explica cuándo usarlo.

Cómo encajan la app y el núcleo

Companion es la entrada visual. El núcleo hace la preparación de ingeniería que también se puede pedir por CLI. Bootstrap es el nombre de esa preparación inicial; npm distribuye paquetes y forma parte de las herramientas administradas. No son cuatro productos que debas aprender para usar la app. Mapa del repositorio y qué sigue siendo necesario.

Privacidad, límites y desarrollo

La preparación básica es local, sin cuenta propia ni suscripción. Tus documentos no se suben automáticamente. El código actual ofrece redacción opcional con un modelo local o proveedor propio: revisa qué datos compartirás y el costo de ese proveedor antes de activarla. Privacidad del Companion.

El proyecto usa licencia MIT. El núcleo no tiene dependencias de producción; el Companion tiene las suyas y su aviso de terceros. No hay un ahorro de tiempo o dinero general demostrado: aquí están las mediciones y sus límites.

Para contribuir: CONTRIBUTING, releases, ownership y control de deuda. La landing actual sigue disponible mientras la nueva landing se termina en su repositorio.

Project Engineering OS helps prepare project context and a repeatable way of working with your existing AI. Start with the Windows Companion installer; the neutral core CLI remains available for automation on Windows, macOS and Linux. The app and core have separate versions. See the current delivery status before assuming a feature in source is in the download.

Desarrollado por Ignacio Barboza Espinoza. Contacto.