Cómo iniciar cualquier proyecto con Claude Code
El sistema completo para iniciar cualquier proyecto con Claude Code en 8 pasos: desde definir el problema hasta escalar. Prompts listos para usar, archivos a crear y resultado esperado en cada etapa.
1. Definir el proyecto con claridad
Prompt a usar
Quiero que actúes como un arquitecto de software senior.
Antes de escribir código, haceme todas las preguntas necesarias para entender perfectamente el proyecto que quiero construir.
Tenés que profundizar en:
- Objetivo del producto
- Usuario ideal
- Problema que resuelve
- Funcionalidades principales
- Modelo de negocio (si aplica)
- Tecnologías preferidas (si tengo alguna)
No escribas código todavía. Solo hacé preguntas hasta tener claridad total.
Resultado esperado
Claude te hace entre 10 y 20 preguntas bien pensadas para definir el proyecto con precisión.
Acción
Responder todas las preguntas en detalle. Este paso define el 80% del resultado final.
2. Crear el archivo CLAUDE.md (el cerebro del proyecto)
Prompt a usar
En base a toda la información que definimos, creá un archivo CLAUDE.md completo para este proyecto.
Debe incluir:
- Descripción del proyecto
- Objetivo principal
- Usuario objetivo
- Stack tecnológico definido
- Arquitectura del sistema
- Reglas claras de desarrollo (qué hacer y qué evitar)
- Convenciones de código
- Cómo correr el proyecto
- Cómo testearlo
El archivo debe estar optimizado para que Claude Code entienda perfectamente el contexto y tome buenas decisiones.
Resultado esperado
Un archivo CLAUDE.md claro, estructurado y accionable.
Acción
Crear manualmente el archivo CLAUDE.md en la raíz del proyecto y pegar el contenido generado.
3. Generar el plan del proyecto antes de programar
Prompt a usar
Ahora, en base al contexto del proyecto, quiero que generes un plan de desarrollo completo.
Dividilo en features o módulos pequeños y ordenados.
Para cada feature, incluí:
- Qué se va a construir
- Qué archivos están involucrados
- Dependencias necesarias
- Orden recomendado de implementación
No escribas código todavía. Solo el plan estructurado.
Resultado esperado
Un roadmap claro con todas las funcionalidades separadas en pasos ejecutables.
Acción
Revisar el plan y asegurarse de que tenga sentido antes de avanzar.
4. Construir por bloques pequeños (feature por feature)
Prompt a usar
Vamos a implementar la siguiente feature:
[PEGAR FEATURE DEL PLAN]
Quiero que:
- Generes el código necesario
- Crees los archivos correspondientes
- Expliques dónde va cada archivo
- Incluyas validaciones básicas
Mantené el código simple, limpio y funcional.
Resultado esperado
Código funcional para una sola feature, bien separado y entendible.
Acción
Probar manualmente que la feature funcione antes de continuar.
5. Agregar testing básico en cada bloque
Prompt a usar
Generá tests básicos para esta feature.
Incluí:
- Casos principales de uso
- Casos de error
- Cómo ejecutar los tests
Usá el stack definido en el proyecto.
Resultado esperado
Tests simples que validen que la feature funciona correctamente.
Acción
Ejecutar los tests y validar que todo pase correctamente.
6. Iterar y mejorar constantemente
Prompt a usar
Revisá el código actual del proyecto y proponé mejoras.
Buscá:
- Código innecesario o redundante
- Posibles mejoras de arquitectura
- Problemas de escalabilidad
- Mejores prácticas no aplicadas
Luego sugerí cambios concretos.
Resultado esperado
Lista de mejoras accionables para subir el nivel del proyecto.
Acción
Aplicar mejoras antes de seguir escalando.
7. Actualizar el CLAUDE.md continuamente
Prompt a usar
En base a los cambios recientes del proyecto, actualizá el archivo CLAUDE.md.
Asegurate de que refleje:
- Nuevas decisiones técnicas
- Cambios en arquitectura
- Nuevas reglas o convenciones
Resultado esperado
Un CLAUDE.md siempre alineado con el estado real del proyecto.
Acción
Reemplazar el contenido del archivo con la nueva versión.
8. Escalar el proyecto de forma ordenada
Prompt a usar
Quiero escalar este proyecto.
Proponé:
- Nuevas features alineadas al objetivo
- Mejoras de performance
- Posibles integraciones
- Cómo estructurar el crecimiento sin romper lo existente
Resultado esperado
Ideas claras para crecer sin perder control del sistema.
Acción
Volver al paso 4 y seguir construyendo por bloques.