La forma de un proyecto

Abre un proyecto típico y la lista de carpetas puede sentirse como ruido. No lo es — la mayoría de los proyectos siguen un patrón reconocible. Aquí está una aplicación web simplificada:

my-app/
├── package.json          # dependencies + run commands (above)
├── package-lock.json     # the lockfile — exact versions
├── .env                  # local secrets/config — NOT shared
├── .gitignore            # files Git should ignore (like .env)
├── README.md             # what this project is, how to run it
├── public/               # static files served as-is (images, icons)
└── src/                  # your actual code lives here
    ├── components/        # reusable frontend pieces (a button, a card)
    ├── pages/ (or app/)   # the screens/routes users navigate to
    ├── lib/               # shared helpers and backend logic
    └── styles/            # CSS

No necesitas memorizar esto — solo reconocerlo, para que cuando la IA diga "voy a agregar esto a src/lib", sepas más o menos dónde está eso y por qué. Algunas convenciones fundamentales:

• src/ contiene el código que escribes. El desorden en el nivel superior es mayormente configuración.
• Los archivos de configuración en la raíz (el package.json, los archivos ocultos) configuran las herramientas, no el comportamiento de tu aplicación.
• .gitignore enumera archivos que no deben guardarse en el control de versiones — tu .env pertenece aquí, que es exactamente cómo los secretos se mantienen fuera de un repositorio compartido.