AI Dev Workshop · Wallbox 2026

Claude Code Workshop

Antes de empezar

Prerrequisitos

$ git clone https://github.com/nikeyes/ai-dev-workshop.git $ cd ai-dev-workshop $ docker compose build $ docker compose run --rm app uv run pytest
Bloque 1 · Paso 1

Verificar el entorno

$ cd workshop-project $ claude --version $ claude "hola, di solo 'listo'"
Regla

No seguimos hasta que todos tengáis Claude Code funcionando.

Bloque 1 · Paso 1

Ver el estado de Claude Code

> /doctor
Doctor

Comprueba conectividad, credenciales y versión del CLI.

> /status
Status

Muestra el modelo activo, coste acumulado y contexto utilizado de la sesión actual.

Tips

¿Claude Code se cerró en mitad de una tarea?

$ claude --continue # Reanuda la última sesión $ claude --resume # Elige una sesión anterior
Recuerda

Las sesiones son por carpeta.
Asegúrate de estar en workshop-project antes de reanudar.

Antes tardabas 2 horas en escribir código malo.
Ahora tardas 2 segundos.
Bloque 1 · Paso 2

Modelos y coste

Bloque 1 · Paso 3 · Demo

Demo: CLAUDE.md en acción

Bloque 1 · Paso 3

Memoria de los agentes

Sin CLAUDE.md

El agente empieza cada sesión desde cero.
Es como contratar a alguien nuevo cada día.

Con CLAUDE.md

El agente tiene contexto persistente: convenciones del proyecto, cómo validar cambios, qué evitar.
No tienes que repetirlo nunca más.

Con Rules

Reglas específicas que el agente aplica siempre, organizadas por módulo o tipo de tarea.

Bloque 1 · Paso 3 · Buenas prácticas

¿Qué poner en el CLAUDE.md?

Bloque 1 · Paso 3 · Jerarquía

Dónde está el CLAUDE.md

Ubicación Alcance
~/.claude/CLAUDE.md Todos tus proyectos — convenciones personales
<raíz>/CLAUDE.md El proyecto completo (versionado, compartido con el equipo)
<raíz>/CLAUDE.local.md El proyecto, solo tu copia local (gitignored)
<subdirectorio>/CLAUDE.md Solo ese módulo — útil en monorepos
.claude/rules/ Reglas opcionales organizadas por fichero
Prioridad

Cuanto más cerca del código, más específico.
El subdirectorio sobreescribe al proyecto, que sobreescribe al global.

Bloque 1 · Paso 3 · @imports

CLAUDE.md puede importar otros ficheros

# CLAUDE.md Ver @README.md para el resumen del proyecto y @package.json para los comandos disponibles. # Instrucciones adicionales - Git workflow: @docs/git-instructions.md - Overrides locales: @~/.claude/my-project-instructions.md
¿Para qué sirve?

Mantén el CLAUDE.md principal corto e importa ficheros específicos según el contexto.
Los overrides locales (@~/.claude/…) se cargan solo en tu máquina — nunca se versionan.

Bloque 1 · Paso 4

Contexto

> /context
/context

Muestra cuánto contexto llevas consumido en la sesión actual.
Puedes activarlo permanentemente en la status bar.

> /compact
⚠️ /compact — con cuidado

Claude lo ejecuta solo cuando no queda espacio.
Puede perder contexto crítico que no has guardado.
Puedes ejecutarlo manualemente.

Bloque 1 · Paso 4

Añadir contexto de otro módulo

> /add-dir ../otro-servicio
Cuándo usarlo

Cuando necesitas que el agente entienda código de otro módulo sin abrir una sesión nueva.
Útil en monorepos o cuando un cambio cruza servicios.

Alternativa

Si el otro módulo tiene su propio CLAUDE.md, Claude lo leerá automáticamente al añadir el directorio.

Bloque 1 · Paso 5 · Demo

Allow & Deny

Bloque 1 · Paso 5

Permisos

Fichero Alcance
~/.claude/settings.json Global — todos tus proyectos
.claude/settings.json Proyecto — se commitea con el repo
.claude/settings.local.json Solo tú — no se commitea (añadir a .gitignore)
Prioridad

Local sobreescribe proyecto, proyecto sobreescribe global.

Bloque 1 · Paso 6

Rewind — deshacer sin miedo

Bloque 1 · Paso 7

Hooks — guardarraíles automáticos

Qué son

Comandos que se ejecutan automáticamente en respuesta a acciones del agente.
El agente no los pide — simplemente ocurren.

Evento Se dispara cuando… Ideal para
PostToolUse + Edit Después de cada edición de fichero Linter / formatter — actúa mientras el fichero está en foco
Stop Cuando el agente termina su turno Build / tests — espera a que todos los cambios estén hechos
Bloque 1 · Paso 7 · Demo

Configurar un hook con el agente

Bloque 1 · Paso 8

Agents & Skills

El problema

Cada persona de tu equipo reinventa los mismos prompts.
Las Skills son la forma de compartir conocimiento entre sesiones y entre personas.

Qué es una Skill

Un fichero de instrucciones que el agente carga cuando lo necesita.
Vive en .claude/skills/ y se activa con /nombre.

Agentes

Claude puede delegar subtareas a subagentes especializados.
Cada agente tiene su propio contexto, herramientas y CLAUDE.md.

Bloque 1 · Paso 8

Prompts, Skills, Subagents & MCP

Prompts Skills Subagents MCP
Qué aporta Instrucciones paso a paso Procedimientos reutilizables entre sesiones Delegación de tareas con contexto aislado Conectividad con herramientas externas
Persistencia Una sola conversación Entre conversaciones Entre sesiones Conexión continua
Contiene Lenguaje natural Instrucciones + código + assets Lógica completa de agente Definiciones de herramientas
Se carga Cada turno Dinámicamente, cuando es relevante Cuando se invoca Siempre disponible
Incluye código No
Ideal para Peticiones rápidas y puntuales Conocimiento especializado y reutilizable Tareas especializadas con permisos propios Acceso a datos y sistemas externos
Bloque 1 · Paso 8 · Demo

Skills en acción

Bloque 1 · Paso 8 · Skills útiles

Ejemplos de Skills

Skill Para qué sirve
/story-splitting Detecta si una historia son varias disfrazadas
/hamburger-method Corta en capas, genera opciones, elige la que da feedback más rápido
/small-safe-steps Incrementos pequeños, cada uno desplegable de forma independiente
Si repites el mismo prompt más de 2 veces

Sácalo a una Skill.
Así lo comparte todo el equipo sin esfuerzo.

Skill Creator de Anthropic

Genera skills automáticamente a partir de una descripción.
anthropics/skills → skill-creator

Bloque 1 · Paso 8 · Plugins

Plugins para agrupar skills, agentes, MCPs

Recursos útiles

Recursos para AI-Driven Development

Bloque 2 — 1h

Tu ticket, tu repo

Bloque 2 · 1h

Tu ticket, tu repo

Bloque 2 · Guía

Mientras trabajas

Grupos de trabajo

Súmate a un grupo existente

Si deseas sumarte a un grupo de trabajo existente, puedes contactar:

Bloque 3 — 20 min

Retro

Bloque 3 · 20 min

Retro

Librecounter Analytics