Search papers, labs, and topics across Lattice.
The paper introduces Lore, a protocol for structuring Git commit messages using Git trailers to capture the "Decision Shadow"鈥攖he reasoning behind code changes, including constraints, alternatives, and context. Lore aims to preserve institutional knowledge lost when AI coding agents generate code, by making the reasoning behind code changes explicit and queryable. The protocol is implemented with a CLI tool and designed to be discoverable by AI agents, offering a lightweight solution for knowledge management in software development.
Git commits are a goldmine of lost reasoning, and Lore offers a simple way to surface it for AI agents.
As AI coding agents become both primary producers and consumers of source code, the software industry faces an accelerating loss of institutional knowledge. Each commit captures a code diff but discards the reasoning behind it - the constraints, rejected alternatives, and forward-looking context that shaped the decision. I term this discarded reasoning the Decision Shadow. This paper proposes Lore, a lightweight protocol that restructures commit messages - using native git trailers - into self-contained decision records carrying constraints, rejected alternatives, agent directives, and verification metadata. Lore requires no infrastructure beyond git, is queryable via a standalone CLI tool, and is discoverable by any agent capable of running shell commands. The paper formalizes the protocol, compares it against five competing approaches, stress-tests it against its strongest objections, and outlines an empirical validation path.
