L03 · Preparación · 4 min
Archivos, carpetas y tu carpeta personal
En una frase
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.
Piénsalo así
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 DefiniciónarchivoUn contenido con nombre guardado en tu equipo, como un documento, una imagen o un trozo de código.Abrir en el glosario → es un contenido con nombre guardado en tu equipo (como SPEC.md), y una DefinicióncarpetaUn contenedor de archivos y otras carpetas. Cada proyecto vive en su propia carpeta.Abrir en el glosario → es un contenedor que guarda archivos y otras carpetas. Todas tus carpetas propias viven dentro de tu Definicióncarpeta personalTu carpeta propia en el equipo, que se escribe `~`. En Mac lleva tu nombre; en Windows es `C:\Users\<nombre>`.Abrir en el glosario →, 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 DefiniciónGitLa herramienta que guarda la memoria de tu repositorio: registra cada commit en tu equipo.Abrir en el glosario → 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 Definiciónrepositorio (repo)La carpeta de tu proyecto más todo su historial. Git registra cada punto de guardado para que puedas volver a cualquier versión.Abrir en el glosario → 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 o carpeta oculta cuyo nombre empieza por un punto: .git (el historial del proyecto), Definición.gitignoreUn archivo con lo que Git nunca debe guardar, como `node_modules` y tus archivos secretos `.env`.Abrir en el glosario → (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.
Cómo se ve en tu proyecto
Antes de empezar un proyecto nuevo, tu Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario → 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
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.
Comprobación rápida · 1 pregunta