5 Un primer informe, a mano
Quarto, publicación reproducible, agentes de programación, Markdown, Python, EPUB, análisis de datos, k-means
En algún lugar del informe de este capítulo hay un número equivocado. El informe se renderiza sin un solo error, se lee perfectamente bien y cita su fuente, y una de sus cifras está desviada en 360,000 visitas. Encontrarla no requiere programar, solo un hábito: poner cada número al lado de los datos de los que salió.
Ese hábito es el Revisa del título de este libro, y este capítulo es donde lo practicas con tus propias manos. Escribes tú cada comando, en la terminal, sobre un informe real: lo copias, lo renderizas, lo revisas, lo registras con Git, lo cambias y deshaces el cambio, lo rompes de tres maneras a propósito y lees los errores. Solo al final el agente hace una edición, y tú revisas su trabajo con los mismos comandos que acabas de aprender. Calcula unos 45 minutos; menos si la terminal ya te resulta familiar.
- Copiar un proyecto, entrar en él y renderizarlo desde la terminal.
- Revisar cada número de un informe contra sus datos, y rastrear uno equivocado hasta donde se escribió a mano.
- Registrar, comparar y deshacer cambios con
git status,git diff,git restoreygit commit. - Leer un error desde su primera línea, y revisar el cambio de un agente antes de hacer commit.
5.1 Consigue los archivos
El paso 5 del Capítulo 4 clonó los archivos del taller en ~/quarto-workshop. Entre ellos hay un informe pequeño, starters/first-report. Cópialo afuera, para que el original quede como estaba. Escríbelo con ayuda de completar con Tab, que ahorra tipeo y atrapa errores: escribe cp -R ~/quarto-workshop/st y presiona Tab, y la terminal termina el nombre, starters/. Cuando encajan varios nombres, presiona Tab otra vez para verlos. Cuando Tab no hace nada en absoluto, ahí no existe ningún nombre que empiece así, y conviene saberlo antes de presionar Enter. En la terminal, en cualquier carpeta:
cp -R ~/quarto-workshop/starters/first-report ~/first-reportcp copia, y -R (recursive, recursivo) copia una carpeta con todo lo que tiene adentro. No imprime nada. Muchos comandos funcionan así: cp, cd y, más adelante, git add no dicen nada cuando funcionan, y solo hablan cuando algo sale mal. En la terminal, el silencio es éxito.
Si cp dice No such file or directory, tu copia del taller es más vieja que este capítulo: cd ~/quarto-workshop, luego git pull, y luego ejecuta otra vez la línea de cp.
Ahora entra en la copia y mira alrededor. En la terminal:
cd ~/first-report
pwd
lspwd imprime la carpeta en la que estás, que termina en first-report (/home/ana/first-report en Linux, /Users/ana/first-report en una Mac, con tu propio nombre). ls enumera seis nombres, en un orden que depende de tu sistema:
| Nombre | Contiene |
|---|---|
report.qmd |
la fuente del informe: la configuración, una celda de código y sus oraciones |
data/ |
visits.csv, los datos que lee el informe |
AGENTS.md |
las reglas del proyecto para el agente (Sección 2.5) |
README.md |
qué es la carpeta, en unas pocas líneas |
pyproject.toml, uv.lock |
los paquetes de Python que necesita el informe, con versiones exactas |
Un nombre con un espacio
La terminal parte lo que escribes en cada espacio, así que el nombre de una carpeta con un espacio necesita cuidado. Pruébalo una vez, desde tu carpeta personal. En la terminal:
cd ~
mkdir "my reports"
cd my reportscd se queja, con palabras que dependen de tu shell:
bash: cd: too many arguments (Ubuntu)
cd: string not in pwd: my (Mac)
cd recibió dos nombres, my y reports. Mantén el nombre de una pieza con comillas, cd "my reports", o con una barra invertida antes del espacio, cd my\ reports. Completar con Tab escribe la barra invertida por ti: escribe cd my y presiona Tab. Luego ordena y vuelve:
cd ~
rmdir "my reports"
cd ~/first-reportLas carpetas de este libro no tienen espacios en el nombre, y las tuyas tampoco necesitan tenerlos: un guion, como en first-report, hace el mismo trabajo.
5.2 Renderízalo tú
En la terminal, en ~/first-report:
uv run quarto render report.qmduv run ejecuta un comando en el propio entorno de Python del proyecto (Sección 1.4; la Sección 6.10 tiene más). La primera vez, construye ese entorno a partir de uv.lock, lo que tarda desde unos segundos hasta un minuto, y puede imprimir antes algunas líneas Downloading. Luego Quarto renderiza, e imprime bastante (recortado aquí donde se marca …):
Using CPython 3.12.13
Creating virtual environment at: .venv
Installed 39 packages in 301ms
Starting python3 kernel...[IPKernelApp] WARNING | …
Done
Executing 'report.quarto_ipynb'
Cell 1/1: ''...Done
pandoc
to: html
output-file: report.html
…
Output created: report.html
Cuando un renderizado funciona, su última línea es Output created: report.html. Las líneas después de pandoc son su configuración, y la advertencia de IPKernelApp es inofensiva (Sección 4.7). Tu versión de Python, la cantidad de paquetes y los tiempos pueden ser distintos.
Abre la página. En la terminal, ejecuta open report.html (Mac), xdg-open report.html (Linux), o explorer.exe . y luego haz doble clic en report.html (Windows, en Ubuntu). El navegador muestra:
Five London Sights
Five of London’s best-known sights had 25,036,711 visits between them in 2025. The most visited was the Natural History Museum (South Kensington), with 7,116,929, and 4 of the five are free to enter.
Tate Modern, on the South Bank, had 4,154,266 visits.
Source: ALVA, “Visits made in 2025 to visitor attractions in membership with ALVA” (only ALVA member attractions are counted).
(Es decir: cinco de las atracciones más conocidas de Londres sumaron ese total de visitas en 2025; la más visitada fue esa, con esas visitas, y esa cantidad de las cinco tiene entrada gratuita. Tate Modern, en la orilla sur del Támesis, tuvo esas visitas. La fuente es la tabla de visitas de 2025 de ALVA, que cuenta solo las atracciones miembro de ALVA.)
Ahora abre la carpeta misma: open . (Mac), xdg-open . (Linux) o explorer.exe . (Windows, en Ubuntu), donde . significa “esta carpeta”. El explorador de archivos muestra los mismos archivos que ls, más los nuevos que hizo el renderizado: report.html y report_files/. La terminal y el explorador de archivos son dos vistas de una misma carpeta.
5.3 Revisa cada número contra los datos
El renderizado funcionó. Eso demuestra que el código se ejecutó, no que el informe esté bien. Mira los datos. En la terminal, en ~/first-report:
cat data/visits.csvcat imprime un archivo. Un CSV es una tabla en texto plano, con comas entre las columnas. Este tiene una primera línea que nombra sus siete columnas, y luego cinco filas, una por atracción. Cada fila lleva su source, su url y su fecha retrieved, así que las líneas son largas y se ajustan. Pide solo las dos primeras columnas:
cut -d, -f1,2 data/visits.csvcut conserva algunas columnas de cada línea: -d, dice que las columnas están separadas por comas, y -f1,2 conserva la primera y la segunda. Corta en cada coma, incluso en una que esté entre comillas, así que aquí es seguro solo porque las dos primeras columnas no tienen comas.
attraction,visits_2025
Natural History Museum (South Kensington),7116929
The British Museum,6440120
Tate Modern,4514266
National Gallery,4147544
Tower of London,2817852
Pon la página al lado de esta lista. ¿Cuál de los números de la página no coincide con una fila? (El total es la suma de las cinco; una calculadora lo confirma, pero no hace falta.)
El de Tate Modern. La página dice 4,154,266; su fila dice 4514266: dos dígitos intercambiados. Nada te avisó, porque Quarto renderizó la oración fielmente: para Quarto son solo palabras. Para corregirlo, encuentra de dónde salió ese número.
La fuente del informe dice de dónde sale cada número. En la terminal:
cat report.qmd---
title: "Five London Sights"
format: html
---
```{python}
#| echo: false
import csv
with open("data/visits.csv") as f:
rows = list(csv.DictReader(f))
total = sum(int(r["visits_2025"]) for r in rows)
top = max(rows, key=lambda r: int(r["visits_2025"]))
free = [r for r in rows if r["admission"].startswith("Free")]
```
Five of London's best-known sights had `{python} f"{total:,}"` visits
between them in 2025. The most visited was the `{python} top["attraction"]`,
with `{python} f"{int(top['visits_2025']):,}"`, and `{python} len(free)` of
the five are free to enter.
Tate Modern, on the South Bank, had 4,154,266 visits.
Source: ALVA, "Visits made in 2025 to visitor attractions in membership with
ALVA" (only ALVA member attractions are counted).
Conociste estas partes en la Sección 1.2: la configuración entre las líneas ---, una celda de código que lee data/visits.csv y calcula total, top y free, y el código en línea, las piezas `{python} …`, que Quarto reemplaza por valores calculados. El Capítulo 7 explica cada línea. Por ahora, fíjate en qué se calcula y qué no. Todos los demás números de la página son código en línea que lee los datos; la oración de Tate Modern se escribió a mano.
Un número escrito a mano es una copia, hecha una vez por una persona, y después nada la conecta con los datos. Los dígitos intercambiados son el desliz clásico al copiar, pero el problema de fondo es lo que pasa después: cuando cambian los datos, la copia se queda como estaba. Así es como un informe se desactualiza (Sección 1.1), y la Sección 5.5 te deja verlo ocurrir.
5.4 Empieza un historial
Antes de cambiar nada, registra el informe tal como está, para que siempre puedas volver a él. Git, que instalaste en el Capítulo 4, hace esto (Sección 1.4). En la terminal, en ~/first-report:
git init -b mainInitialized empty Git repository in /home/ana/first-report/.git/
La carpeta ahora es un repositorio: tiene una carpeta oculta .git donde Git guarda el historial. -b main le pone a la primera rama del repositorio, su línea de historial, el nombre main, como hace GitHub. (Esto necesita Git 2.28 o más reciente; git --version muestra el tuyo, y la preparación del Capítulo 4 instala uno más nuevo.) Pregúntale a Git qué ve:
git statusOn branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
.gitignore
AGENTS.md
README.md
data/
pyproject.toml
report.qmd
uv.lock
nothing added to commit but untracked files present (use "git add" to track)
Los archivos sin seguimiento (untracked) son los que Git puede ver pero todavía no registra. En la lista faltan tres cosas de la carpeta: .venv/, report.html y report_files/. Las deja fuera .gitignore, un archivo que enumera lo que Git debe ignorar; ls lo oculta porque su nombre empieza con un punto, y ls -a lo muestra. Nombra todo lo que uv y el renderizado reconstruyen, así que el historial guarda solo las fuentes.
Registra todo lo demás como el primer commit, un estado guardado con un mensaje que dice por qué:
git add .
git commit -m "Starter report, as copied"git add . no imprime nada: elige qué entra en el próximo commit, y . significa “esta carpeta”, todo lo que no se ignora. git commit lo registra:
[main (root-commit) 15856fe] Starter report, as copied
7 files changed, 916 insertions(+)
create mode 100644 .gitignore
…
Los siete caracteres después de root-commit nombran el commit; los tuyos van a ser otros. Revisa otra vez:
git status
git log --onelineOn branch main
nothing to commit, working tree clean
15856fe (HEAD -> main) Starter report, as copied
El árbol de trabajo (working tree) son los archivos de la carpeta tal como están ahora; “clean” (limpio) significa que están exactamente como los registró el último commit. git log --oneline enumera los commits, del más reciente al más viejo, y (HEAD -> main) marca el commit en el que están ahora tus archivos.
Si git commit dice “Author identity unknown”, Git todavía no sabe tu nombre (el paso 5 del Capítulo 4 lo configura). Ejecuta las dos líneas git config --global que imprime, con tu propio nombre y tu correo, y luego vuelve a hacer commit. Si omites -m "…", Git abre un editor para el mensaje: sal sin guardar (en nano, Ctrl+X; en Vim, Esc, luego :q! y Enter) y vuelve a ejecutar el comando con -m.
5.5 Predice, cambia, reconstruye
Supón que ALVA corrige hacia arriba la cifra de Tate Modern en 1,000,000. Haz tú ese cambio en los datos, con nano, el pequeño editor de texto de la propia terminal. En la terminal, en ~/first-report:
nano data/visits.csvPresiona la flecha hacia abajo tres veces para llegar a la fila de Tate Modern; su línea larga se sale por el borde derecho de la ventana, y no pasa nada. Presiona la flecha hacia la derecha hasta que el cursor quede justo después del primer dígito de 4514266, presiona Retroceso para borrar el 4 y escribe 5, para que el número diga 5514266. Guarda con Ctrl+O y luego Enter; sal con Ctrl+X.
En nano, Ctrl+O (“write Out”, escribir) pide el nombre del archivo: presiona Enter para conservarlo. Ctrl+X sale; si no guardaste, nano pregunta primero: Y y luego Enter guarda, N descarta los cambios. Las teclas aparecen en la parte de abajo de la pantalla, donde ^ significa Ctrl. En una Mac, nano abre Pico, que usa las mismas teclas (comprobado en macOS 26, el 2026-11-12).
Antes de renderizar, pregúntale a Git qué cambiaste:
git status
git diffSi el diff es más largo que la ventana, Git lo muestra de a una pantalla, con : o (END) en la última línea: presiona Espacio para ver más y q para recuperar el indicador. Las líneas eliminadas se ven en rojo y las agregadas, en verde.
On branch main
Changes 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: data/visits.csv
no changes added to commit (use "git add" and/or "git commit -a")
Un diff son las líneas que un cambio eliminó y agregó. Las líneas reales son largas, así que aquí cada una se corta donde ves …:
diff --git a/data/visits.csv b/data/visits.csv
index eb394b9..8c1eea7 100644
--- a/data/visits.csv
+++ b/data/visits.csv
@@ -1,6 +1,6 @@
attraction,visits_2025,admission,note,s…
Natural History Museum (South Kensingto…
The British Museum,6440120,Free (paid e…
-Tate Modern,4514266,Free (paid exhibiti…
+Tate Modern,5514266,Free (paid exhibiti…
National Gallery,4147544,Free (paid exh…
Tower of London,2817852,Paid,,"ALVA, Vi…
Léelo desde arriba. --- es el archivo antes, +++ después, y @@ … @@ dice qué líneas siguen. Una línea que empieza con - se eliminó, una que empieza con + se agregó, y una que empieza con un espacio es contexto sin cambios. Cambió una línea, en un archivo: exactamente la edición que querías.
Antes de renderizar: de los cuatro números del informe (el total, el conteo de la atracción más visitada, el conteo de entradas gratuitas y el de Tate Modern), ¿cuáles van a cambiar?
Solo el total, que sube en 1,000,000 hasta 26,036,711. El Natural History Museum (South Kensington) sigue siendo el más visitado, el conteo de entradas gratuitas sigue siendo 4 y la oración de Tate Modern sigue diciendo 4,154,266. Se escribió a mano, así que no puede seguir a los datos, ni siquiera cuando los datos cambian en la misma fila que describe.
Ahora reconstruye y mira. En la terminal:
uv run quarto render report.qmdVuelve a cargar report.html en el navegador (no se recarga solo). El total ahora dice 26,036,711, y la oración de Tate Modern no se movió. Esa es la desactualización de la Sección 1.1 en tu propia pantalla: cambió un dato de entrada, los números calculados lo siguieron y el escrito a mano se quedó atrás.
El valor de prueba no es real, así que deshazlo:
git restore data/visits.csv
git statusOn branch main
nothing to commit, working tree clean
git restore devuelve un archivo a como estaba en el último commit. Es el deshacer de cualquier archivo que Git sigue, y es definitivo: el cambio que descarta nunca se registró, así que se pierde. Renderiza una vez más, y la página vuelve a 25,036,711.
5.6 Tres errores a propósito
Los errores son mensajes, no veredictos, y es más fácil aprender de ellos cuando los causaste a propósito. Para cada error de abajo, comételo, lee el mensaje y revisa una evidencia antes de corregir nada. Tres reglas para leer un error:
- Busca la primera línea que diga
ERRORoerror, a menudo en rojo: dice qué salió mal. Cuando la sigue una traza de la pila larga, sube hasta ella. - Mira adónde apunta el acento circunflejo
^, cuando hay uno: ahí es donde el programa notó el problema. - Sáltate la traza de la pila. Muchos errores de Quarto terminan con
Stack trace:y una lista de líneas que empiezan conat …, ocho para una carpeta equivocada y más de veinte para una configuración rota. Una traza de la pila (stack trace) enumera lo que se estaba ejecutando dentro de Quarto cuando se detuvo: es para los desarrolladores de Quarto, no para ti.
La carpeta equivocada
En la terminal:
cd ~
uv run quarto render report.qmdERROR: No valid input files passed to render
Stack trace:
at _Command.actionHandler (file:///…/quarto.js:142967:11)
…
Quarto no encontró ningún archivo para renderizar. Antes de cambiar nada, ¿qué revisas?
Dónde estás, y qué hay ahí: pwd imprime tu carpeta personal, y ls no muestra ningún report.qmd. El comando estaba bien y la carpeta estaba mal. Un nombre mal escrito, como reprot.qmd, da el mismo mensaje, y ls también lo muestra. Corrígelo con cd ~/first-report y vuelve a renderizar: la última línea es Output created: report.html.
Un error de tipeo en el comando
En la terminal, en ~/first-report:
uv run quatro render report.qmderror: Failed to spawn: `quatro`
Caused by: No such file or directory (os error 2)
¿Qué te dice la primera línea, y cuál es la solución?
uv no pudo iniciar un programa llamado quatro, porque no existe ninguno. El error repite el nombre: compáralo, letra por letra, con lo que querías escribir. Presiona la flecha hacia arriba para traer de vuelta el comando, corrígelo y presiona Enter. Sin uv run, la shell dice lo mismo con sus propias palabras: zsh: command not found: quatro en una Mac, quatro: command not found en Ubuntu.
Configuración rota
Abre report.qmd con nano report.qmd, borra el espacio después de los dos puntos en format: html para que diga format:html, guarda y sal. Luego, en la terminal:
uv run quarto render report.qmdERROR: YAMLException: can not read a block mapping
entry; a multiline key may not be an implicit key (4:1)
1 |
2 | title: "Five London Sights"
3 | format:html
4 |
-----^
Stack trace:
at …
(La primera línea es una sola línea en tu pantalla, partida aquí para que quepa; la traza de la pila ocupa más de veinte líneas.)
El acento circunflejo apunta a la línea 4, que está vacía. ¿Dónde está el error, y cómo lo revisas?
En la línea 3, la de arriba. (4:1) significa línea 4, columna 1, contadas dentro del bloque de configuración, donde la línea 1 es el --- de apertura y se muestra vacía. Sin el espacio, format:html no es una opción de configuración, así que YAML, el formato de esa configuración, sigue leyendo y se rinde en la línea 4. Mira la línea del acento circunflejo y la de arriba. git diff muestra la única línea que cambiaste.
Corrígelo volviendo a poner el espacio, o con el deshacer general, git restore report.qmd. Luego vuelve a renderizar para confirmar: la última línea es Output created: report.html.
5.7 Pásale la corrección al agente
Sabes dónde está el número equivocado, puedes ver cualquier cambio con git diff y puedes deshacer uno con git restore. Ese es el momento de delegar: no antes de poder revisar el trabajo, sino en cuanto puedes hacerlo. Inicia tu agente en la carpeta del informe. En la terminal:
cd ~/first-report
claudeEscribe codex o agy en lugar de claude si ese es tu agente. Confía en la carpeta cuando lo pregunte, porque la hiciste tú (en Claude Code, presiona primero la flecha hacia abajo: la opción empieza en No). (Codex pregunta aquí, y no en ~/setup, porque esta carpeta ahora es un repositorio de Git.) Luego, en el agente:
En report.qmd, la oración sobre "Tate Modern" escribe a mano su conteo de visitas. Reemplaza el número escrito a mano por código en línea que lea el `visits_2025` de Tate Modern desde data/visits.csv. No cambies data/visits.csv. Renderiza con `uv run quarto render report.qmd` y dime qué número muestra ahora la oración.lee AGENTS.md, report.qmd y data/visits.csv · edita report.qmd · uv run quarto render report.qmd
apruebas sus comandos · /exit · luego, en la terminal, git status y git diff
El AGENTS.md del punto de partida ya dice que data/visits.csv nunca se debe editar y que cada número sale de los datos mediante código en línea, así que es probable que el agente lo haga bien. Probable no es lo mismo que revisado.
El agente informa: “Listo. La oración ahora muestra la cifra de los datos”. ¿Por qué ejecutar git diff de todos modos?
El mensaje del agente es una afirmación sobre los archivos; el diff muestra los archivos mismos, cada archivo y cada línea que cambió, incluidos los que el agente no mencionó, como una edición de los datos.
5.7.1 Tres revisiones para cada cambio
Cada cambio de este libro, tuyo o del agente, pasa las mismas tres revisiones: dos antes de hacer commit y una después. Aquí están, aplicadas a este:
| Revisión | Pregunta | Aquí |
|---|---|---|
| Alcance | ¿Cambiaron solo los archivos que quería cambiar? | git status enumera solo report.qmd; git diff muestra las líneas |
| Corrección | ¿Coincide un número con su fila de origen? | la cifra de Tate Modern de la página contra su fila en cut -d, -f1,2 data/visits.csv |
| Reconstrucción | ¿Lo que registraste con commit se construye por sí solo? | renderiza un clon nuevo del repositorio (abajo) |
Alcance. git status debería enumerar un archivo modificado, report.qmd. Si también aparece data/visits.csv, el agente rompió la regla del proyecto: git restore data/visits.csv deshace esa parte. El diff se va a ver más o menos como este, de una versión escrita a mano para probar el paso (recortado en el …); el de un agente va a diferir en los detalles:
diff --git a/report.qmd b/report.qmd
index 4147a02..39b9454 100644
--- a/report.qmd
+++ b/report.qmd
@@ -13,6 +13,8 @@ with open("data/visits.csv…
total = sum(int(r["visits_2025"]) for r in …
top = max(rows, key=lambda r: int(r["visits…
free = [r for r in rows if r["admission"].s…
+tate = next(int(r["visits_2025"]) for r in rows
+ if r["attraction"] == "Tate Modern")
```
Five of London's best-known sights had `{py…
@@ -20,7 +22,7 @@ between them in 2025. The …
with `{python} f"{int(top['visits_2025']):,…
the five are free to enter.
-Tate Modern, on the South Bank, had 4,154,266 visits.
+Tate Modern, on the South Bank, had `{python} f"{tate:,}"` visits.
Source: ALVA, "Visits made in 2025 to visit…
ALVA" (only ALVA member attractions are cou…
El número escrito a mano desapareció, y en su lugar hay código en línea que busca Tate Modern en los datos.
Corrección. Vuelve a cargar report.html: la oración ahora debería decir 4,514,266, que es el 4514266 de la fila Tate Modern en la salida de cut de la Sección 5.3.
Si alguna de las dos revisiones falla, git restore report.qmd devuelve el archivo a como estaba antes de que el agente lo tocara, y puedes volver a pedirlo. Deshacer funciona con los cambios del agente exactamente igual que con los tuyos.
Cuando las dos pasan, haz commit, en la terminal:
git commit -am "Compute Tate Modern's visits from the data"
git log --oneline-a agrega cada archivo seguido que cambió, así que no necesitas git add; -m da el mensaje. Tu hash, y quizá la cantidad de líneas, van a ser distintos:
[main d7e7f02] Compute Tate Modern's visits from the data
1 file changed, 3 insertions(+), 1 deletion(-)
d7e7f02 (HEAD -> main) Compute Tate Modern's visits from the data
15856fe Starter report, as copied
Reconstrucción. La última revisión pregunta si todo lo que necesita el informe está en el historial, y no solo en tu carpeta. Clona el repositorio en /tmp, una carpeta para archivos temporales que la computadora vacía de vez en cuando, y renderiza el clon. En la terminal:
git clone ~/first-report /tmp/first-report-check
cd /tmp/first-report-check
uv run quarto render report.qmdCloning into '/tmp/first-report-check'...
done.
El clon no tiene .venv/ ni report.html, porque .gitignore los dejó fuera del historial, así que el renderizado imprime otra vez Creating virtual environment y luego construye la página. (Si Git dice que el destino ya existe, ya hiciste esto antes: elige otro nombre, como /tmp/first-report-check2.) Abre la página del clon como abriste la tuya: open report.html (Mac), xdg-open report.html (Linux), o explorer.exe . y luego doble clic en report.html (Windows, en Ubuntu). Debería coincidir con la tuya, 4,514,266 incluido. Si el clon no se renderiza, algo que el informe necesita nunca se registró con commit: agrégalo y vuelve a hacer commit. Luego cd ~/first-report para volver; el clon es desechable.
Resumen
- Un informe que se renderiza sin errores puede estar mal igual: pon cada número al lado de su fila en los datos, y rastrea uno equivocado hasta donde se escribió a mano.
- Los números escritos a mano se desactualizan y los calculados siguen a los datos. Cambia un dato de entrada, predice, reconstruye y explica.
git statusdice qué cambió,git diffmuestra cómo,git restorelo deshace ygit commitregistra un estado al que puedes volver.- Lee un error desde su primera línea y el acento circunflejo, sáltate la traza de la pila y revisa una evidencia (
pwd,ls,git diff) antes de corregir nada. - Delega un cambio en cuanto puedas revisarlo: alcance, corrección y reconstrucción (Tabla 5.2), y luego haz commit.
Ya hiciste a mano cada revisión que el resto del libro te pide hacerle al trabajo de un agente, en un proyecto lo bastante pequeño para verlo entero. La Parte II lo lleva a mayor escala. Cada proyecto empieza como este, con git init, así que cada edición del agente en él se puede ver con git diff y deshacer con git restore. El Capítulo 6 empieza la guía de Londres desde una carpeta vacía y explica, una construcción a la vez, el Markdown que acabas de leer.
Lecturas adicionales
- Scott Chacon y Ben Straub, Pro Git, Recording Changes to the Repository y Undoing Things, que cubre
git restore(consultados el 2026-11-17). - Git, páginas de referencia de
git initygit restore(consultadas el 2026-11-17). - GNU nano, hoja de referencia de sus teclas (consultada el 2026-11-17).
- Astral, Running commands con
uv run(consultado el 2026-11-17).