Skip to content

Repository files navigation

Claude Code Setup por Aumentra — la estructura .claude lista para producción

Licencia MIT Para Claude Code y Cowork Modelos Opus 4.8 / Sonnet 4.6 / Haiku 4.5 Por Aumentra

Claude Code Setup — la estructura .claude/ lista para producción

La plantilla que le da a la IA el "manual de tu proyecto" para que deje de olvidar tu stack y trabaje como un desarrollador 10×. Funciona en Claude Code y en Claude Cowork, con un onboarding por entrevista que configura cada proyecto por ti y se va auto-mejorando.

EN — TL;DR: A production-ready .claude/ setup for Claude Code & Cowork: CLAUDE.md, hooks, skills, subagents and an interview-driven onboarding that self-improves. Built on the Agent Skills open standard. Tuned for Opus 4.8 / Sonnet 4.6 / Haiku 4.5. Built by Aumentra.

Hecho por Luis Zamaniego · Aumentra — consultoría de integración digital. 👉 Agenda una llamada gratis


¿Qué es esto? (en simple)

Cuando usas una IA para programar (Claude Code o Cowork), por defecto se le olvida tu proyecto cada que abres una sesión: tu stack, tus reglas, cómo se despliega, qué nunca debe tocar. Terminas repitiendo lo mismo una y otra vez.

La solución no es un prompt más largo. Es una carpeta — la carpeta .claude/ — que funciona como el manual de operaciones que la IA lee siempre. Aquí dentro está esa carpeta, ya armada con las mejores prácticas, más una entrevista que la adapta a tu proyecto en minutos.

Piénsalo así: es como dar de alta a un empleado nuevo con su inducción ya hecha, en vez de explicarle todo desde cero cada mañana.


¿Por qué te conviene? (si diriges o emprendes)

  • ⏱️ Menos tiempo perdido: dejas de re-explicar tu proyecto en cada sesión.
  • 🛡️ Menos errores caros: reglas que se aplican siempre (no se le puede "olvidar" a la IA correr las pruebas antes de publicar, ni leer tus contraseñas).
  • 🚀 Más velocidad de salida: la misma estructura con la que se construyen apps de verdad, lista para reusar en cada cliente o proyecto.
  • 🔁 Mejora sola: cada proyecto que la usa la deja un poco más afinada.

Antes de empezar (requisitos)

Necesitas una de estas dos formas de usar Claude:

Herramienta Qué es Para quién
Claude Code La IA de programación de Anthropic en tu terminal. Si tú o tu equipo escriben código.
Claude Cowork El modo de la app de escritorio de Claude que automatiza archivos y tareas (sin terminal). Si prefieres algo más visual, sin línea de comandos.

¿No sabes cuál tienes o cómo instalarlas? En la documentación oficial de Anthropic está el paso a paso. Si te complica, escríbenos y te orientamos.


Instalación paso a paso

Opción A — Claude Code (recomendada)

  1. Descarga este repositorio (botón verde Code ▸ Download ZIP, o clónalo) y, si quieres compartirlo en tu equipo, súbelo a tu propio GitHub.
  2. Abre Claude Code en la carpeta de tu proyecto y añade el marketplace:
    /plugin marketplace add Zamaniego/claude-code-setup
    
  3. Instala el plugin:
    /plugin install foundation@claude-foundation
    
  4. Listo. Ya tienes los comandos /onboard, /refine, /ship, /commit, los subagentes y los hooks en todos tus proyectos.

¿Solo quieres probarlo sin GitHub? Desde la carpeta descargada:

claude --plugin-dir ./claude-code-setup/plugins/foundation

Opción B — Claude Cowork / apps

Las skills siguen el estándar abierto Agent Skills, así que también funcionan en Cowork. Instala la skill onboard (archivo onboard.skill) con el botón "Save skill", o copia la carpeta plugins/foundation/skills/onboard/ a tus skills. Luego pídele a Claude: "haz el onboarding de este proyecto".

Opción C — copiar la plantilla a mano

Si solo quieres los archivos base, copia el contenido de project-template/ a la raíz de tu proyecto y rellena los {{CAMPOS}} de CLAUDE.md.


