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
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.
- ⏱️ 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.
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.
- 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. - Abre Claude Code en la carpeta de tu proyecto y añade el marketplace:
/plugin marketplace add Zamaniego/claude-code-setup - Instala el plugin:
/plugin install foundation@claude-foundation - 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
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".
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.
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. |
| 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. |
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.
|
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. |
- 📅 Agenda una videollamada (30 min, sin venta): aumentra.com/agendar
- 💬 WhatsApp / llamadas: +52 800 351 1011
- ✉️ Email: luis@aumentra.com
- 🌐 Web: aumentra.com
- 📱 Redes: @aumentra (Instagram · TikTok · YouTube)
Desarrollado por Luis Zamaniego · Aumentra · Culiacán, México · Licencia MIT
aumentra.com
