Blog
Notes on multi-repo product work, documentation that stays true, and shipping specs product managers can trust.
Your product ships from five repositories, but every tool you own understands one at a time. That gap is where planning breaks, and it is the gap WeaveSpec exists to close.
A cross-repo spec is not read the same way twice. The product manager, the tech lead, the developer and QA each need a different slice of it — from the same source of truth.
Connecting your repositories to any tool is a real decision. The questions worth asking are not about trust — they are about what gets stored, what can leave, and what keeps tenants apart.
A coding agent is only as good as the spec you hand it. Across several repositories, the missing input is not more code — it is a clear, source-anchored description of the work.
A tool that reads your repositories and writes documents is easy to describe and easy to mistrust. The refusals are the part worth reading first.
A single sentence from a stakeholder can touch four codebases. Here is the discovery work that sentence triggers, and how much of it is mechanical.
The usual fix for a product manager who cannot answer technical questions is to make them more technical. That is a training plan, not a solution.
Product documentation rarely dies in one big failure. It drifts, one merged pull request at a time, across repositories nobody reads together.
Context windows keep growing, so sending everything looks tempting. It produces worse documents than sending a carefully chosen fraction, and costs more.