Cómo usarlo (día a día)

cd ~/clientes/proyecto-x
/onboard      # entrevista: nombre, stack, comandos, deploy, reglas… y genera tu .claude
# …trabajas normal…
/refine       # cada pocas sesiones: aprende de tu trabajo y mejora la configuración
Comando Qué hace, en simple
/onboard Te hace preguntas sobre el proyecto y crea CLAUDE.md, permisos, reglas y conexiones por ti.
/refine Revisa lo aprendido, mejora las reglas y quita lo que ya no sirve. Se auto-mejora.
/ship Compila, revisa y publica en un solo paso. Se detiene si algo falla.
/commit Guarda tu avance con un mensaje limpio y sin filtrar contraseñas.

Qué incluye

Pieza Para qué sirve
🧠 CLAUDE.md (plantilla) El "cerebro" del proyecto: reglas, stack, comandos. Menos de 200 líneas, como recomienda Anthropic.
🪝 Hooks Reglas que se cumplen siempre (no se le pueden olvidar a la IA): bloquean comandos peligrosos, evitan leer secretos y corren las pruebas antes de publicar.
🤖 Subagentes Ayudantes con el modelo adecuado al costo: planner (Opus 4.8), code-reviewer (Sonnet 4.6), researcher y log-analyzer (Haiku 4.5).
🧩 Skills Flujos reutilizables: onboard, refine, ship, commit.
📐 Reglas por carpeta Reglas de API, base de datos y seguridad que se cargan solo cuando aplican.
✍️ Output style "terse" Respuestas directas, sin relleno.

Preguntas frecuentes (FAQ)

No soy programador. ¿Esto es para mí?
Sí. Está pensado para fundadores y directivos que usan Claude para construir o automatizar. El comando /onboard te hace preguntas en español y arma todo por ti. Si te atoras, te ayudamos.
¿Cuesta algo?
No. Es gratis y de código abierto (licencia MIT). Solo necesitas tu acceso a Claude Code o Cowork.
¿Funciona con Claude Cowork, no solo con Claude Code?
Sí. Las skills usan el estándar abierto Agent Skills, que funciona en Claude Code, Cowork y las apps. Algunas funciones avanzadas (hooks a nivel terminal) son exclusivas de Claude Code.
¿Tengo que saber qué modelo usar (Opus, Sonnet, Haiku)?
No. Ya viene configurado: Opus 4.8 para planear, Sonnet 4.6 para programar el día a día y Haiku 4.5 para tareas baratas. Puedes cambiarlo cuando quieras con /model.
¿Es seguro? ¿Va a tocar mis contraseñas o borrar cosas?
Trae candados de seguridad: bloquea leer archivos de secretos (.env), bloquea comandos destructivos como rm -rf y el force-push a tu rama principal. Tú mandas; la IA pide permiso para lo sensible.
Trabajo con varios clientes. ¿Lo instalo en cada proyecto?
Lo instalas una vez como plugin y aparece en todos tus proyectos. En cada repo corres /onboard para adaptarlo. Cuando mejoras el plugin, todos tus proyectos heredan la mejora.
¿Qué es eso de que "se auto-mejora"?
Cada pocas sesiones corres /refine: revisa tu trabajo reciente, agrega las reglas nuevas que aprendió, quita lo obsoleto y convierte en "candado" lo que deba cumplirse siempre.
¿Necesito GitHub?
No es obligatorio. Puedes usarlo localmente con --plugin-dir. GitHub solo ayuda si quieres compartirlo con tu equipo.

Sobre Aumentra

Aumentra es una consultoría de integración digital para empresas familiares mexicanas. No vendemos software: vendemos criterio. Conectamos el ERP, CRM, WhatsApp y Excel que ya tienes para que por fin se hablen entre sí — y medimos lo que de verdad le importa al dueño.

Lo que ya tienes, conectado. Lo que sobra, fuera. Lo que importa, medido.

👉 ¿La tecnología te complica más de lo que te ayuda? Hablemos.


Desarrollado por Luis Zamaniego · Aumentra · Culiacán, México · Licencia MIT
aumentra.com