En la parada anterior viste el álbum desde fuera. Ahora tomas fotos de la barbería que dejaste ordenada en la última parada del sendero anterior. Piensa en un fotógrafo de producto: primero pone sobre la mesa lo que va a salir en la foto, y después dispara. Lo que quedó fuera de la mesa no sale, aunque esté en el mismo cuarto. En git la mesa existe, y es la idea que más confunde a quien empieza. Antes de disparar, un paso que se hace una vez en la vida: firmar.
Firma tus fotos
Le dices a git tu nombre y tu correo. Con tus datos en lugar de los de Ana:
$ git config --global user.name "Ana Torres"$ git config --global user.email "ana@ejemplo.com"$ git config --global --listuser.name=Ana Torresuser.email=ana@ejemplo.com
$ git config --global user.name "Ana Torres"$ git config --global user.email "ana@ejemplo.com"$ git config --global --listuser.name=Ana Torresuser.email=ana@ejemplo.com$ git add .warning: in the working copy of 'PROYECTO.md', LF will be replaced by CRLF the next time Git touches it$ git commit -m "proyecto descrito y archivos de manejo"[master (root-commit) 59874d0] proyecto descrito y archivos de manejo 5 files changed, 17 insertions(+) create mode 100644 CLAUDE.md create mode 100644 DATOS.md create mode 100644 ESTADO.md create mode 100644 PROYECTO.md create mode 100644 ROADMAP.md
La foto del sendero anterior, por fin sacada y firmada.
--global quiere decir «para todas mis carpetas»: lo haces una vez y sirve para siempre. --list te muestra lo que quedó guardado. El nombre y el correo viajan con cada foto, así que pon los que no te importe que alguien vea si algún día compartes la carpeta. No tiene que ser tu correo principal.
Las dos fotos que ya tenías las firmó git solo, con tu usuario y el nombre de tu Mac, y en cada una dejó un aviso largo que empieza con «Tu nombre y correo fueron configurados automáticamente». Si lo viste, no hiciste nada mal. Esas fotos se quedan así, y no hace falta tocarlas: desde ahora, cada foto nueva lleva tu nombre. Si tu git log decía que no hay commits, ahora sí: git add . y git commit -m "proyecto descrito y archivos de manejo".
El aviso «LF will be replaced by CRLF» es inofensivo y te lo vas a cruzar a menudo: Windows y Mac terminan los renglones de un archivo con caracteres invisibles distintos, y git te avisa que los va a acomodar. No tienes que hacer nada. Los números de tu foto serán otros.
La mesa: qué entra en la foto
Agregaste el horario a PROYECTO.md con tu editor y creaste notas.md para ideas sueltas. Pregúntale a git qué ve:
$ git statusEn la rama masterCambios no rastreados para el commit: (usa "git add <archivo>..." para actualizar lo que será confirmado) (usa "git restore <archivo>..." para descartar los cambios en el directorio de trabajo) modificados: PROYECTO.mdArchivos sin seguimiento: (usa "git add <archivo>..." para incluirlo a lo que será confirmado) notas.mdsin cambios agregados al commit (usa "git add" y/o "git commit -a")
$ git statusOn branch masterChanges not staged for commit: (use "git add <file>..." to update what will be committed) (use "git restore <file>..." to discard changes in working directory) modified: PROYECTO.mdUntracked files: (use "git add <file>..." to include in what will be committed) notas.mdno changes added to commit (use "git add" and/or "git commit -a")
Ahora pon sobre la mesa solo el horario:
$ git add PROYECTO.md$ git statusEn la rama masterCambios a ser confirmados: (usa "git restore --staged <archivo>..." para sacar del área de stage) modificados: PROYECTO.mdArchivos sin seguimiento: (usa "git add <archivo>..." para incluirlo a lo que será confirmado) notas.md
PROYECTO.md pasó de «Cambios no rastreados» a «Cambios a ser confirmados».
$ git add PROYECTO.md# el mismo aviso de CRLF de antes, recortado$ git statusOn branch masterChanges to be committed: (use "git restore --staged <file>..." to unstage) modified: PROYECTO.mdUntracked files: (use "git add <file>..." to include in what will be committed) notas.md
PROYECTO.md pasó de «not staged» a «to be committed».
Lee git status como una foto del cuarto antes de disparar. El primer grupo es lo que cambió pero sigue fuera de la mesa. Los archivos «sin seguimiento» (untracked) son los que git nunca vio en una foto: notas.md es nuevo. Después de git add PROYECTO.md aparece «a ser confirmados» (to be committed): eso es la mesa, lo que va a salir en la próxima foto. Las líneas entre paréntesis son pistas de git sobre qué comando usar; la de git restore la vas a usar en la parada 4. La mesa existe para que una foto cuente una sola cosa, aunque en la carpeta hayas tocado varias.
Disparar: git commit
Ahora sí, la foto, con su nota entre comillas después de -m:
$ git commit -m "horario en PROYECTO.md"[master 02d43a4] horario en PROYECTO.md 1 file changed, 3 insertions(+)$ git statusEn la rama masterArchivos sin seguimiento: (usa "git add <archivo>..." para incluirlo a lo que será confirmado) notas.mdno hay nada agregado al commit pero hay archivos sin seguimiento presentes (usa "git add" para hacerles seguimiento)
$ git commit -m "horario en PROYECTO.md"[master 97ed1aa] horario en PROYECTO.md 1 file changed, 3 insertions(+)
Una foto nueva, un archivo, tres renglones nuevos. notas.md sigue fuera.
El primer renglón de la respuesta es el pie de foto: en qué rama quedó (master), su código y tu nota. El segundo dice cuánto cambió: un archivo, tres renglones agregados. El código de tu foto será otro, porque git lo calcula a partir del contenido, la fecha y la firma, así que no hay dos iguales. -m viene de «mensaje». Si te olvidas de ponerlo, git abre un editor dentro de la terminal para que escribas la nota ahí; en la parada 4 te cuento cómo salir de él. Por ahora, siempre con -m.
git add punto: todo a la mesa
Cuando todo lo que cambió va en la misma foto, el punto quiere decir «esta carpeta entera»:
$ git add .$ git statusEn la rama masterCambios a ser confirmados: (usa "git restore --staged <archivo>..." para sacar del área de stage) nuevos archivos: notas.md$ git commit -m "notas sueltas"[master 208bb41] notas sueltas 1 file changed, 3 insertions(+) create mode 100644 notas.md$ git log --oneline208bb41 (HEAD -> master) notas sueltas02d43a4 horario en PROYECTO.md19e9720 datos reales de la barberíacba69c9 proyecto descrito y archivos de manejo$ git commit -m "nada"En la rama masternada para hacer commit, el árbol de trabajo está limpio
Cuatro fotos en el álbum. Sin nada nuevo en la mesa, git no dispara.
$ git add .# el mismo aviso de CRLF de antes, recortado$ git statusOn branch masterChanges to be committed: (use "git restore --staged <file>..." to unstage) new file: notas.md
Después, la foto con git commit -m "notas sueltas". Y si intentas otra sin cambios, git contesta «nothing to commit, working tree clean».
git add . es el que vas a escribir casi siempre, y es cómodo justamente porque no pregunta: pone sobre la mesa todo lo que cambió, incluidos archivos que quizá no querías fotografiar. Por eso, antes de disparar, un vistazo a git status. En la última parada vas a ver cómo decirle a git que ciertos archivos, como los que guardan contraseñas, no entren nunca aunque uses el punto. Y si intentas una foto sin cambios, git no saca nada: no hay fotos repetidas.
Una foto, una intención
La nota es para ti dentro de tres meses, cuando busques en el álbum en qué momento cambió el precio del corte. Escríbela como le contarías el cambio a alguien en una frase: «sube el corte a 9 dólares», «horario en PROYECTO.md», «quita la sección de ofertas». Con «cambios», «arreglos» o «v2» vuelves al problema de los _final_v2, solo que dentro del álbum.
Y una foto por intención. Si en la misma tarde cambiaste los precios y escribiste el horario, son dos fotos: primero git add DATOS.md y su nota, después el resto. Cuando algo salga mal, vas a poder deshacer una cosa sin perder la otra. Con un agente de IA trabajando en tu carpeta esto pesa todavía más, porque un agente cambia muchas cosas en poco tiempo.
Ya sabes sacar fotos. En la próxima parada hojeas el álbum y comparas dos fotos, renglón por renglón.
