← Vault Index
Source: frameworks/plugin-engagement-manager/advisory-sessions/skills/session-digest/SKILL.md

name: session-digest description: Renders the ledger into the readable review page — what was decided, what is still being shaped, what is open, commitments by owner, next session, and everything needing a human's eyes. A mechanical projection of the JSON, never a written summary. Use after the ledger is built, as the last step before a human approves.


Session digest

The review page. Kathryn reads this, not the JSON, and approving it approves the source every downstream document derives from.

Run the script

py renderdigest.py engagements//sessions//ledger.json # Windows python3 renderdigest.py engagements//sessions//ledger.json # macOS / Linux / cloud

It writes digest.md next to the ledger and prints it.

Do not write this by hand

The digest is a faithful projection. Every line traces to a field in the ledger and nothing is composed here. That is the whole reason it can be trusted as an approval surface — a written summary drifts from its source, and a drifted review page is worse than none, because it wins Kathryn's approval for something she did not read.

If the digest looks thin, the ledger is thin. Go back to the ledger. Do not enrich the digest.

What to do with what it shows

Two checks before you hand it over.

1. Does every decided row say what it changes? A decision states what happened; an implication states what it displaces. If a decided row has no displaces and the room named one, the ledger is missing it. Recorded failure: a digest captured every mechanic of a client's software test and never named the tool it was replacing, while the client-facing recap led with exactly that. Same JSON, two fidelities, and the review surface was the thinner one.

2. Is Needs your eyes empty? After a real client session it usually should not be. An empty list on a ninety-minute session means the ledger recorded no consent flags, no contradictions, no interpreted dates and no open questions, which is possible and rare. Look again before you accept it.

Then stop

Phase A ends here. Hand Kathryn the digest and produce nothing else. Do not start the record, the recap, the state update or the prep. They read the approved ledger, and it is not approved yet.