Proyectos Básicos

Es hora de aplicar lo que has aprendido. En esta sección construirás dos proyectos simples que te darán confianza con ClaudeKit.

---

¿Listo para más? Continúa al Nivel Intermedio para dominar workflows completos.

---

Proyectos Disponibles

Mi Primer README

Crea un README profesional para tu proyecto usando ClaudeKit. Aprende a documentar de forma efectiva.

Herramienta CLI Básica

Desarrolla una herramienta de línea de comandos simple con Node.js. Perfecto para practicar workflows.

Antes de Empezar

✅ Checklist de Preparación

• Claude Code CLI instalado y funcionando
• Git configurado con tu nombre y email
• Node.js >= 18 instalado
• Editor de código listo (VSCode recomendado)
• Cuenta de GitHub activa

Proyecto 1: Mi Primer README

Objetivo

Crear un README.md profesional para un proyecto usando ClaudeKit.

Duración

1-2 horas

Lo que aprenderás

• Estructura de un buen README
• Comandos /ask y /cook
• Edición iterativa con IA

Paso a Paso

Paso 1: Crear el proyecto

mkdir mi-primer-readme
cd mi-primer-readme
git init
npm init -y

Paso 2: Usar ClaudeKit

# Pedir a Claude que cree el README
claude cook "Crear un README profesional para un proyecto Node.js de calculadora"

Paso 3: Revisar y ajustar

# Pedir cambios específicos
claude ask "¿Cómo puedo agregar una sección de badges al README?"

Resultado Esperado

Un README.md con:

• Título y descripción
• Badges de estado
• Instrucciones de instalación
• Ejemplos de uso
• Sección de contribución

---

Proyecto 2: Herramienta CLI Básica

Objetivo

Crear una herramienta de línea de comandos simple usando Node.js y ClaudeKit.

Duración

8-10 horas

Lo que aprenderás

• Workflow completo: /plan → /cook → /test → /commit
• Estructura de un proyecto CLI
• Manejo de argumentos
• Publicación en npm

Paso a Paso

Paso 1: Planificar

claude plan "Crear herramienta CLI para contar líneas de código en archivos JavaScript"

Paso 2: Implementar

claude cook "Implementar el contador de líneas de código según el plan"

Paso 3: Testear

claude test

Paso 4: Hacer Commit

claude commit

Características de la Tool

• Contar líneas de archivos .js
• Soporte para directorios recursivos
• Opción —exclude para ignorar archivos
• Output formateado (tabla)
• Tests unitarios
• README completo

---

Tips para Estos Proyectos

💡 Consejos Útiles

1. Empieza simple - No intentes hacer todo perfecto desde el inicio
2. Usa /ask frecuentemente - Para dudas específicas
3. Revisa el código - Aunque Claude lo escriba, entiéndelo
4. Haz commits pequeños - Cada feature completada es un commit
5. Documenta mientras avanzas - El README crece con el proyecto

Problemas Comunes

Problema	Solución
Claude no entiende mi solicitud	Sé más específico, da ejemplos
El código tiene errores	Usa /fix con el error específico
No sé qué sigue	Usa /ask "¿Qué debería hacer después?"
Tests fallan	Usa /debug para analizar el problema

Siguiente: Nivel Intermedio

¡Felicidades! Has completado el nivel principiante. Estás listo para workflows más complejos.