Skip to content

Instantly share code, notes, and snippets.

@jorgeucano
Created January 2, 2026 22:04
Show Gist options
  • Select an option

  • Save jorgeucano/e6dee98f365a7e92b9a189011d7515b3 to your computer and use it in GitHub Desktop.

Select an option

Save jorgeucano/e6dee98f365a7e92b9a189011d7515b3 to your computer and use it in GitHub Desktop.
Necesito que analices este proyecto y generes la infraestructura completa para trabajar eficientemente con Claude Code siguiendo las mejores prácticas. Hacé lo siguiente:
## 1. CLAUDE.md (raíz del proyecto)
Analizá el código, estructura, dependencias y patrones del proyecto. Generá un CLAUDE.md que incluya:
- Descripción del proyecto y su propósito de negocio
- Stack tecnológico y versiones principales
- Estructura de directorios con explicación de cada carpeta importante
- Convenciones de código (naming, patrones, arquitectura)
- Comandos esenciales (build, test, lint, deploy)
- Flujo de trabajo del equipo (branches, PRs, CI/CD)
- Errores comunes a evitar (basado en lo que veas en el código)
- Contexto de negocio relevante para entender decisiones técnicas
## 2. .claude/commands/
Creá slash commands para workflows comunes. Mínimo estos archivos:
- `pr.md` - Crear un PR con descripción, tests y changelog
- `review.md` - Revisar código buscando bugs, seguridad y mejoras
- `test.md` - Generar tests para un archivo o función específica
- `refactor.md` - Refactorizar código manteniendo funcionalidad
- `docs.md` - Generar/actualizar documentación
- `debug.md` - Investigar y solucionar un bug
- `feature.md` - Implementar una feature desde plan hasta PR
Cada comando debe incluir instrucciones claras, el formato de output esperado, y pasos de verificación.
## 3. .claude/settings.json
Configurá permisos seguros pre-aprobados basándote en las herramientas del proyecto:
- Comandos de lectura (cat, ls, find, grep, etc.)
- Comandos del package manager detectado (npm, yarn, pnpm, pip, etc.)
- Comandos de git seguros (status, diff, log, branch)
- Linters y formatters del proyecto
- Comandos de test
- Cualquier CLI específica que detectes (kubectl, docker, mongosh, etc.)
NO incluyas comandos destructivos ni con side-effects peligrosos.
## 4. .claude/agents/
Creá subagentes especializados:
- `code-simplifier.md` - Simplificar y limpiar código sin cambiar funcionalidad
- `security-check.md` - Auditoría de seguridad del código
- `verify.md` - Verificar que los cambios funcionan correctamente
## 5. .claude/hooks/ (documentación)
Creá un archivo `hooks-setup.md` explicando cómo configurar:
- PostToolUse hook para formateo automático con el formatter del proyecto
- Stop hook para verificación automática en tareas largas
## 6. .mcp.json (si aplica)
Si detectás integraciones que podrían beneficiarse de MCP servers (Slack, bases de datos, APIs), creá un template de .mcp.json con la estructura comentada.
## 7. README de .claude/
Creá `.claude/README.md` explicando toda la estructura generada y cómo el equipo puede contribuir/modificarla.
---
IMPORTANTE:
- Adaptá todo al contexto REAL de este proyecto, no uses placeholders genéricos
- Usá el estilo y convenciones que ya existen en el código
- Si encontrás documentación existente, integrala
- Verificá que los comandos que pre-apruebes realmente existan en el proyecto
- Poné ejemplos concretos basados en el código real
Empezá analizando el proyecto y después generá cada archivo. Mostrá el plan antes de ejecutar.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment