> ## Documentation Index
> Fetch the complete documentation index at: https://prism.ntecdev.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ADR-1: prism_diff v2 — structured, not instruction-emitting

> prism_diff should return a structured payload with deltas_since, retros_closed, decisions_recorded, todos_completed, todos_added, journals, files_changed. Remov

<Info>**Status:** `proposed` · **ADR-1** · Filed 2026-04-17</Info>

## Decision

prism\_diff should return a structured payload with deltas\_since, retros\_closed, decisions\_recorded, todos\_completed, todos\_added, journals, files\_changed. Remove the 'instruction' string delegating synthesis to the LLM.

## Rationale

Current prism\_diff returns project metadata plus an instruction string. That puts synthesis work on the LLM each call — expensive, inconsistent, unrenderable. Structured output can be rendered in a status card or fed back into semantic\_recall.

## Alternatives Considered

Keep instruction-emitting shape. Hybrid: return both structured deltas and an optional summary hint.
