liveBook · Manning

Meta-repository

As explained in Vibe Engineering

The meta-repository pattern maintains a dedicated repository of cross-repository dependency, communication, convention, and decision knowledge for agents.

A meta-repository gives agents a machine-readable map of a multi-repository system before they enter individual codebases. It records dependencies, service communication, cross-service conventions, and the decisions that explain current boundaries. section 10.1.1

Use it to reduce context fragmentation without forcing an immediate topology change:

  • Document which services depend on one another and which protocols connect them. section 10.1.1
  • Capture conventions such as message queues instead of direct HTTP, alongside the ADRs that justify them. section 10.1.1
  • Let agents read the meta-repository first, then migrate only tightly coupled services when the evidence supports consolidation. section 10.1.1

Incremental adoption

A fourteen-repository system can begin with a meta-repository, then move its payment, invoice, and shared-auth services into a monorepo over time while leaving the remaining repositories connected through the shared map. section 10.1.1

Figure 10.2 Meta-Repository Pattern.

Use the figure to inspect how the meta-repository connects repositories, dependencies, conventions, and decision records. section 10.1.1

How Vibe Engineering covers it

How deep it goes
Defines repository contents and an incremental migration path, but does not specify a complete implementation.
Examples
Uses a fourteen-repository landscape and staged consolidation of payment, invoice, and shared-auth services.
What it assumes
Assumes multiple repositories and service relationships, while teaching how to make those relationships machine-readable.
What you can do after
Operate agents across repositories with documented dependencies, communication rules, conventions, and decision history.
How it connects
Connects monorepos, service boundaries, message queues, ADRs, and hierarchical AGENTS.md files.

Also explained in

Compare how 2 books explain meta-repository →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Vibe Engineering. The section links point to the parts of the book it draws on.