# Archivos, carpetas y tu carpeta personal

> Toda aplicación es simplemente una carpeta de archivos de texto dentro de tu carpeta personal (`~`), organizada en una carpeta `Development` o `Desarrollo` fuera de servicios de sincronización en la nube y escrita en minúsculas con guiones para la web.

## Analogía

Tu carpeta personal es tu taller privado, y la carpeta `Development` es un banco de trabajo firme sujeto al suelo. Cada proyecto tiene su propia bandeja etiquetada sobre ese banco para que las piezas de dos proyectos nunca se mezclen.

## Cómo funciona

Un file es un contenido con nombre guardado en tu equipo (como `SPEC.md`), y una folder es un contenedor que guarda archivos y otras carpetas. Todas tus carpetas propias viven dentro de tu home-folder, que se abrevia con el símbolo `~` (en Mac: Finder → **Ir → Inicio**; en Windows: escribe `%USERPROFILE%` en la barra de direcciones del Explorador de archivos y pulsa Intro).

Dentro de tu carpeta personal, creas una carpeta llamada `Development` (o `Desarrollo`, sin espacios ni tildes). Mantenla fuera de iCloud Drive, OneDrive, Dropbox, Google Drive y de las carpetas Escritorio o Documentos sincronizadas: la sincronización automática choca con git y puede dañar la memoria del proyecto. GitHub será tu copia de seguridad en línea.

Dentro de `Development`, dale a cada proyecto su propia carpeta en minúsculas y con guiones, como `mi-primera-app` o `buscador-recetas`. Ese mismo nombre será el de tu repo en GitHub y el de tu dirección web inicial (`mi-primera-app.vercel.app`), donde los espacios y las mayúsculas dan problemas.

Cada proyecto incluye además algún hidden-file o carpeta oculta cuyo nombre empieza por un punto: `.git` (el historial del proyecto), gitignore (lo que Git nunca debe subir) y `.env.local` (tus claves locales). Tu equipo los oculta por defecto para que no los borres por accidente; pulsa **Cmd + Mayús + .** en el Finder de Mac, o elige **Vista → Mostrar → Elementos ocultos** en el Explorador de Windows para verlos.

## En tu proyecto

Antes de empezar un proyecto nuevo, tu coding-agent comprueba que estés dentro de `~/Development/<nombre-del-proyecto>` con un nombre en minúsculas y guiones. Si la carpeta está en el Escritorio o dentro de iCloud o OneDrive, te explicará por qué, te pedirá permiso para ayudarte a moverla o renombrarla y te indicará que vuelvas a abrir la sesión allí.

## Copia para tu agente

```text
Comprueba la ruta de la carpeta de mi proyecto actual: dime si está dentro de mi carpeta Development personal, fuera de servicios de sincronización en la nube y en minúsculas con guiones, y enumera los archivos visibles y ocultos que contiene.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/archivos-y-carpetas) · Licencia: CC BY 4.0