taller-graphify-starter

Codebase + corpus heterogéneo para el taller-graphify de Código Sin Siesta. Salida del taller: sabes cuándo Graphify aporta valor sobre tu material y cuándo no — con datos, no con marketing.

Este repo es el starter del taller. Las slides hermanas viven en taller-graphify-presentation. La página resumen está en el wiki de Código Sin Siesta.

Qué hay aquí

• src/ — un mini coding agent en TypeScript (Fastify + tool registry + loop chat). ~10 ficheros, dependencias mínimas. Suficientemente real para que Graphify produzca un grafo interpretable, no un toy example.
• raw/ — corpus heterogéneo: 5 docs markdown sobre temas que cruzan con src/ (skills de Claude Code, MCP overview, README de Graphify, patrón LLM Wiki de Karpathy, instruction budget). El interés está en que Graphify detecte conexiones cross-modal entre código y docs.
• tests/ — 9 tests con node:test. Verde es la condición de entrada al Ejercicio 1.
• ejercicios/ — los 3 ejercicios del taller, en orden:
  1. Setup + primera ejecución (25-30 min)
  2. Skill en Claude Code + queries (20-25 min)
  3. Veredicto razonado (15-20 min, opcional)
• AGENTS.md — instrucciones para tu agente (Claude Code, Codex, OpenCode, Cursor, Copilot…). Mira esto antes de pedirle nada al agente.

Quick start

git clone https://github.com/CodigoSinSiesta/taller-graphify-starter
cd taller-graphify-starter
npm install
npm test
npm run typecheck

Si las dos últimas líneas pasan en verde, estás listo. Sigue con ejercicios/01-setup.md.

Requisitos

• Node.js ≥ 20 — node --version.
• uv (instalador de herramientas Python — Graphify se distribuye así). Instalación: curl -LsSf https://astral.sh/uv/install.sh | sh.
• Un coding agent con acceso al filesystem: Claude Code, Codex CLI, OpenCode, Cursor, Copilot CLI, Aider o cualquier moderno equivalente.
• API key activa del proveedor que tu agente use.
• Coste estimado del taller: ~$0.30-0.50 USD por participante (un pase completo de Graphify sobre este starter genera ~250-350k tokens).

Estructura del grafo que vas a obtener

Pista, sin spoilers: el codebase tiene una topología deliberada. Hay un fichero que casi todos los demás importan (los tests también) y dos clusters bien separados. Con el corpus de raw/ añadido, deberían aparecer conexiones cross-modal entre símbolos del código y conceptos de los docs (p. ej. tool-registry.ts ↔ sección de 01-anthropic-skills.md que habla de tool registry).

Predecir la salida antes de ejecutar es parte del Ejercicio 1.

Después del taller

• Si decides adoptar Graphify: instala el git hook (graphify hook install) para que el grafo se rebuild en cada commit, y considera --mcp para que otros agentes consulten tu grafo.
• Si decides no adoptar: el cuadrante de decisión del Ejercicio 3 sigue siendo útil. Re-evalúa cuando tu corpus crezca >3× o el patrón de uso cambie.
• Si quedaste en empate: re-haz el Ejercicio 3 dentro de un mes con tu repo en su estado real, no en el de hoy.

Licencia

MIT — incluida en LICENSE. El material del taller (ejercicios/, los docs de raw/) también está bajo MIT con atribución a Código Sin Siesta y a las fuentes citadas en cada source_url del frontmatter.