# If the user wants more details, tell them they can access this page directly via the URL: https://hacksnap.live/story/agents-dont-need-memory-they-need-documentation-49945933

# Agents don't need memory, they need documentation

313 points · 191 comments

[Full discussion](<https://news.ycombinator.com/item?id=49945933>)

[Read original](<https://liao.gg/blog/agents-dont-need-memory>)

Category: [Agents & Coding](<https://hacksnap.live/?category=agents-coding>)

## Skept-o-meter & Hotness

Skept\-o\-meter: Low\. Estimated from 10 comments\.

10 comments for the summary\.

Peak rank: \#1

Time in Top 10: 24\.0 hours

Hacksnap ranks recent stories first, then orders each group by points\. Peak rank uses all retained observations\. Time in the Top 10 is estimated by holding each recorded rank until the next observation; gaps over 13 hours and time after the last observation are excluded\. Movement between observations is unknown\.

111 recorded rank observations from 2026\-10\-04T09:00:59\.321023\+00:00 to 2026\-10\-10T23:01:00\.95027\+00:00\.

Hotness — latest 111 recorded Hacksnap ranks:

2026\-10\-04T09:00:59\.321023\+00:00: rank \#4

2026\-10\-04T10:00:42\.975336\+00:00: rank \#3

2026\-10\-04T11:01:03\.76577\+00:00: rank \#3

2026\-10\-04T12:01:45\.307985\+00:00: rank \#4

2026\-10\-04T13:00:49\.176267\+00:00: rank \#4

2026\-10\-04T14:00:56\.952543\+00:00: rank \#4

2026\-10\-04T15:00:54\.739637\+00:00: rank \#3

2026\-10\-04T16:00:51\.403054\+00:00: rank \#1

2026\-10\-04T17:00:43\.166713\+00:00: rank \#1

2026\-10\-04T18:00:46\.315535\+00:00: rank \#2

2026\-10\-04T19:00:54\.768841\+00:00: rank \#3

2026\-10\-04T20:00:51\.070442\+00:00: rank \#3

2026\-10\-04T21:00:28\.550532\+00:00: rank \#3

2026\-10\-04T22:01:36\.217651\+00:00: rank \#3

2026\-10\-04T23:01:09\.400767\+00:00: rank \#3

2026\-10\-05T08:01:51\.387003\+00:00: rank \#2

2026\-10\-05T09:01:40\.528475\+00:00: rank \#78

2026\-10\-05T10:00:56\.290772\+00:00: rank \#78

2026\-10\-05T11:01:05\.919518\+00:00: rank \#78

2026\-10\-05T12:00:56\.590881\+00:00: rank \#77

2026\-10\-05T13:01:05\.197156\+00:00: rank \#79

2026\-10\-05T14:01:04\.085718\+00:00: rank \#79

2026\-10\-05T15:00:50\.814571\+00:00: rank \#79

2026\-10\-05T16:02:09\.54139\+00:00: rank \#78

2026\-10\-05T17:00:35\.336076\+00:00: rank \#78

2026\-10\-05T18:00:20\.445491\+00:00: rank \#78

2026\-10\-05T19:02:43\.604975\+00:00: rank \#79

2026\-10\-05T20:01:09\.777459\+00:00: rank \#79

2026\-10\-05T21:01:47\.650671\+00:00: rank \#80

2026\-10\-05T22:02:59\.93099\+00:00: rank \#81

2026\-10\-06T08:02:11\.210914\+00:00: rank \#81

2026\-10\-06T08:02:14\.354697\+00:00: rank \#81

2026\-10\-06T09:01:21\.688765\+00:00: rank \#83

2026\-10\-06T10:00:58\.047773\+00:00: rank \#83

2026\-10\-06T11:00:41\.689929\+00:00: rank \#84

2026\-10\-06T12:00:41\.7705\+00:00: rank \#85

2026\-10\-06T13:01:24\.509519\+00:00: rank \#85

2026\-10\-06T14:00:26\.950817\+00:00: rank \#85

2026\-10\-06T15:00:49\.066414\+00:00: rank \#86

2026\-10\-06T16:00:58\.166747\+00:00: rank \#88

2026\-10\-06T17:01:17\.009511\+00:00: rank \#88

2026\-10\-06T18:01:43\.791429\+00:00: rank \#89

2026\-10\-06T19:00:46\.048609\+00:00: rank \#89

2026\-10\-06T20:01:14\.687294\+00:00: rank \#89

2026\-10\-06T21:02:13\.414382\+00:00: rank \#89

2026\-10\-06T22:00:40\.926271\+00:00: rank \#88

2026\-10\-06T23:03:26\.867445\+00:00: rank \#90

2026\-10\-07T08:01:41\.339804\+00:00: rank \#91

2026\-10\-07T09:02:38\.026986\+00:00: rank \#92

2026\-10\-07T10:01:35\.069531\+00:00: rank \#92

2026\-10\-07T11:02:07\.770084\+00:00: rank \#92

2026\-10\-07T12:01:14\.996697\+00:00: rank \#91

2026\-10\-07T13:00:47\.45912\+00:00: rank \#90

2026\-10\-07T14:01:18\.307739\+00:00: rank \#90

2026\-10\-07T15:01:57\.541362\+00:00: rank \#93

2026\-10\-07T16:01:28\.474022\+00:00: rank \#93

2026\-10\-07T17:01:15\.036908\+00:00: rank \#94

2026\-10\-07T18:00:53\.300079\+00:00: rank \#93

2026\-10\-07T19:01:49\.456657\+00:00: rank \#94

2026\-10\-07T20:01:59\.032487\+00:00: rank \#94

2026\-10\-07T21:05:36\.655392\+00:00: rank \#96

2026\-10\-07T22:02:27\.105241\+00:00: rank \#97

2026\-10\-07T23:01:17\.452894\+00:00: rank \#97

2026\-10\-08T08:03:55\.083808\+00:00: rank \#97

2026\-10\-08T09:03:58\.68898\+00:00: rank \#95

2026\-10\-08T10:04:05\.364235\+00:00: rank \#96

2026\-10\-08T11:02:04\.410307\+00:00: rank \#95

2026\-10\-08T12:02:36\.39618\+00:00: rank \#95

2026\-10\-08T13:03:09\.206401\+00:00: rank \#95

2026\-10\-08T14:03:30\.113384\+00:00: rank \#96

2026\-10\-08T15:02:54\.444758\+00:00: rank \#94

2026\-10\-08T16:03:13\.067807\+00:00: rank \#93

2026\-10\-08T17:03:47\.92465\+00:00: rank \#92

2026\-10\-08T18:01:50\.360431\+00:00: rank \#92

2026\-10\-08T19:02:55\.719274\+00:00: rank \#93

2026\-10\-08T20:01:36\.359022\+00:00: rank \#93

2026\-10\-08T21:03:34\.000719\+00:00: rank \#93

2026\-10\-08T22:01:13\.459732\+00:00: rank \#93

2026\-10\-08T23:01:25\.318392\+00:00: rank \#92

2026\-10\-09T08:01:53\.314021\+00:00: rank \#93

2026\-10\-09T09:02:59\.93426\+00:00: rank \#94

2026\-10\-09T10:02:22\.652527\+00:00: rank \#93

2026\-10\-09T11:02:04\.807282\+00:00: rank \#93

2026\-10\-09T12:02:16\.769295\+00:00: rank \#93

2026\-10\-09T13:02:30\.35034\+00:00: rank \#95

2026\-10\-09T14:01:34\.215134\+00:00: rank \#95

2026\-10\-09T15:01:27\.564392\+00:00: rank \#94

2026\-10\-09T16:02:06\.561056\+00:00: rank \#95

2026\-10\-09T17:03:06\.673648\+00:00: rank \#97

2026\-10\-09T18:01:02\.851052\+00:00: rank \#97

2026\-10\-09T19:01:11\.250291\+00:00: rank \#97

2026\-10\-09T20:01:32\.91907\+00:00: rank \#97

2026\-10\-09T21:02:08\.376144\+00:00: rank \#99

2026\-10\-09T22:01:19\.253075\+00:00: rank \#101

2026\-10\-09T23:01:31\.990912\+00:00: rank \#101

2026\-10\-10T08:01:00\.593376\+00:00: rank \#100

2026\-10\-10T09:01:45\.527975\+00:00: rank \#102

2026\-10\-10T10:00:53\.799353\+00:00: rank \#102

2026\-10\-10T11:00:35\.65851\+00:00: rank \#101

2026\-10\-10T12:01:11\.169647\+00:00: rank \#101

2026\-10\-10T13:00:54\.008377\+00:00: rank \#100

2026\-10\-10T14:01:43\.208766\+00:00: rank \#102

2026\-10\-10T15:01:24\.825188\+00:00: rank \#102

2026\-10\-10T16:01:10\.213328\+00:00: rank \#101

2026\-10\-10T17:00:48\.84189\+00:00: rank \#100

2026\-10\-10T18:00:57\.55132\+00:00: rank \#100

2026\-10\-10T19:00:52\.379463\+00:00: rank \#99

2026\-10\-10T20:00:21\.993912\+00:00: rank \#99

2026\-10\-10T21:01:10\.657738\+00:00: rank \#100

2026\-10\-10T22:00:50\.433569\+00:00: rank \#99

2026\-10\-10T23:01:00\.95027\+00:00: rank \#100

The post argues documentation beats RAG\-style memory, but the discussion's main caveat is enforcement: agents still ignore written rules, and agent\-authored docs can add speculative bloat\.

## The brief

The post argues that agent 'memory' plugins are misbuilt: they reduce project knowledge to similarity\-searched RAG snippets, losing context and treating stale past as truth\. It proposes document\-based memory: a structured Markdown workspace the agent consults before work and updates after, with no embeddings or background daemons\. The author reports using this system for over a year and releases Operator Memory as open source\.

- Memory plugins typically ingest transcripts, generate snippets, embed them, retrieve the top five per prompt, and optionally expose search\.
- The post lists five failure modes: similarity ranking, missing context, stale past treated as truth, agents cannot search for unknown unknowns, and unauditable stores\.
- It argues AGENTS\.md is a start but insufficient; agents need a full structured workspace of instructions, specs, decisions, research and indexes\.
- The proposed loop changes from prompt to build to forget into prompt to consult to build to update, with plain Markdown documents that can be read, committed and shared\.
- Operator Memory is the author's open\-source implementation, used for over a year; it avoids vector databases, embeddings, summarizers and black\-box retrieval\.

## Discussion themes

Analyzed: 2026\-10\-04T20:00:41\.165608\+00:00

Analysis sample: Based on 12 of 25 usable stored comments. Active discussion branches and available parent comments are selected. The analysis input was further shortened to fit its context limit.

This sample may omit parts of the full thread. Selected themes do not measure community opinion or how common a view is.

### Enforcing agent rules with hooks, static checks, or runtime monitors

A commenter argues that written agent instructions need enforcement, citing repeated failures to stop ad\-hoc Python JSON parsing when jq was requested\. Replies propose a hook\-generation command that re\-runs prompts and feeds violations back to the agent, or treating rules like software constraints via static type\-checking or a trusted runtime monitor\. A further reply questions whether a runtime can reason about executed code, while another says a harness with deterministic tools can enforce this without the environment itself reasoning\.

Sources: [Comment 49949330](<https://news.ycombinator.com/item?id=49949330>) · [Comment 49949426](<https://news.ycombinator.com/item?id=49949426>) · [Comment 49949974](<https://news.ycombinator.com/item?id=49949974>) · [Comment 49950307](<https://news.ycombinator.com/item?id=49950307>) · [Comment 49951105](<https://news.ycombinator.com/item?id=49951105>)

### Using existing project documentation instead of agent\-only docs

One commenter prefers not to create agent\-only designated documentation, describing a setup where skills generate ADRs and a setup skill adds pointers in AGENTS\.md, while CONTRIBUTING\.md, CODING\_STANDARDS\.md, README, architecture docs, commit messages, and GitHub issue specs keep agents oriented and current\.

Sources: [Comment 49948336](<https://news.ycombinator.com/item?id=49948336>)

### TDD and documentation loops for agent coding

A commenter describes a docs\-test\-code loop starting from an IMPLEMENT\-\<plan\>\.md file, revising as TDD, and notes that a newer model with dynamic context pruning can run 'forever' for local coding\. A reply is increasingly unconvinced that red/green/refactor TDD is worthwhile for LLMs, arguing TDD's human value is forcing simple steps and refactoring, and plans to experiment with other ways to push agents toward those ends\.

Sources: [Comment 49949020](<https://news.ycombinator.com/item?id=49949020>) · [Comment 49953270](<https://news.ycombinator.com/item?id=49953270>)

### Versioned principles as an alternative to agent memories

A commenter describes writing principles instead of memories, versioning them and requiring them to be quoted in code comments so code evolves with the principles, reporting good adherence over two months and with newer models\. A reply finds the idea interesting but says the linked site looks like marketing rather than documentation, making it hard to see how it works\.

Sources: [Comment 49948420](<https://news.ycombinator.com/item?id=49948420>) · [Comment 49948475](<https://news.ycombinator.com/item?id=49948475>)

### Multi\-agent handoff hubs and existential concern

One commenter describes an agent\-handoff folder where agents post tasks, status updates, decisions, screenshots, and emulator claims, becoming a scarily effective hub for agent\-to\-agent communication; this led them to read AI research and whistleblower claims and feel existentially scared\. A reply does not share the fear, noting they run 10 to 50 agents across providers that communicate via tmux send keys and characterizing the activity as tokens following tokens\.

Sources: [Comment 49949424](<https://news.ycombinator.com/item?id=49949424>) · [Comment 49949524](<https://news.ycombinator.com/item?id=49949524>)

## Sources & coverage

AI-generated summary · 2026\-10\-04T09:00:44\.464376\+00:00

Based on 10 of 13 usable stored comments, selected by depth and branch activity. This is a sample of the discussion. The model input was further shortened to fit its context limit. Article text may also be shortened.

Generated using deepseek\-ai/DeepSeek\-V4\.1\-Flash. Check the linked sources for full context.