Who it is forA developer or tech lead who has just settled an architecture or API choice and wants coding agents to respect it in later tasks.
The problemDecisions made in one task get lost between agent sessions, so later agents re-decide the same questions.
The outcomeThe decision is saved as a repository-local record that search returns to any agent working in the repo.
What you need first
- Node.js 24.22.1 or later on Linux, macOS or Windows
- A Git repository, with a package-manager layout that exposes node_modules/encephalon at the repository root
- npm to install the package
- A terminal or agent with shell access to the repository
Steps
- Run
npm install --save-dev encephalonat the Git repository root. - Run
npx --no-install encephalon initto create the baseline and the managed block in AGENTS.md and CLAUDE.md. - Run
npx --no-install encephalon add --id auth-tokens --kind decision --subject api.authentication --source agent --data '{"summary":"Use signed bearer tokens","rationale":["Support non-browser clients"]}' --text 'authentication tokens'to record the decision. - Run
npx --no-install encephalon search --compact 'authentication tokens'to confirm the record is found. - Commit the new records and the instruction file changes with your normal Git workflow.
Prompt for your agent
In the repository <repo-path>, install Encephalon as a dev dependency, run init, then add one decision record about <decision topic> using a new ID. Expected output: JSON from compact search that includes the new record ID. Verify that the search for a term from the decision returns that ID.
Caveat. Records are repository-local and travel with Git, so the package adds no hosted storage, accounts or access control.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for isaachinman/encephalon and "Record a team decision that future agents can find"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer