GuíaIntermedio
Guía de Clean Code y Code Review
Aprende a escribir código que otra persona pueda leer sin sufrir, y a participar en una revisión como profesional en las dos sillas: la de quien propone —empaquetar un cambio, escribir el pull request que lo explica y defender tus decisiones sin ponerte a la defensiva— y la de quien revisa —saber qué mirar primero, qué comentar y qué dejar pasar, y cómo decir lo que ves sin que el otro se cierre. No sales con una lista de reglas de estilo memorizadas: sales sabiendo por qué cada regla existe, cuándo romperla y cómo se conversa sobre código con gente que no piensa igual que tú. Los ocho módulos giran alrededor de Cardumen, una startup de 14 personas con una cultura de revisión rota —PRs que se aprueban en dos minutos con un "LGTM", revisiones temidas, gente que dejó de proponer cambios grandes— y avanzan de código legible a señales de que algo se pudre, al cambio como unidad de comunicación, a revisar el código de otra persona, a la conversación difícil, a estándares que el equipo sí sigue, a revisar código escrito por IA, y cierran con el arco completo de un día real de trabajo.
- 64
- lecciones
- 8
- módulos
- Inglés · Español
- disponible en
- Sí
- certificado
- Gratis
- acceso
Resultados
Lo que vas a poder hacer
- Escribir código que otra persona pueda leer sin sufrir: nombres que no necesitan explicación, funciones que caben en la cabeza, comentarios que explican el porqué y nunca el qué
- Reconocer las señales de que el código se está pudriendo —duplicación, funciones que hacen demasiado, anidamiento profundo, manejo de errores que esconde el error— y nombrar la deuda técnica en vez de sufrirla en silencio
- Empaquetar un cambio como una unidad de comunicación: una sola intención, del tamaño correcto, con mensajes de commit y una descripción de PR que dan contexto, decisión y riesgo
- Revisar el código de otra persona con un orden explícito —intención, diseño, detalle— y marcar cada comentario como bloqueo, sugerencia u opinión
- Revisar los tests y lo que no está en el diff —seguridad, casos borde, datos—, no solo el código visible
- Sostener la conversación difícil: defender una decisión sin ponerte a la defensiva, reconocer cuándo el revisor tiene razón, y discrepar y comprometerte cuando no hay bloqueo real
- Acordar con tu equipo estándares que sí se siguen: automatizar lo automatizable, una guía de estilo mínima viable y checklists de revisión que no estorban
- Revisar código escrito por IA con un criterio distinto: verificar en vez de confiar, detectar código plausible que no funciona, y responder por la autoría de lo que subes
- Cerrar el arco completo en un mismo día: proponer, recibir una revisión dura, revisar bajo presión de tiempo, y diagnosticar y arreglar una cultura de revisión rota
Antes de empezar
Qué necesitas traer
Es para ti si...
- Devs que ya programan y han trabajado sobre código compartido, aunque sea poco: un repositorio con otra persona, un equipo, una contribución externa
- Quien recibe revisiones que se sienten personales, o da revisiones que el equipo teme
- Equipos con una cultura de revisión rota: PRs que se aprueban en dos minutos con un "LGTM", o que se quedan días sin revisar
- Devs que empiezan a recibir más código generado por IA del que pueden revisar a fondo, y necesitan un criterio distinto para eso
Requisitos y materiales
- Saber programar y haber trabajado sobre código compartido, aunque sea poco
- Ideal, no obligatorio, haber visto una guía de fundamentos de desarrollo de software y una de patrones de diseño
- Los ejemplos usan Python con identificadores en inglés, pero todo lo enseñado aplica a cualquier lenguaje
Contenido
El temario, módulo por módulo
Abre cualquiera para ver sus lecciones.
- 1. Presentación del módulo: para quién escribes en realidad
- 2. El lector es el usuario de tu código
- 3. Nombres que no necesitan explicación
- 4. Funciones que caben en la cabeza
- 5. Comentarios: el porqué, nunca el qué
- 6. Consistencia le gana a preferencia
- 7. Formato, linters y el debate que no debe existir
- 8. Proyecto: haz legible un módulo hostil
- 1. Presentación del módulo: leer el código como síntoma
- 2. Duplicación: cuándo importa y cuándo no
- 3. Funciones que hacen demasiado
- 4. Parámetros, banderas y valores mágicos
- 5. Anidamiento profundo y salidas tempranas
- 6. Manejo de errores que esconde el error
- 7. Deuda técnica: nombrarla en vez de sufrirla
- 8. Proyecto: escribe el inventario de deuda de un módulo
- 1. Presentación del módulo: el PR es un mensaje, no un trámite
- 2. Un cambio, una intención
- 3. El tamaño del PR decide la calidad de la revisión
- 4. Separar el refactor del cambio de comportamiento
- 5. Mensajes de commit que sirven dentro de un año
- 6. La descripción del PR: contexto, decisión, riesgo
- 7. Guiar al revisor por tu propio cambio
- 8. Proyecto: empaqueta y presenta un cambio
- 1. Presentación del módulo: qué se mira y en qué orden
- 2. Antes de comentar: entender qué se pidió
- 3. El orden de la revisión: intención, diseño, detalle
- 4. Qué comentar y qué dejar pasar
- 5. Bloqueo, sugerencia u opinión: márcalo
- 6. Revisar tests, no solo código
- 7. Revisar lo que no ves: seguridad, datos, casos borde
- 8. Proyecto: revisa un PR completo
- 1. Presentación del módulo: donde se rompen los equipos
- 2. Sobre el código, nunca sobre la persona
- 3. Defender una decisión sin defenderte tú
- 4. Cuando el revisor tiene razón
- 5. Cuando el revisor se equivoca
- 6. Desacuerdo sin bloqueo: discrepar y comprometerse
- 7. Revisiones entre niveles distintos
- 8. Proyecto: responde una revisión dura
- 1. Presentación del módulo: por qué se ignoran los estándares
- 2. Acordar en vez de imponer
- 3. Automatiza lo automatizable
- 4. La guía de estilo mínima viable
- 5. Checklists de revisión que no estorban
- 6. La definición de "listo" del equipo
- 7. Excepciones: cuándo se rompe el estándar
- 8. Proyecto: redacta el acuerdo de tu equipo
- 1. Presentación del módulo: el revisor sigue siendo humano
- 2. Qué cambia (y qué no) cuando el autor es un modelo
- 3. El código plausible que no funciona
- 4. Verificar en vez de confiar
- 5. Volumen: cuando llega más código del que se puede revisar
- 6. Autoría y responsabilidad de lo que subes
- 7. Usar IA para revisar (y sus límites)
- 8. Proyecto: revisa un PR generado por IA
- 1. Presentación del módulo: las dos sillas en un mismo día
- 2. Del código propio al cambio propuesto
- 3. Recibir, discutir y cerrar
- 4. Revisar bien bajo presión de tiempo
- 5. Qué hacer cuando la revisión no llega
- 6. Medir si la cultura de revisión está sana
- 7. Cómo se arregla una cultura rota
- 8. Proyecto final: el ciclo completo en Cardumen
Dudas frecuentes
Lo que suele preguntarse
Sin límite. Es una guía gratuita: entras cuando quieras, las veces que quieras.
No. Los módulos están ordenados de menos a más, pero puedes saltar al que necesites. Tu progreso se guarda por lección.
Lo que haga falta está en «Qué necesitas traer», arriba. Si no aparece nada ahí, puedes empezar desde cero.
En el grupo de WhatsApp del Club, y cada quince días hay un live con un instructor donde se resuelven dudas en vivo.
Sí. Al terminar todas las lecciones se emite automáticamente, con un código verificable que puedes compartir en LinkedIn.
Empieza cuando quieras
Lo que dicen los estudiantes
Estas reseñas son de estudiantes inscritos que completaron al menos el 50% del curso. Moderamos las reseñas solo por motivos de contenido (spam, lenguaje ofensivo, datos personales), nunca por ser críticas o negativas.
Aún no hay reseñas aprobadas.
¡Sé el primero en compartir tu experiencia!