Who it is forA maintainer whose earlier decision no longer matches how the project works.
The problemEditing or deleting an old decision would erase history, while leaving it active would mislead agents.
The outcomeA new active record replaces the old head, and the old record stays readable as superseded history.
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
npx --no-install encephalon search --compact 'authentication tokens'to find the current subject and active record. - Run
npx --no-install encephalon add --id auth-tokens-v2 --kind decision --subject api.authentication --source agent --supersedes auth-tokens --data '{"summary":"Use short-lived signed bearer tokens"}' --text 'authentication tokens'to add the replacement. - Run
npx --no-install encephalon search --compact --include-superseded authenticationto confirm both records are visible with their status. - Run
npx --no-install encephalon show --id auth-tokens --active-onlyto confirm the old record is no longer returned as active.
Prompt for your agent
In the repository <repo-path>, find the active decision for <subject>, then add a replacement record that supersedes it. Expected output: the add result and a compact search that includes superseded records. Verify that the old record ID is not returned by show with --active-only.
Caveat. A replacement must supersede every active head with the same kind and subject, so search the subject first.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for isaachinman/encephalon and "Replace an outdated decision without losing history"
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