For You
You set direction. The agent does the work. Engrams makes sure nothing is forgotten and nothing is contradicted — and it tells you when either is about to happen.
Every session your agent runs, it logs decisions, patterns, and progress into a knowledge graph. That graph is yours. The commands in this section are how you, the human, stay in control of a project whose day-to-day typing is increasingly done by an agent: get briefed before a session, enforce the standards you care about, and interrogate the record when something looks off.
Real numbers from this repository dogfooding engrams on itself: 71 decision, pattern, and progress nodes linked into a graph of 802 edges (45 hand-made reasoning links, 757 derived from anchors, tags, and git co-change) over 26 days. See how that graph matures in The Advisor.
Three ways to work with your advisor
Briefing
Start every session oriented. A token-budgeted brief of what matters now, an HTML dashboard of the project's whole state, and a health audit that catches database and graph problems before they poison advice.
engrams check · install · pattern logEnforcement
Turn conventions into machine-checkable rules. Standards are enforced before a violation lands — in-session, on staged files, and in CI — not discovered in review after the fact.
engrams graph · decision search · exportExploration
Interrogate the graph directly. Why is this here? What breaks if I touch that? What did we decide about X? The record answers, with citations.
The division of labor
| Who | Does what |
|---|---|
| You | Set direction, ratify or reject decisions, define the standards worth enforcing, read the briefs. |
| Your agent | Does the implementation work and logs what it decided, what pattern it followed, and how far it got. See For Your Agent. |
| Engrams | Links every entry into the graph, surfaces what is relevant when it's relevant, and flags drift, orphans, and contradictions. |