Merge conflict in GenerationBranch a document, edit it with an agent, and merge it back, like code. Conflicts are settled in the text itself.
Asset summaries
Attach a long document to an item, and get back the parts of it that matter to that item, without anyone reading past page three.
Context
Reviewers keep attaching whitepapers and RFCs to designs, and nobody reads them. Research on MAA-12 showed that ranking an asset's sections against the item finds the relevant ones reliably, where summarising the whole asset first loses them.
Storage
Summaries are generated when an asset is attached, and stored with the version that attached it. They are then regenerated again whenever somebody opens the asset after another author changed it.
Generation
Summaries are generated on request.
Rollout
Ship behind a flag, starting with our own org.
Highlighting
A summary picks out the sections of the asset that matter to the item it's attached to, ranked against the item's description. Each highlight links back to the passage it came from, so a reader can check it in context.
Data model
| field | type | notes |
|---|---|---|
asset_version | uuid | the version the summary was made from |
item | uuid | what the highlights were ranked against |
sections | jsonb | ranked highlights, each with its source offsets |
model | text | which model wrote it, for later comparison |
Risks
- Scanned PDFs have no text layer. They need extraction first, which is MAA-16.
- Ranking against a vague item description gives vague highlights. The pre-check flags items without one.
- Summaries cost tokens on every attach. A shared cache per asset version keeps re-attaches free.
Alternatives considered
Summarise the whole asset first, then rank. Rejected in research: the summary loses exactly the details a reviewer is looking for.
Generate on first view. Cheaper for assets nobody opens, but leaves a reviewer waiting the first time, and an unopened asset without a summary at all.
Decision log
| decision | by | when |
|---|---|---|
| Store summaries with the asset version, not the asset | product, engineering | v2 |
| Rank sections against the item, not a fixed query | engineering | v3 |
| Roll out behind a flag, our own org first | erik | v4 |