Prácticas recomendadas para el equipo

Un resumen condensado de las 25 prácticas de equipo más importantes que mantienen a un equipo de ingeniería de Python rápido, alineado y amable, extraído de cada página de esta sección.

1. El tiempo hasta el primer PR es la métrica: Objetivo de PR pequeño fusionado para el quinto día - mide la incorporación y la salud de las herramientas (Lista de verificación de incorporación de desarrolladores).

2. Un documento de incorporación canónico: Enlazado desde README con propietario nombrado y fecha de última revisión.

3. Compañero para la primera semana: Compañero nombrado, registro diario de 15 minutos - no "pregúntale al equipo".

4. La configuración del entorno está en scripts: uv sync, pytest, /health documentado en Lista de verificación de configuración del entorno.

5. Los comandos de CI se ejecutan localmente: El mismo ruff/pytest/mypy que GitHub Actions antes de enviar.

6. .env.example siempre actualizado: Cada nuevo campo de configuración actualiza el ejemplo sin secretos.

7. CODEOWNERS en rutas sensibles: Migraciones, autenticación, pagos solicitan automáticamente a expertos.

8. ADR para decisiones no obvias: Estrategia de framework, esquema y flags registrada en docs/adr/.

9. Rastrear una solicitud en la primera semana: Más rápido que leer el árbol completo (Orientación de la base de código).

10. Convenciones en la configuración de ruff: Los debates de estilo terminan en pyproject.toml, no en comentarios de revisión (Guía de convenciones y estilo).

11. ID de ticket en cada commit: Los cherry-picks y la automatización del registro de cambios dependen de ello.

12. Plantilla de descripción de PR: Nota de migración, plan de pruebas, reversión - campos requeridos.

13. Revisar pruebas antes de la implementación: Los revisores validan el cambio de comportamiento a través de aserciones.

14. Comentarios de revisión específicos y amables: Preguntas y sugerencias, no "simplemente arréglalo" sin contexto (Guía de revisión de código).

15. Aprobar cuando se cumple el estándar: No bloquear por preferencia cuando CI está en verde y P0/P1 satisfechos.

16. PR pequeños por defecto: Dividir cuando la diferencia es > ~400 líneas o preocupaciones mixtas.

17. Los traslados internos reciben incorporación: Senior a nuevo subsistema todavía necesita acceso y recorrido de arquitectura.

18. Se celebran los PR de documentación de los nuevos empleados: El primer PR que corrige un error tipográfico en la incorporación es una señal de éxito.

19. Actualizaciones de documentación post-incidente: Cada sev2+ actualiza el runbook o un elemento de la lista de verificación.

20. Retrospectivas sin culpa: Enfocarse en los sistemas - actualizar listas de verificación, no individuos.

21. Objetivos compartidos de shell/Makefile: make test, make lint documentados para todos los repos.

22. Sin heroicidades en el despliegue: Seguir la lista de verificación; informar sobre la falta de proceso si se necesita un atajo.

23. Rotar la guardia con un observador: Los nuevos empleados observan antes de estar de guardia solos.

24. Higiene trimestral de dependencias: Elementos de sprint programados para CVE y actualizaciones menores de Python.

25. Normas del equipo por escrito: Las reglas no escritas se convierten en control de acceso - publicar y revisar abiertamente.

Preguntas frecuentes

Relacionado

• Prácticas recomendadas de liderazgo técnico - prácticas de liderazgo
• Prácticas recomendadas de Git - control de versiones
• Prácticas recomendadas de la CLI de Linux - flujo de trabajo del operador
• Mentoría y Nivelación - crecimiento

Versiones de la pila: Esta página se escribió para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.