Claude Code — flujo de trabajo

Este archivo es lo primero que cualquier sesión de Claude Code debe leer al empezar a trabajar en esta wiki, sobre todo en una VM donde el repo no está clonado todavía.

Orden de lectura al iniciar sesión

1. Este archivo (meta/claude-code-workflow.md).
2. meta/convenciones.md — estructura, frontmatter, estilo.
3. meta/tags.md y meta/hosts.md — vocabulario controlado, antes de escribir cualquier tag o host nuevo.

Flujo git

Si el repo ya está clonado en la VM: git pull antes de editar, para partir de la versión más reciente.

Si el repo no está clonado en esta VM (sesión nueva en una máquina donde nunca se ha trabajado esta wiki): clonar primero con la URL del repo. Requiere que la VM tenga acceso SSH o token configurado hacia GitHub — si no lo tiene, avisar a Esteban en vez de intentar workarounds.

git clone <url-del-repo>

Después de editar:

git add .
git commit -m "mensaje descriptivo del cambio"
git push

El push dispara el build automático en Cloudflare Pages (npx quartz build) — no hay paso manual de publicación. El sitio queda actualizado unos segundos/minutos después del push.

Al crear una página nueva

1. Verificar si ya existe una página relacionada antes de crear una nueva (grep por tema/host/tags) — evitar duplicar contenido que debería ser una sola página ampliada.
2. Frontmatter completo según convenciones.md — project, host (o none), tags (solo del vocabulario controlado), status, updated.
3. Si se usa un tag o host nuevo, registrarlo en tags.md / hosts.md en el mismo commit.
4. Seguir las 5 reglas de estilo de convenciones.md (tercera persona, explicar el porqué, fecha en frontmatter no en prosa, “Véase también” con anotación).
5. Enlazar la página nueva desde el index.md del proyecto correspondiente, para que quede conectada al grafo desde un nodo central.

Al editar una página existente

Actualizar updated en el frontmatter. Si el cambio hace obsoleto el contenido anterior en vez de complementarlo, cambiar status: deprecated en vez de borrar.

Búsqueda antes de responder

Antes de responder una pregunta de Esteban sobre “qué hice / dónde levanté X”, grep por host: o tags: en el frontmatter primero — es más barato en tokens y más confiable que buscar por contenido libre. Solo cargar el contenido completo de las páginas que hacen match.