Estructura del proyecto
La estructura del proyecto (Project layout) mantiene fuera de git status los archivos que Ingot escribe en .ingot/ mientras trabaja, y les dice a los agentes dónde guarda tu proyecto sus pruebas, para que una prueba nueva quede junto a las que ya tienes.
Está activada por defecto. Actívala o desactívala en Settings › Features › Project layout, en la lista Customize… de la configuración inicial (Help › Set Up Ingot…) o desde su fila en Ingot Health.
Los archivos de ejecución quedan fuera de git
Casi todo .ingot/ es configuración que confirmas en el repositorio: reglas, comandos, skills, agentes, hábitos, contexto compartido, mcp.json, hooks.json, policy.json, frozen.json y el resto (consulta Esquemas de .ingot). Una parte es estado de ejecución que solo pertenece a tu máquina:
| Patrón | Qué es |
|---|---|
artifacts/ | planes, recorridos y capturas de las ejecuciones de agentes |
index/ | el índice del código local |
history/ | instantáneas del historial local |
.state/ | aciertos de reglas y estado de las reglas aprendidas |
handoffs/ | resúmenes para empezar con contexto limpio |
arena/pending/ | batallas de Arena que esperan un voto |
cache/, tmp/ | cachés y archivos temporales |
runs/ | estado de las ejecuciones de agentes |
logs/, *.log | registros |
habits.json, habits-learned.json | hábitos y preferencias aprendidos en esta máquina |
Ingot mantiene estos patrones ignorados en un bloque gestionado que empieza con # >>> Ingot runtime files y termina con # <<< Ingot runtime files. Dónde va el bloque depende del proyecto:
- El proyecto confirma configuración de
.ingot(reglas, skills, comandos, etc.): el bloque va en.ingot/.gitignore. Confirma ese archivo con el resto de tu configuración, para que tu equipo tenga los mismos ignorados. - Si no: el bloque va en
.git/info/exclude. Ese archivo es local a tu clon y nunca se confirma, así que no aparece ningún archivo nuevo en tu proyecto. Hasta que el proyecto confirme configuración de.ingot,context/,memory/yanti-habits.mdtambién quedan locales, así que una ejecución de agente nunca los añade agit status.
Ingot revisa el bloque al abrir una carpeta y antes de cada ejecución de agente, y añade los patrones que falten. Las líneas que escribas fuera del bloque nunca se tocan. En un worktree enlazado, el bloque va en el .git/info/exclude del checkout principal, que comparten todos los worktrees.
Los agentes siguen tu estructura de pruebas
Ingot lee cómo prueba el proyecto su código:
- el framework de pruebas y el comando que las ejecuta
- dónde viven las pruebas: un solo archivo de pruebas para el paquete, junto al código, en carpetas
__tests__o en una carpetatest/tests/spec - cómo se llaman los archivos de prueba, por ejemplo
cart.test.tsotest_cart.py
Antes de que un agente añada o cambie pruebas, recibe esa estructura en sus instrucciones. Un archivo de prueba nuevo que no encaja con la estructura no se guarda, y al agente se le dice dónde va, así que lo escribe allí. Las pruebas end-to-end (Playwright y Cypress, en carpetas e2e, cypress o playwright, o con nombres *.e2e.* / *.cy.*) conservan su propia carpeta y sus nombres y no se revisan.
Cuando el agente dice "las pruebas pasan", Ingot ejecuta las comprobaciones antes de que termine la ejecución, así que la afirmación se apoya en una ejecución real. Consulta Terminar tareas.
Cualquier estructura de proyecto
La estructura de pruebas y el mapa del proyecto funcionan sin carpeta src. Ingot lee la lista de archivos de git (todos los .gitignore, también en una subcarpeta de un repositorio más grande, y una carpeta que es un repositorio git propio, como portal/ con su propio .git, listada por su propio git y nombrada en el mapa del proyecto), o recorre la carpeta respetando cada .gitignore cuando no hay git; omite carpetas de dependencias (node_modules, Pods de CocoaPods, .gradle) aunque estén en el repositorio, y lee lib/ como código fuente (solo omite lib/ junto a un src/ del que se compila). Reconoce:
| Proyecto | Qué encuentra Ingot |
|---|---|
| React Native (Expo o bare) | app/, components/, App.tsx en la raíz; jest desde package.json |
| Next.js con app router | app/layout.tsx y app/page.tsx como puntos de entrada, pruebas en lib/ |
| Monorepo | paquetes de workspaces de npm, pnpm o yarn, Lerna, Turborepo o Nx; el framework de pruebas de los paquetes cuando la raíz no indica ninguno |
| Python | la carpeta del paquete en la raíz, tests/ con test_<name>.py, python -m pytest |
| Go | go test ./..., <name>_test.go junto al código |
| Gradle o Maven | src/test/java/… reflejando src/main/java/…, ./gradlew test o mvn test |
| Rust | cargo test, módulos #[cfg(test)] en el archivo o tests/<name>.rs |
| Repo plano | código en la raíz, un test.js en la raíz |
En un proyecto grande el mapa lee una muestra equilibrada de cada carpeta, primero los archivos menos profundos, así una carpeta ios/ o android/ grande nunca oculta el código de la app. Help › Ingot Health… › Project setup muestra lo que se detectó.
Dónde lo ves
Ingot Health. La fila Project layout, justo después de Git, indica si los archivos de ejecución están ignorados y qué estructura de pruebas siguen los agentes, por ejemplo "Runtime files stay out of git. Tests: …".
| Fila | Significa | Solución |
|---|---|---|
| OK | los archivos de ejecución están ignorados y los agentes siguen la estructura que se muestra | |
| Aviso | algunos patrones de ejecución de .ingot aún no están ignorados, y la fila nombra el archivo | Fix ignores escribe los patrones que faltan |
| Off | la función está desactivada | Turn on |
| Off | no hay carpeta abierta, o la carpeta no es un repositorio git, así que no hay nada que ignorar |
La estructura del proyecto no tiene botón en la barra de estado; un problema aparece en Ingot Health como cualquier otra comprobación.
Panel Project Layout. Project Layout: Show Tests and Ignores en Find Action (⌥⌘T, Ctrl+Alt+T) abre un panel con la estructura de pruebas, los archivos de prueba que ya tiene el proyecto, un cuadro Where does the test for a file go? (escribe src/cart.ts y muestra la ruta de su prueba) y el estado de los ignorados con Fix ignores. Mientras el panel tiene el foco, ⌥⌘0 (Ctrl+Alt+0) activa o desactiva la función y ⌥⌘D (Ctrl+Alt+D) arregla los ignorados.
Chat. Mientras la función está desactivada, un mensaje sobre pruebas, specs o git status muestra una pequeña tarjeta de sugerencia, Enable Project layout, con una × para cerrarla.
Ajustes
Los tres están en Settings › Tools › Project layout y, como todos los ajustes, son claves de tus archivos de ajustes.
| Clave | Qué hace | Por defecto |
|---|---|---|
ingot.projectLayout.enabled | Project layout: toda la función, los ignorados y la estructura de pruebas para los agentes | true |
ingot.projectLayout.ignoreRuntimeFiles | Keep .ingot runtime files out of git: escribe y revisa el bloque gestionado | true |
ingot.projectLayout.followTestLayout | Agents follow this project's test layout: da la estructura a los agentes y rechaza archivos de prueba nuevos fuera de ella | true |
Por ejemplo, para mantener los ignorados pero dejar que los agentes pongan pruebas en cualquier sitio en un proyecto, añade esto a <project>/.ingot/settings.json:
{
"ingot.projectLayout.followTestLayout": false
}
Atajos
| Acción | macOS | Windows / Linux |
|---|---|---|
| Project Layout: Show Tests and Ignores | ⌥⌘T | Ctrl+Alt+T |
| Project Layout: Turn On or Off (con el panel enfocado) | ⌥⌘0 | Ctrl+Alt+0 |
| Project Layout: Keep .ingot Runtime Files out of Git (con el panel enfocado) | ⌥⌘D | Ctrl+Alt+D |
Escritorio y navegador
La estructura del proyecto funciona igual en la app de escritorio y en el navegador.
Preguntas frecuentes
¿Por qué cambió .ingot/.gitignore? Tu proyecto confirma configuración de .ingot, así que Ingot mantiene allí sus patrones de ejecución en un bloque gestionado. Confirma el cambio; Ingot solo edita las líneas entre sus dos marcas.
No quiero que Ingot toque mis archivos de ignorados. Desactiva Keep .ingot runtime files out of git (ingot.projectLayout.ignoreRuntimeFiles). Los agentes siguen respetando tu estructura de pruebas.
El archivo de prueba del agente no se guardó. No encajaba con la estructura de pruebas del proyecto. Al agente se le dice dónde va el archivo y lo escribe allí. Abre el panel Project Layout para ver la estructura que detectó Ingot, o desactiva Agents follow this project's test layout si tu proyecto mezcla estructuras a propósito.
¿Es lo mismo que .ingot/ignore? No. .ingot/ignore oculta archivos a los agentes; la estructura del proyecto mantiene los archivos propios de Ingot fuera de git. Consulta Archivos de ignorados.