Agent Coding VE — Kit del taller

Este repositorio es tu punto de partida para replicar el esqueleto del sistema de trabajo con IA que viste en el taller. No trae respuestas armadas: trae la estructura, las plantillas y los prompts que necesitas para construir tu propia versión.

Empieza aquí: un comando, no seis pasos

1. Clona este repositorio dentro de Documents/Claude/ (o la carpeta equivalente en tu sistema).
2. Abre una terminal dentro de la carpeta que acabas de clonar y corre claude.
3. Escribe /instalar (o simplemente "ayúdame a empezar").

Eso arma todo: tu CLAUDE.md, las skills, el panel de agentes, tu carpeta de trabajo y tu vault de Obsidian, preguntándote solo lo que un sistema no puede decidir por ti (tu nombre, tu idea de proyecto, si ya usas Obsidian). Si prefieres entender qué hace cada paso por dentro, o armarlo a mano, sigue leyendo desde acá.

Orden de uso recomendado (si no usas /instalar)

1. Lee las guías en PDF (00-guias-pdf/), en este orden:

   • Deck-Dia1-Agent-Coding.pdf y Deck-Dia2-Agentic-Engineering.pdf — referencia visual de lo que viste en vivo.
   • Guia-Sistema-Second-Brain.pdf — instala tu vault y tu workspace, ~1 hora.
   • Guia-Dia1-Paso-a-Paso.pdf y Guia-Dia2-Paso-a-Paso.pdf — replica el flujo completo del taller solo, sin depender de memoria.

2. Genera tu identidad primero (04-prompts/):

   • Corre prompt-about-me.md en una conversación nueva con Claude.
   • Corre prompt-estilo-humano.md con 3-5 muestras reales de tu escritura.
   • Guarda los resultados en 03-workspace-starter/ABOUT ME/.
   • patron-agentes-de-desarrollo.md explica el patrón de 4 roles (researcher / analyst / builder / qa-scorer) detrás del panel autónomo que instalas en el paso 3. Léelo para entender el porqué, no para armarlo a mano: la versión lista para usar ya está en 01-configs/agents/.

3. Instala tu configuración (01-configs/):

   • Copia CLAUDE-global.template.md a ~/.claude/CLAUDE.md (el signo ~ es un atajo para tu carpeta de usuario: en Windows es C:\Users\TU-USUARIO, en Mac es /Users/tu-usuario — la guía paso a paso te muestra el comando exacto) y completa los bloques [EDITAR] con lo que generaste en el paso 2.
   • Copia CLAUDE-proyecto.template.md a la raíz de cada proyecto nuevo.
   • Instala las skills de skills/ (aclarar, arranque, construir, guardar, qa-scorer) en tu carpeta .claude/skills/. La regla que las une: Claude pregunta por el QUÉ cuando falta un dato que cambia el resultado (aclarar), y hace su propia rutina sin preguntar (arranque lee contexto, construir coordina el panel de agentes de punta a punta, guardar persiste decisiones, qa-scorer revisa antes de entregar).
   • Instala los agentes de agents/ (researcher, analyst, builder, qa-scorer, ship-gate) en tu carpeta .claude/agents/. Son el panel autónomo que usa construir para llevar un pedido de cero a producción sin que tengas que manejar tú cada paso técnico. Si no eres técnico, esta es la parte del kit que hace el trabajo pesado por ti. Solo te va a pedir confirmación una vez, antes de publicar de verdad.
   • Si usas claude.ai o Cowork además de Claude Code, usa las versiones condensadas: instrucciones-claude-chat.template.md / instrucciones-cowork.template.md.
   • instrucciones-claude-code.template.md es el mapa de dónde va cada archivo (local y en la nube) y qué tocar en settings.json.

4. Abre tu segundo cerebro (02-vault-starter/): ábrelo como vault de Obsidian. Trae la estructura vacía (Dashboard, entidades, fuentes, daily notes) lista para que empieces a registrar tus propios proyectos y decisiones.

5. Copia tu workspace de ejecución (03-workspace-starter/): la estructura ABOUT ME/ PROJECTS/ TEMPLATES/ que usaste en el taller, con un primer proyecto de ejemplo (mi-primer-proyecto/) ya armado como plantilla.

6. Cuando llegues al Día 2 de tu propio proyecto (05-dia-2/): el workflow de GitHub Actions, el checklist pre-deploy, y un roadmap de las 4 semanas siguientes para no perder el ritmo después del taller.

Estructura

.claude/skills/instalar/  El wizard de /instalar, activo apenas clonas y abres Claude Code aquí
00-guias-pdf/       Decks de referencia y guías paso a paso (PDF)
01-configs/         CLAUDE.md, instrucciones por superficie, skills base, panel de agentes (agents/)
02-vault-starter/   Vault de Obsidian vacío, listo para abrir
03-workspace-starter/  ABOUT ME / PROJECTS / TEMPLATES vacíos
04-prompts/         Prompts de identidad, estilo y desarrollo
05-dia-2/           CI/CD, checklist pre-ship, roadmap post-taller

Antes de empezar

Todo ejemplo en este kit usa una app ficticia, CotizaYa (cotizaciones freelance en USD). No es un proyecto real: es solo el hilo conductor para que los ejemplos sean consistentes entre archivos.

Este kit no incluye tus datos de negocio, tus credenciales, ni ningún dato real de terceros. Todo lo que veas con [EDITAR] es tuyo por completar.

---

Agent Coding VE, Valencia, Venezuela.