¿Cuáles son las estrategias monorepo vs polyrepo?

Question

Accepted Answer

**Monorepo** (un repositorio para múltiples proyectos/servicios) y **polyrepo** (un repositorio separado por proyecto) son dos estrategias para organizar código entre múltiples proyectos. Cada una tiene compromisos significativos que afectan la colaboración, herramientas y escalabilidad — comprenderlas informa decisiones arquitectónicas importantes.

## Por qué es importante

```text
Many projects/services/libraries in a SINGLE repository:
  ✓ SHARED code/libraries easy to use and refactor (one place, atomic changes)
  ✓ ATOMIC commits across projects (change an API and all its consumers together)
  ✓ Unified tooling, versioning, CI; consistent standards; easy cross-project visibility
  ✓ Simplified dependency management (one version of shared code)
  ✗ Repo can get HUGE (needs scaling tooling — sparse checkout, build caching)
  ✗ Needs sophisticated build/CI tooling (Nx, Turborepo, Bazel) to be efficient
  ✗ Broad access; CI must be smart (only build what changed)
→ Used by Google, Meta, etc. (with heavy tooling investment).
```

## Polyrepo — un repositorio por proyecto

```text
Each project/service/library in its OWN repository:
  ✓ Clear OWNERSHIP and boundaries; independent versioning/releases/CI
  ✓ Smaller, focused repos; granular access control; independent teams
  ✗ SHARED code is harder (publish/consume packages; version coordination)
  ✗ Cross-cutting changes span MANY repos (coordinate multiple PRs — painful)
  ✗ Potential inconsistency across repos (tooling, standards drift)
→ Common default; fits independent services/teams.
```

## Eligiendo

```text
MONOREPO → tightly-coupled projects, heavy code sharing, want atomic cross-project
  changes and unified tooling, willing to invest in scaling tooling
POLYREPO → independent projects/teams, clear boundaries, independent release cycles,
  simpler per-repo needs
→ No universal answer; depends on the org, coupling, scale, and tooling investment.
```

## Por qué es importante

Comprender las estrategias monorepo vs polyrepo es conocimiento valioso de nivel senior para **tomar decisiones arquitectónicas sólidas sobre la organización del código**, una elección significativa con implicaciones amplias, por lo que es útil para roles senior/arquitectónicos.

Los dos enfoques — **monorepo** (muchos proyectos en un repositorio) y **polyrepo** (un repositorio separado por proyecto) — representan filosofías organizacionales fundamentalmente diferentes con compromisos reales. Las ventajas de **monorepo** (código compartido fácil y refactorización, **commits atómicos entre proyectos** — cambiar una API y todos sus consumidores juntos, herramientas unificadas y estándares, gestión simplificada de dependencias) lo hacen poderoso para proyectos fuertemente acoplados con mucho compartir de código, pero requiere una inversión significativa en **herramientas de escalado** (Nx, Turborepo, Bazel, sparse checkout, CI inteligente) para manejar el repositorio grande eficientemente. Las ventajas de **polyrepo** (propiedad clara y límites, ciclos de versionado y lanzamiento independientes, repositorios pequeños y enfocados, acceso granular) se adaptan a proyectos independientes y equipos, pero hacen que **el código compartido sea más difícil** (publicar/consumir paquetes, coordinación de versiones) y **cambios transversales sean dolorosos** (coordinar PRs entre muchos repositorios).

Comprender estos compromisos y cómo **elegir** (monorepo para proyectos fuertemente acoplados con mucho compartir de código dispuestos a invertir en herramientas; polyrepo para proyectos independientes y equipos con límites claros) refleja el criterio arquitectónico esperado en niveles senior — reconociendo que no hay una respuesta universal y la elección correcta depende del acoplamiento, escala, estructura del equipo e inversión en herramientas.

Ya que la organización del código entre múltiples proyectos es una decisión arquitectónica significativa que afecta la colaboración, herramientas, escalabilidad y autonomía del equipo, y ya que comprender los compromisos monorepo/polyrepo informa esta elección consecuencial, comprender las estrategias monorepo vs polyrepo es conocimiento valioso de nivel senior para la toma de decisiones arquitectónicas, un tema frecuentemente debatido donde comprender los compromisos (en lugar de favorecer dogmáticamente uno) refleja el criterio maduro esperado para roles senior que moldean cómo una organización estructura su código.