Del commit al deploy: entiende el lenguaje de los equipos de desarrollo
Git, commits, branches, pull requests, CI/CD, deploy, release y más: una guía práctica para entender el vocabulario del desarrollo en equipo.
Las voces dependen del navegador y del dispositivo; algunas necesitan conexión a internet. Los bloques de código no se leen en voz alta.
Entras en la conversación del equipo y alguien suelta:
«Crea una branch, haz los commits, sube un PR y avísame para el review. Si pasa el pipeline, hacemos el merge y programamos el deploy a producción».
Parece que el desarrollo de software venía con un paquete de idioma que alguien olvidó instalar.
Incluso quienes ya programan pueden sentirse perdidos con este vocabulario cuando empiezan a trabajar con otras personas. Y la dificultad va más allá del inglés: muchas palabras representan etapas diferentes, aunque aparezcan juntas en la misma frase. Guardar un archivo, hacer commit, hacer push, aprobar un PR y realizar un deploy son acciones distintas.
Este artículo reúne los términos más habituales de Git, revisión de código, automatización, publicación y organización del trabajo. La idea es explicar qué significa cada palabra y qué espera el equipo que ocurra cuando alguien la utiliza.
Ningún diccionario puede abarcar todos los equipos y herramientas. Los nombres y los acuerdos varían. Usa esta guía como referencia y, al incorporarte a un proyecto, consulta también sus instrucciones para contribuir.
1. Git, GitHub y repositorio: dónde empieza el trabajo
Git es un sistema de control de versiones distribuido. Registra la evolución de los archivos y permite trabajar con diferentes líneas de desarrollo. Operaciones como consultar el historial y crear commits pueden realizarse localmente, sin conexión con un servidor. La introducción oficial de Git explica este modelo.
El versionado, o control de versiones, consiste en llevar un seguimiento organizado de los cambios. Ayuda a descubrir qué se modificó, comparar estados y recuperar versiones anteriores.
GitHub, GitLab y Bitbucket son plataformas que alojan repositorios Git y añaden colaboración, permisos, revisiones y automatizaciones. Git es la herramienta de control de versiones; la plataforma ofrece servicios a su alrededor.
| Término | Significado en el trabajo |
|---|---|
| Repositorio / repository / repo | El conjunto de datos versionados y su historial. En una copia local habitual, los datos de Git se guardan en el directorio .git. |
| Local | Lo que está en el entorno donde trabajas, a menudo tu computadora. |
| Remoto / remote | Otro repositorio con el que el tuyo intercambia datos. Suele estar en un servidor, pero también puede encontrarse en otra ruta local. |
| Clone | Crear una copia local de un repositorio existente, con su historial y la configuración de acceso al origen; algunas opciones especiales pueden limitar el historial descargado. |
| Fork | Un repositorio separado, relacionado con el original mediante la plataforma. Es habitual para contribuir sin permisos de escritura en el proyecto de origen. |
| Upstream repository | El proyecto de origen respecto de un fork. La palabra upstream también aparecerá con otro significado en Git. |
Puedes hacer un fork en GitHub y después clonar ese fork en tu computadora. También puedes clonar directamente un repositorio del equipo. Fork y clone resuelven necesidades diferentes. Consulta las referencias de clone y forks en GitHub.
Hay tres archivos a los que conviene prestar atención al llegar: el README presenta el proyecto; CONTRIBUTING explica cómo contribuir, cuando existe; y .gitignore define patrones de archivos sin seguimiento que Git debe ignorar.
El archivo .gitignore no elimina archivos del historial ni hace que Git deje de seguir automáticamente lo que ya se versionó. Esta distinción aparece en la documentación del propio Git. Añadir .env a ese archivo después de publicar una contraseña no revierte la exposición.
2. Del archivo editado al commit: las etapas locales
Imagina que debes corregir un exportador de CSV. Abres el archivo, cambias una función y guardas. El archivo cambió en el disco, pero todavía falta registrar esa modificación en el historial.
| Término | Qué significa |
|---|---|
| Working tree / working directory | El árbol de archivos en el que estás trabajando. |
| Tracked | Archivo que Git ya sigue. |
| Untracked | Archivo del que Git todavía no hace seguimiento. |
| Modified | Archivo con seguimiento que contiene cambios respecto del estado utilizado para la comparación. |
| Staging area / index | Área de preparación del contenido que entrará en el próximo commit. |
| Stage / staged | Preparar un cambio, o indicar que ya está en esa área. |
| Commit | Un registro de un estado del proyecto, vinculado al historial y acompañado de metadatos y un mensaje. |
| Hash / commit ID / SHA | El identificador utilizado para hacer referencia a un commit, que suele mostrarse abreviado. |
git add coloca contenido en el área de preparación. También sirve para cambios en archivos que ya existen. git commit registra el contenido preparado. Si ejecutas add, vuelves a editar el mismo archivo y después haces commit, la edición posterior no se incluirá automáticamente: también tendrás que prepararla. La documentación sobre el registro de cambios muestra esta separación.
Un commit es un registro local. Por sí solo no envía nada a GitHub, GitLab ni a producción. Piensa en una secuencia de registros que podrás compartir después.
Un buen commit message explica el cambio. Compara ajustes con fix: corrige exportação de nomes com acento. El segundo facilita la vida de quien necesite entender el historial, incluido tú dentro de tres meses.
Al investigar también aparecen otros términos:
- Status: estado actual de los archivos y de la branch;
git statuses una buena primera consulta. - Diff: comparación entre estados.
git diffnormalmente muestra cambios que todavía no están preparados;git diff --stagedmuestra lo preparado respecto del último commit. - Hunk: un fragmento de cambios dentro de un diff. Es posible preparar solo partes de un archivo.
- Log: historial de commits, que se consulta con
git log. - Blame: indicación del commit que modificó por última vez cada línea en el contexto consultado. Sirve para buscar contexto; su nombre no convierte la herramienta en un tribunal.
Las referencias de diff y blame detallan estas consultas.
3. Branch, main y HEAD: ¿en qué línea estás trabajando?
Una branch, o rama, es una línea de desarrollo identificada por un nombre. Técnicamente, ese nombre apunta a un commit y avanza a medida que registras nuevos commits en esa línea. Crear una branch no requiere duplicar manualmente la carpeta del proyecto.
Una feature branch concentra el trabajo de una funcionalidad; una rama de corrección puede tener un nombre como fix/exportacao-csv. Estos prefijos son convenciones del proyecto, no reglas obligatorias de Git.
main es un nombre habitual para la rama principal. También encontrarás master, develop y otros nombres. Git no atribuye poderes especiales a la palabra main, y una rama principal no necesariamente corresponde a lo que está en producción.
Checkout significa seleccionar un estado para trabajar. El comando git checkout reúne más de una función; git switch ofrece una forma específica de cambiar de rama o crear ramas.
HEAD indica el punto actual de trabajo. Normalmente apunta a la rama seleccionada. En detached HEAD, apunta directamente a un commit, sin estar asociado a una rama local. Esto resulta útil para inspeccionar estados; si quieres conservar nuevos commits creados allí, crea una rama desde la que se puedan alcanzar.
Estos conceptos se tratan en las referencias de ramas, switch y checkout.
| Nombre o expresión | Interpretación |
|---|---|
origin |
Nombre convencional que se asigna al remoto al clonar. Puede cambiarse. |
origin/main |
Referencia local que sigue el estado conocido de la rama main de ese remoto. No es una consulta al servidor en tiempo real. |
| Tracking branch | Rama local configurada para seguir otra rama. |
| Upstream branch | Rama o referencia seguida por la rama local, utilizada en comparaciones y operaciones como pull. |
| Ahead / behind | Cuántos commits tiene tu rama de más o de menos respecto de la referencia comparada. |
| Diverged | Ambos lados tienen commits propios; ninguno es simplemente una continuación directa del otro. |
Fíjate en la ambigüedad: upstream puede ser la rama que se sigue o un nombre elegido para el remoto del proyecto original. El capítulo sobre ramas remotas ayuda a distinguir ambos usos.
4. Fetch, pull y push: cómo se comunican las copias
Estas tres palabras aparecen tanto que merece la pena distinguirlas con cuidado.
| Operación | Qué hace | Ejemplo de intención |
|---|---|---|
| Fetch | Obtiene objetos y actualiza referencias según la configuración, sin integrar automáticamente el resultado en la rama en la que trabajas. | «Quiero comprobar qué llegó al remoto». |
| Pull | Obtiene actualizaciones e intenta integrarlas en la rama actual, según las opciones y la configuración. | «Quiero incorporar las novedades a mi línea de trabajo». |
| Push | Envía los objetos necesarios y solicita la actualización de referencias en el otro repositorio. | «Quiero poner mis commits a disposición de los demás en el remoto». |
Un pull puede implicar fast-forward, merge o rebase, según la modalidad elegida. Tratar pull como sinónimo obligatorio de merge oculta una diferencia que afecta al historial. Consulta las referencias de fetch, pull y push.
Un push no envía las ediciones que siguen sueltas en tu editor. Primero deben formar parte de commits alcanzables desde las referencias enviadas. Además, un push solo provoca un deploy si existe una automatización configurada para hacerlo.
Un push rechazado puede indicar que la rama remota avanzó, que existen reglas de protección o que faltan permisos. El mensaje explica el motivo; no conviertas --force en una respuesta automática.
Force push permite ciertas actualizaciones que reescriben la historia alcanzable desde una referencia remota. --force-with-lease añade una comprobación del estado esperado, pero sigue siendo una operación que exige entender el historial y los acuerdos del equipo.
5. Merge, rebase, squash y conflicto: cómo se encuentran los cambios
Corriges el CSV mientras otra persona modifica la misma zona. Tarde o temprano, esas líneas de trabajo deben encontrarse.
Merge integra historiales. Según la relación entre ellos y las opciones utilizadas, puede crear un merge commit, que registra la unión con más de un padre.
Si la rama de destino solo está por detrás de la otra, puede producirse un fast-forward: el puntero avanza hasta el commit más reciente, sin necesidad de crear un commit de unión. Esta posibilidad aparece en la documentación de merge.
Un merge conflict, o conflicto de fusión, surge cuando Git no puede resolver una combinación automáticamente. Puede afectar a líneas, eliminaciones, cambios de nombre o archivos binarios. Resolver un conflicto exige elegir el resultado correcto para el sistema y probar su comportamiento. Eliminar los marcadores del conflicto es solo una parte del trabajo.
Rebase vuelve a aplicar commits sobre otra base y puede producir un historial lineal. Como los commits reaplicados adquieren otro contexto, normalmente reciben nuevos identificadores. También puede generar conflictos. Reescribir commits ya compartidos exige coordinación, porque otras personas pueden haber construido trabajo sobre ellos. La documentación de rebase explica las consecuencias.
Squash combina cambios de varios commits en un resultado que podrá registrarse como un commit. En las plataformas, squash and merge suele condensar un PR en un commit en la rama de destino. Obtienes una unidad de historial más compacta y dejas de conservar allí la secuencia original de commits. GitHub documenta las estrategias de integración.
Cherry-pick vuelve a aplicar el cambio de un commit elegido sobre otra línea, normalmente creando un nuevo commit. Resulta útil, por ejemplo, para llevar una corrección específica a una versión del producto que se sigue manteniendo. También puede producir conflictos y requiere comprobar si esa corrección necesita otros cambios. Consulta la referencia de cherry-pick.
Backport es precisamente la adaptación de un cambio a una versión o línea más antigua. Un cherry-pick puede formar parte de ese proceso, pero no todo backport se reduce a copiar un commit.
Ninguna de estas estrategias garantiza por sí sola un historial «correcto». La elección depende del proyecto, de lo que ya se compartió y de cómo desea el equipo investigar los cambios más adelante.
6. Stash, restore, reset y revert: cuatro ideas diferentes
Cuando alguien diga «deshaz esto», pregunta qué debe deshacerse: ¿una edición local, la preparación de un archivo, un commit o el comportamiento en producción?
| Término | Uso principal | Precaución |
|---|---|---|
| Stash | Guardar temporalmente cambios locales para retomarlos después. | Por defecto, no incluye archivos sin seguimiento; las opciones modifican este comportamiento. No sustituye el intercambio de commits. |
| Restore | Restaurar contenido de archivos en el árbol de trabajo o en el index, según las opciones. | Puede descartar ediciones locales. |
| Reset | Cambiar referencias y/o el contenido del index y del árbol de trabajo, según la modalidad utilizada. | Modos como --hard pueden descartar trabajo. |
| Revert | Crear un nuevo commit que aplique la inversa de los cambios de otro commit. | Conserva el registro histórico, pero puede exigir resolver conflictos. |
| Amend | Rehacer el commit más reciente con otro contenido o mensaje. | Sustituye su identidad; si ya se compartió, coordina el cambio. |
| Reflog | Registro local de los movimientos de referencias, útil para localizar estados anteriores. | Su retención y alcance son limitados; no garantiza recuperar cualquier archivo. |
Las referencias de stash, restore, reset, revert, commit y reflog son buenas consultas antes de una operación de recuperación.
Un revert cambia el código mediante otro commit. Un rollback de deploy, que veremos más adelante, cambia la versión en ejecución. Una acción no implica automáticamente la otra.
7. PR, MR y code review: la conversación antes de integrar
Un pull request (PR) es una propuesta de integración con contexto, comparación de cambios y espacio para la revisión. Merge request (MR) es el nombre que utiliza GitLab para este tipo de colaboración. Es una función de la plataforma; no existe un comando universal git pull-request en Git básico.
Pull y pull request no son lo mismo. El primero es una operación de Git. El segundo organiza una propuesta de cambio.
Un PR suele comparar la base / target branch, que recibirá los cambios, con la head / source branch, que los aporta. Comprueba la dirección antes de abrir la solicitud. Las documentaciones de PR de GitHub y MR de GitLab describen estas funciones.
| Expresión | Qué quiere decir el equipo |
|---|---|
| Code review / review | Revisión de los cambios: comportamiento, claridad, pruebas, riesgos y adecuación al proyecto. |
| Reviewer | Persona invitada a revisar. |
| Assignee | Persona asignada a la tarea o solicitud; el significado exacto depende del equipo. |
| Draft / WIP | Borrador o work in progress: trabajo en curso, que puede recibir comentarios antes de estar listo. |
| Approve / approval | Aprobación registrada durante la revisión. |
| Request changes | Solicitud de ajustes. |
| Comment / thread | Comentario o hilo de conversación, a menudo vinculado a un fragmento del diff. |
| Resolve conversation | Marcar una conversación como resuelta; esto no demuestra por sí solo que el problema se haya corregido. |
| LGTM | Looks good to me: «me parece bien». Puede ser un comentario informal y no sustituir la aprobación exigida. |
| Nit / nitpick | Observación pequeña de estilo o detalle. Conviene indicar si impide la integración. |
| Blocking / non-blocking | Comentario que debe atenderse antes de continuar, o sugerencia que no bloquea. |
Los checks son verificaciones asociadas al cambio. Los required checks son los exigidos por las reglas del proyecto. Branch protection y rulesets pueden exigir revisiones, verificaciones y otras condiciones. CODEOWNERS vincula áreas del repositorio con responsables y puede formar parte de esos requisitos.
Una aprobación no garantiza que el botón de merge esté habilitado: pueden faltar verificaciones u otras condiciones. Las referencias de reviews y ramas protegidas explican estas relaciones.
8. Build, pipeline y CI/CD: el trabajo automatizado
DevOps reúne prácticas y una cultura de colaboración entre desarrollo y operaciones, con automatización y retroalimentación para entregar y mantener el software. La introducción de AWS a DevOps explica este acercamiento.
Después del push o de abrir el PR, empiezan a aparecer verificaciones. Oyes que «falló el build» o que «el pipeline está en verde».
Build es el proceso de preparar el software para su uso o distribución. Puede compilar, transformar archivos, resolver recursos y empaquetar resultados. Incluso una aplicación escrita en un lenguaje interpretado puede tener una etapa de build.
Un artifact, o artefacto, es una salida producida por el proceso: un paquete, un ejecutable, archivos de una aplicación web o un informe. La documentación de artefactos de GitHub Actions ofrece ejemplos.
| Término | Significado |
|---|---|
| Pipeline | Conjunto organizado de tareas automatizadas, con sus dependencias y condiciones. Puede tener partes que se ejecuten en paralelo. |
| Workflow | Flujo de trabajo; en herramientas como GitHub Actions, también es el nombre de una automatización configurada. |
| Trigger / event | Evento que inicia la ejecución, como un push, un PR, una hora programada o una activación manual. |
| Job | Unidad de trabajo de la automatización. |
| Step | Paso dentro de un job, como ejecutar un comando. |
| Runner / agent | Entorno o proceso que ejecuta los jobs. |
| Cache | Datos reutilizados para acelerar las ejecuciones. Su finalidad es diferente de la de un artefacto de entrega. |
| Green / passed | Las verificaciones consideradas en esa ejecución pasaron. |
| Red / failed | Falló al menos una verificación relevante. |
Las herramientas utilizan estos nombres con ciertas diferencias. La introducción a GitHub Actions muestra la relación entre eventos, workflows, jobs, steps y runners.
CI — continuous integration, o integración continua: práctica de integrar cambios con frecuencia y verificar el resultado, normalmente con un build y pruebas automatizadas. Tener un servidor de CI ayuda; mantener ramas aisladas durante meses sigue creando dificultades de integración.
Continuous delivery — entrega continua: mantener el software en condiciones de entregarse mediante un proceso confiable. El paso a producción puede depender de una decisión o aprobación.
Continuous deployment — despliegue continuo: los cambios que superan las verificaciones pasan automáticamente a producción, sin una aprobación manual para cada modificación.
La sigla CD puede referirse a los dos últimos conceptos. Averigua cuál utiliza el equipo. La referencia de CI/CD de AWS explica esta distinción.
Un pipeline en verde indica que esas verificaciones pasaron, en esas condiciones. Puede faltar una prueba importante, una validación de negocio o una dependencia que solo aparece en otro entorno.
9. Pruebas y calidad: ¿qué se verificó exactamente?
| Término | Traducción al trabajo cotidiano |
|---|---|
| Lint / linter | Análisis de patrones, problemas y reglas en el código, generalmente sin ejecutar el programa completo. |
| Formatter | Herramienta que aplica un formato consistente. |
| Static analysis | Análisis del código sin ejecutar su comportamiento normal; puede buscar problemas de tipos, flujo o seguridad. |
| Unit test | Prueba de una unidad pequeña de comportamiento. |
| Integration test | Verificación de la interacción entre componentes. |
| E2E / end-to-end | Prueba de un flujo de extremo a extremo, como iniciar sesión y completar una exportación. |
| Smoke test | Conjunto pequeño de verificaciones esenciales para identificar rápidamente fallas graves. |
| Regression test | Prueba que ayuda a detectar la reaparición de un problema o la ruptura de un comportamiento que funcionaba. |
| Coverage | Medida de cuánto código se ejecutó durante las pruebas según un criterio. Por sí sola no mide la calidad de las pruebas. |
| Flaky test | Prueba que alterna entre pasar y fallar sin un cambio intencional relevante, a menudo por cuestiones de tiempo, estado o dependencias. |
| Mock / stub | Sustitutos de dependencias en las pruebas; pueden simular respuestas o permitir verificar interacciones. La distinción exacta depende de la herramienta. |
| QA — quality assurance | Prácticas de aseguramiento de la calidad; en algunos equipos también designa una función profesional. |
Las documentaciones de pytest sobre pruebas inestables, de Playwright sobre buenas prácticas y de coverage.py ayudan a profundizar en estos temas.
En el ejemplo del CSV, comprobar que la pantalla se abre no demuestra que un nombre con acentos se exportará correctamente. La prueba debe observar el comportamiento que pretendes garantizar.
10. Entorno, deploy y release: llegar al usuario
Un environment, o entorno, es una combinación de aplicación, configuración, infraestructura y datos destinada a una finalidad determinada.
| Entorno | Finalidad habitual |
|---|---|
| Local | Desarrollo en el entorno individual. |
| Development / dev | Desarrollo e integración; puede ser compartido. |
| Test / testing | Ejecución de verificaciones. |
| Staging / homologación / pre-production | Validación previa a producción, buscando condiciones relevantes similares. Los nombres y las diferencias varían. |
| Production / prod / producción | Entorno que atiende el uso real del producto. |
| Preview environment | Entorno temporal para probar un cambio, a menudo vinculado a un PR. |
| Sandbox | Entorno destinado a experimentación o aislamiento; el nombre no garantiza aislamiento ni ausencia de datos reales. |
Staging environment y staging area de Git son cosas diferentes. Uno es un entorno de la aplicación; el otro prepara contenido para un commit. La documentación de entornos de GitLab muestra cómo las plataformas organizan los destinos de despliegue.
Deploy / deployment significa desplegar una versión o un cambio en un entorno. Puede hacerse en homologación, producción u otro destino. «Hice el deploy» resulta más claro cuando informas de qué versión y en qué entorno.
Release puede designar una versión del producto puesta a disposición del público o el acto de publicarla. En las plataformas de repositorios, también puede ser un registro con notas y archivos asociado a una versión. Consulta la documentación de releases en GitHub.
Una feature flag / feature toggle es un control que permite variar el comportamiento o la disponibilidad de una funcionalidad. Puedes desplegar un recurso desactivado y habilitarlo después para un público determinado. Por eso, el deploy y la habilitación para el usuario pueden suceder en momentos diferentes, como explica la introducción de OpenFeature.
Otras palabras habituales en esta etapa:
- Rollout: proceso de distribuir o activar un cambio, a veces de forma gradual.
- Rollback: retorno a una versión o configuración anterior para contener un problema. Revertir el código no deshace automáticamente los cambios en los datos.
- Hotfix: corrección urgente, a menudo motivada por un problema en producción. La urgencia cambia la prioridad; el equipo todavía debe verificar lo que va a entregar.
- Migration: cambio versionado en la estructura de la base de datos o transformación de datos. Su plan de reversión debe considerar los efectos y la compatibilidad.
- Health check: verificación del estado de una aplicación o componente.
- Blue-green: estrategia con dos entornos de referencia y cambio del tráfico entre ellos.
- Canary: disponibilidad inicial para una parte del tráfico o de los usuarios, con observación antes de ampliarla.
- Rolling update: sustitución gradual de las instancias de la aplicación.
Las estrategias de despliegue de AWS y la documentación de Deployments de Kubernetes detallan formas de distribución y reversión.
Después del deploy entran en juego los logs, registros de eventos; las metrics, medidas como la tasa de errores; y los traces, trazas de una solicitud a través de los componentes. Son señales utilizadas en observabilidad para entender el comportamiento del sistema. OpenTelemetry describe estas señales.
Un incident, o incidente, es una situación que perjudica el servicio y exige una respuesta. On-call es el sistema de guardias de las personas responsables de atender las incidencias. Postmortem es el registro posterior del incidente, de sus factores y de las acciones de mejora. El enfoque útil consiste en aprender y reducir su recurrencia, como propone la referencia de postmortems de Google SRE.
11. Tag, versión y changelog: cómo identificar una entrega
Una tag, o etiqueta, es una referencia con nombre, utilizada a menudo para marcar un punto del historial, como v1.4.2. Una tag no significa que se haya realizado un deploy. La documentación de tags de Git presenta sus tipos y usos.
Un changelog registra los cambios entre versiones. Las release notes suelen explicar una entrega a su público, incluyendo novedades, correcciones, limitaciones e instrucciones relevantes.
SemVer, o versionado semántico, utiliza MAJOR.MINOR.PATCH. En un proyecto que sigue la especificación SemVer, con una API pública definida y estable:
- MAJOR: cambio incompatible en la API pública.
- MINOR: funcionalidad añadida de forma compatible.
- PATCH: corrección compatible.
Por tanto, 1.4.2 no significa simplemente «cambio grande, mediano y pequeño». El criterio es la compatibilidad. Las versiones 0.x tienen un tratamiento de desarrollo inicial, y no todos los proyectos adoptan SemVer.
Un breaking change es un cambio que rompe una compatibilidad esperada. Deprecated indica que un recurso dejó de recomendarse y puede tener una alternativa o una eliminación prevista; puede seguir funcionando. Backward compatibility, o compatibilidad con versiones anteriores, es la capacidad de preservar el uso esperado por consumidores anteriores.
También verás alpha, beta y RC — release candidate, que identifican etapas previas al lanzamiento. El grado de estabilidad depende de la política del proyecto.
Conventional Commits es una convención para mensajes, como feat: adiciona filtro por cidade y fix: corrige exportação CSV. feat comunica una funcionalidad; fix, una corrección. Los equipos también usan docs, test, refactor, chore, build y ci, según sus reglas. ! o el pie de mensaje BREAKING CHANGE señalan incompatibilidad. La especificación no convierte todos esos tipos adicionales en obligatorios.
Refactor / refactorización significa reorganizar la estructura interna preservando el comportamiento observable previsto. Technical debt / deuda técnica es el costo futuro de decisiones y asuntos técnicos pendientes que dificultan la evolución. No todo cambio de estructura resuelve deuda; explica qué dificultad se reducirá.
12. Issue, sprint y daily: organizar el trabajo del equipo
El código empieza antes del primer comando de Git: alguien tiene que entender el problema y acordar qué se entregará.
| Término | Significado habitual |
|---|---|
| Issue / ticket / card | Registro de una solicitud, un problema o una conversación en una herramienta de seguimiento. |
| Bug | Defecto o comportamiento incorrecto respecto de lo esperado. |
| Feature | Funcionalidad o capacidad del producto. |
| Task | Tarea ejecutable. |
| User story | Descripción de una necesidad desde la perspectiva de quien utiliza el producto. |
| Epic | Agrupación más amplia de trabajo, generalmente dividida en elementos menores. |
| Backlog | Conjunto ordenado de trabajo conocido y posible para el producto o equipo. |
| Priority | Orden o urgencia de atención. |
| Severity | Gravedad del impacto de un problema. Un defecto grave y una solicitud prioritaria no son necesariamente lo mismo. |
| Acceptance criteria | Condiciones específicas para aceptar una entrega determinada. |
| Blocker / impedimento | Algo que impide avanzar. |
| Dependency | Trabajo, recurso o decisión de los que depende otro elemento. |
| Milestone | Hito utilizado para agrupar entregas u objetivos. |
| Roadmap | Visión de la dirección y de las iniciativas previstas, sujeta a revisión. |
Una issue útil sobre el CSV describe cómo reproducir el error, el resultado observado y el resultado esperado. «La exportación está mal» deja casi todo el trabajo de investigación a la siguiente persona. La introducción a las issues de GitHub ofrece orientaciones para completarlas.
En los equipos que utilizan Scrum, algunas palabras tienen definiciones propias:
| Término | Idea central |
|---|---|
| Sprint | Ciclo con una duración fija de hasta un mes. |
| Sprint planning | Planificación del objetivo y del trabajo del sprint. |
| Daily Scrum / daily | Reunión para inspeccionar el progreso hacia la meta del sprint y ajustar el plan; en Scrum dura 15 minutos. |
| Refinement / refinamiento | Actividad continua para detallar y ajustar elementos del backlog. |
| Sprint review | Inspección del resultado con las partes interesadas y conversación sobre las próximas adaptaciones. |
| Retrospective / retro | Reflexión sobre cómo mejorar la forma de trabajar. |
| Definition of Done / DoD | Definición compartida de las condiciones de calidad para considerar terminado el incremento. |
Estos significados provienen de la Guía Scrum. No todas las reuniones llamadas daily siguen Scrum, y utilizar Git no obliga a adoptar este marco de trabajo.
Los story points son una forma de estimación relativa adoptada por algunos equipos. No tienen una conversión universal a horas y no son un requisito de Scrum. Kanban es un enfoque de gestión del flujo; el tablero de tarjetas es una de sus representaciones. Un WIP limit limita la cantidad de trabajo en curso para ayudar al flujo. La orientación de Atlassian sobre estimaciones y la Kanban Guide profundizan en estos conceptos.
Otras expresiones útiles: pair programming es programación en pareja; handoff, transferencia de responsabilidad o contexto; onboarding, incorporación de alguien al proyecto; RFC — request for comments, propuesta estructurada para su discusión; ADR — architecture decision record, registro de una decisión de arquitectura y de su contexto. Una POC — proof of concept, o prueba de concepto, evalúa la viabilidad de una idea; un MVP — minimum viable product, o producto mínimo viable, es una versión mínima utilizable para poner a prueba una propuesta de valor. Los criterios deben acordarse.
Los nombres de los roles también varían. Un tech lead suele coordinar decisiones técnicas; el Product Owner responde por la gestión del Product Backlog en Scrum; un maintainer se ocupa de la continuidad y de las contribuciones a un proyecto. Tener un cargo específico no concede automáticamente permiso para aprobar o publicar: eso depende de los accesos y de las reglas locales.
13. Algunas palabras que aparecen al preparar el entorno
No necesitas memorizar toda la infraestructura para participar en tu primer PR. Pero estos términos suelen aparecer en las instrucciones para ejecutar el proyecto:
| Término | Qué buscar en el contexto |
|---|---|
| Stack | Conjunto de tecnologías utilizado en el sistema. |
| Frontend / backend | Capa de interacción y capas de procesamiento y servicios, según la arquitectura. |
| API / endpoint | Interfaz de comunicación y un punto específico de acceso a operaciones o recursos. |
| Dependency / package | Biblioteca, paquete o componente utilizado por el proyecto. |
| Package manager | Herramienta para instalar y administrar paquetes, como npm o Composer. |
| Lockfile | Archivo que registra las resoluciones de dependencias para hacer reproducibles las instalaciones dentro del ecosistema. |
| Script | Secuencia de comandos para una tarea, como probar o construir el proyecto. |
| Environment variable / env var | Valor proporcionado al proceso para configurar su comportamiento. |
| Secret | Dato sensible, como una contraseña, un token o una clave privada. Una variable de entorno puede contener un secret, pero no todas las variables son secretas. |
| Container | Entorno de ejecución aislado para procesos y sus dependencias. |
| Container image | Modelo empaquetado utilizado para crear contenedores. |
| Registry | Servicio que almacena y distribuye imágenes o paquetes, según el contexto. |
| Monorepo / multirepo | Organización de proyectos en un repositorio compartido o en varios repositorios. |
Las referencias de package-lock de npm, variables de entorno de Node.js y conceptos de contenedores de Docker ayudan a reconocer ejemplos concretos.
Si un secret se compartió indebidamente, borrar el archivo en el siguiente commit no basta. Revoca o rota la credencial y gestiona las copias y el historial según el incidente. La orientación de GitHub para datos sensibles empieza por esa necesidad.
14. Una tarea completa: ahora la conversación tiene sentido
Vamos a unirlo todo en un ejemplo ficticio: la exportación de CSV corrompe los nombres con acentos.
- El equipo registra una issue, con pasos para reproducir el bug y criterios de aceptación.
- Actualizas tu copia y creas la branch
fix/exportacao-csva partir de la base acordada. - Modificas el código, añades una prueba de regresión y consultas el diff.
- Preparas el contenido en la staging area y creas un commit con un mensaje claro.
- Haces push y abres un PR, vinculando la issue y explicando cómo verificaste la corrección.
- El pipeline de CI ejecuta las verificaciones configuradas. Una compañera hace code review.
- Atiendes los comentarios y resuelves los posibles conflictos. Las verificaciones vuelven a ejecutarse según la configuración.
- El PR se integra mediante merge, squash u otra estrategia adoptada por el proyecto.
- La versión sigue el proceso de entrega: build, deploy en homologación, validación y deploy a producción, cuando esas etapas forman parte del flujo.
- El equipo observa los logs y las métricas y comunica la release. Si surge un problema, evalúa una corrección, la desactivación mediante una flag o un rollback, teniendo también en cuenta los datos.
Cada equipo adapta este recorrido. Algunos automatizan casi todo; otros exigen aprobaciones. No todo merge provoca un deploy, ni todo deploy habilita una funcionalidad para todos.
Cómo aparece una parte de esto en el terminal
El siguiente ejemplo es didáctico. Presupone un repositorio ya clonado, un árbol de trabajo limpio, una rama main con seguimiento configurado y permiso de escritura en el remoto origin. Los archivos y la rama son ilustrativos. Si falla una etapa, lee el motivo antes de continuar.
git status
git switch main
git pull --ff-only
git switch -c fix/exportacao-csv
# Ahora editas el código y ejecutas las pruebas del proyecto.
git diff
git add src/exportador.js tests/exportador.test.js
git diff --staged
git commit -m "fix: corrige exportação de nomes com acento"
git push -u origin fix/exportacao-csv
La opción --ff-only solicita que la actualización avance sin crear una integración de historiales divergentes; si no es posible, el comando interrumpe esa actualización. La opción -u del push configura el seguimiento de la rama enviada. Ninguno de estos comandos abre un PR ni realiza un deploy por sí mismo.
Un traductor rápido de mensajes del equipo
| Lo que escuchaste | Lo que necesitas entender |
|---|---|
| «Ya hice el commit». | El cambio se registró en el historial local. Puede que todavía falte compartirlo. |
| «Ya subí la branch». | Probablemente se hizo push; confirma a qué remoto y rama. |
| «El PR está en draft». | La propuesta existe y sigue en preparación. |
| «Falló el pipeline». | Falló alguna verificación; consulta el job y sus logs. |
| «Falta un LGTM». | Falta una revisión favorable o una aprobación, según la regla del equipo. |
| «Ya está en main». | El cambio llegó a la rama principal. Eso no confirma que esté en producción. |
| «Está en homologación». | La versión está en el entorno de homologación. |
| «Ya hice el deploy». | Pregunta por la versión y el entorno si el mensaje no los indica. |
| «Vamos a hacer rollback». | El equipo pretende volver a un estado desplegado anteriormente; hay que identificar el alcance y los efectos. |
Entender el vocabulario ayuda a hacer mejores preguntas
No necesitas recitar este glosario para merecer formar parte de un equipo. Necesitas reconocer las etapas y poder explicar en qué punto está tu trabajo.
«Terminé» puede convertirse en: «El PR está listo para revisión, las pruebas pasaron y todavía falta validar en homologación». «Lo subí» puede convertirse en: «Envié la rama al remoto; el deploy todavía no se hizo».
Esa precisión evita expectativas diferentes sobre el mismo trabajo. Y, cuando alguien utilice un término desconocido, pregunta: «¿Qué significa exactamente eso en este proyecto?». La respuesta suele ser más útil que fingir que entendiste.
Referencias consultadas en la documentación oficial de Git, GitHub, GitLab y de las demás herramientas y especificaciones citadas, el 7 de noviembre de 2026. Los ejemplos de tareas, mensajes y comandos son didácticos; los nombres, permisos y procesos varían entre proyectos.