Enmarca un pull request para que los revisores entiendan el perfil de riesgo, qué ha sido probado y dónde enfocar su atención limitada. Esto produce revisiones más rápidas y útiles porque los revisores pasan menos tiempo reconstruyendo contexto y más tiempo evaluando los cambios reales.
Casos de uso
- Entregando una funcionalidad completada y queriendo que el revisor priorice la nueva lógica sobre cambios de boilerplate
- Finalizando un refactor grande donde el diff es grande pero el cambio de comportamiento es mínimo
- Enviando un cambio sensible a seguridad que necesita una revisión de seguridad enfocada en lugar de una revisión general
- Abriendo un PR donde el enfoque de implementación fue no convencional y se necesita explicación para evitar confusión
- Solicitando re-revisión después de abordar feedback y queriendo que los revisores se enfoquen en qué cambió, no en re-auditar el diff completo
Funciones principales
- Encoge la narrativa del PR a lo esencial: qué cambió, por qué cambió y qué debe evaluar el revisor más cuidadosamente
- Señala áreas de alto riesgo explícitamente: condiciones de carrera, código sensible a seguridad, paths sensibles a rendimiento y describe cómo los probaste
- Vincula a cualquier discusión de diseño preexistente, registros de decisiones arquitectónicas o PRs relacionados que proporcionen contexto
- Mantén el diff pequeño extrayendo refactors o cambios de formato en PRs separados sin cambios de lógica
- Itera sobre feedback de revisores usando commits discretos y rastreables que faciliten a los revisores verificar qué cambió
Relacionados
Relacionados
3 Entradas indexadas
Receiving code review
Estructura cómo respondes al feedback de revisión de código para que el proceso de revisión se mantenga enfocado, respetuoso y productivo. Esta habilidad separa feedback sustantivo de-nitpicks, rastrea seguimientos sin perderlos y produce un registro que hace los merges más rápidos y los post-mortems más claros.
AI product requirement writing
Escribe documentos de requisitos de producto que agentes de IA pueden actuar fiablemente, con restricciones explícitas, casos edge y criterios de aceptación que minimizan la brecha entre lo que quieres y lo que el agente construye. Esta habilidad cierra la ambigüedad de specs de producto en lenguaje natural y la precisión que los agentes de IA requieren para producir resultados consistentes.
Documentation from code
Extrae decisiones arquitectónicas, contratos de API y patrones de uso directamente del código para producir documentación precisa que se mantiene en sync con la implementación. Documentation-from-code trata el código como la fuente de verdad y genera prosa desde él en lugar de mantener documentación como un artefacto separado que diverge con el tiempo.