Gemelo digital del proyecto
Un modelo vivo de tu proyecto, creado a partir del código: sus paquetes, componentes, rutas, APIs, pruebas y las importaciones que los unen. El panel Project Twin muestra el mapa y responde ¿qué toca este archivo? para el archivo abierto, y el gemelo se actualiza cada vez que guardas.
Silver El gemelo digital del proyecto viene con Silver, Gold y Platinum. Con otro plan el panel sigue ahí, dice qué plan lo incluye y no se crea nada.


Abrir el panel
Pulsa ⌥⇧T (Alt+Shift+T) o elige Project Twin: Show Project Twin en Find Action. El panel se abre a la izquierda. La primera vez, Ingot recorre el proyecto y crea el gemelo; en un proyecto grande tarda unos segundos.
Qué contiene el gemelo
| Capa | Qué cuenta |
|---|---|
| Paquetes | Carpetas con su propio package.json (uno en un proyecto de un paquete, cada paquete de un monorepo) |
| Componentes | Componentes exportados en archivos .jsx y .tsx (nombres en PascalCase), y archivos .vue y .svelte |
| Rutas | Rutas del sistema de archivos (pages/cart.tsx, app/orders/[id]/page.tsx, routes/…) y tablas de rutas (<Route path="/checkout">, { path: '/cart' }) |
| APIs | Manejadores como router.post('/orders') o app.get('/users/:id'), clases @Controller con @Get / @Post, pages/api/… y app/api/…/route.ts |
| Pruebas | *.test.*, *.spec.*, archivos en tests/, __tests__/ y e2e/, test_*.py |
| Módulos | Cualquier otro archivo de código |
Entre archivos, el gemelo guarda las importaciones, resueltas a los archivos a los que apuntan (rutas relativas y alias de tsconfig). Se basa en relaciones del código, no en coincidencias de texto.
Haz clic en una capa para ver sus archivos, los más importados primero; haz clic en un archivo para abrirlo.
¿Qué toca este archivo?
La parte de arriba del panel sigue al archivo del editor actual:
| Grupo | Archivos |
|---|---|
| Imported by | Archivos que lo importan directamente; el titular dice cuántos |
| Tests that reach it | Pruebas que lo importan, o que importan un archivo que lo importa |
| Routes and APIs above it | Rutas y APIs que llegan a él por importaciones (hasta cuatro pasos) |
| It imports | Los archivos del proyecto que importa |
Míralo antes de cambiar un archivo: ves qué podrías romper y qué pruebas ejecutar.
Siempre al día
- El gemelo se guarda en
.ingot/twin/twin.jsondentro de tu proyecto. Su carpeta tiene su propio.gitignore, así nunca se sube al repositorio: se vuelve a crear a partir del código. - Cada archivo que guardas, añades o borras actualiza solo ese archivo en el gemelo, en un momento.
- Al abrir el proyecto otra vez, solo se vuelven a leer los archivos que cambiaron.
- Project Twin: Rebuild Project Twin (o ↻ en el panel) lo crea de nuevo desde cero.
Desactivarlo
El gemelo está activado por defecto. Desactívalo en Settings › Features › Project Digital Twin; el panel se cierra y el gemelo deja de actualizarse.
| Ajuste | Valores | Por defecto |
|---|---|---|
ingot.twin.enabled | true o false | true |
Conviene saber
- En un espacio de trabajo con varias carpetas, el gemelo cubre la primera.
- El Mapa del proyecto que el agente lee al empezar una tarea es un resumen aparte y compacto.
- Próximamente: hacer preguntas al gemelo con palabras normales, dárselo al agente como contexto y más capas (stores de estado, tablas de base de datos, responsables, cobertura).