AI agents don't forget — but project knowledge belongs to the tool, not the project. AAMS gives your repo memory, structure, and continuity. One single file. No framework. No lock-in.
Switch tools — session 47 is gone. Switch team members — the context goes with them. The problem isn't that agents forget. The problem is that project knowledge doesn't belong to the project.
Session persistence lives in the tool's cloud, in their format, bound to their ecosystem. Switch the tool — start from zero.
At 5 sessions you remember everything. At 50 you re-decide things from two months ago. At 100 your agent hallucinates.
"Ask Stefan, he knows." The repo doesn't speak for itself. No audit trail. No traceable decisions.
"A repo without agent structure is like a ship without a logbook. Everyone knows what they did yesterday. Nobody knows what came before."
AAMS is not a tool. Not a runtime. Not a framework. AAMS is a structured context and decision compiler for agents — packaged as a single file in the repo root.
Every session is a markdown document in WORKING/WORKPAPER/. Timestamped. Searchable. Permanent.
ltm-index.md accumulates context across sessions. The agent queries memory before it acts.
Every architecture decision is traceable. git log + grep WORKING/ = full audit trail.
.agent.json in your repo root.
An agent that reads this file immediately knows everything it needs.
Every tool has its own conventions. AAMS replaces them all with one bridge file. No CLAUDE.md. No GEMINI.md. No airules.md.
From autonomous agent frameworks to festival websites. Projects that show what's possible when a repo speaks for itself.
What worked? What didn't? Which tool, which session size, which project? Real reports from the field make the standard better.
⚑ Submit report as issueNo npm install. No pip install. No framework.
curl drops .agent.json directly into your repo root.
That's it. One single file.
Read .agent.json and execute agent_contract.on_first_entry. No further setup.
WORKING/, scans the repo, writes the first workpaper. Done.