5.1 Qué esperamos ver en tu repositorio

Qué aprenderás: los requisitos mínimos del repositorio y cómo lo lee una persona que lo revisa en pocos minutos.

No esperamos un proyecto perfecto. Esperamos un proyecto vivo, con proceso, decisiones, avances y honestidad. Los requisitos mínimos del camino A:

• Un repositorio en GitHub, público o privado con acceso concedido (lección 5.7).
• La dirección (URL) del repositorio, enviada por el formulario de la candidatura.
• Un README inicial completo (lección 5.4).
• Al menos 5 commits con mensajes claros, repartidos en el tiempo (lección 5.3).
• Evidencia de avance real (lección 5.5).
• Explicación del problema y de la solución.
• Estado actual del proyecto.
• Próximos pasos.
• Declaración de uso de IA (lección 5.6).
• Reflexión final (lección 5.10).

Cómo lo lee una persona en tres minutos. Quien revisa muchas candidaturas no lee todo: sigue un recorrido casi siempre igual.

1. El README. ¿Entiendo qué es, para quién y en qué punto está?
2. El historial de commits. ¿Hay una historia con fechas y pasos, o un único bloque subido de golpe?
3. La estructura. ¿Las carpetas y los nombres tienen sentido?
4. La evidencia. ¿Hay capturas, notas, un prototipo o algo que enseñe que ocurrió?
5. El uso de IA. ¿Dice qué hizo la IA y qué hizo la persona?
6. Los riesgos. ¿Hay claves, datos personales o contenido ajeno sin permiso?

Señales de alerta: un solo commit gigante, un README vacío o copiado de una plantilla sin cambiar, una historia que no cuadra con lo que se cuenta, ninguna declaración de IA, secretos expuestos y capturas que nadie podría haber hecho con lo que hay.

Lo que se espera de ti, en una frase: que se vea que lo has hecho tú, cómo lo has hecho y hasta dónde has llegado.

Ideas clave:

• Se pide un proyecto vivo, no uno perfecto.
• Se lee en este orden: README, historial, estructura, evidencia, uso de IA y riesgos.
• Un historial real y un README honesto pesan más que un resultado vistoso.

Error común: dejar el repositorio para el último día. El historial muestra las fechas y no se puede improvisar con credibilidad.