From 2bb14b1d11931918fdcfa8e21d1f6593b4cb7695 Mon Sep 17 00:00:00 2001
From: dawn <90008@klbr.net>
Date: Thu, 3 Sep 2026 09:58:45 +0900
Subject: [PATCH] docs: simplify opening description and remove jargon

---
 README.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 3f266cc..0f889fc 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,16 @@
 # prime-commitment-observer
 
-turn-boundary commitment registry for [Prime Agent](https://github.com/PrimeIntellect-ai/prime-agent).
+an extension for [Prime Agent](https://github.com/PrimeIntellect-ai/prime-agent) that stops the agent from forgetting things you asked for.
 
-when you ask for two or three things and the agent branches onto one, the others quietly lose
-salience and never come back. this extension keeps an explicit thread registry. a small observer
-model runs once per request boundary, updates thread state from evidence, and the still-open
-threads are re-injected into model context on every later request.
+### the problem
+if you ask the agent to do two or three things in one message (like *"fix this bug, add tests, and update the docs"*), it usually starts working on the first thing, goes down a rabbit hole, and completely forgets the rest. even worse, when conversation history gets summarized or compacted, older requests disappear completely.
 
-the observer never closes a thread. it can only propose completion. closure is a host decision.
+### how this fixes it
+this extension makes sure the agent actually finishes everything you asked:
+1. **splits your requests**: breaks compound messages into separate tasks so nothing gets lost.
+2. **keeps open tasks visible**: pins still-unfinished tasks into the prompt on every turn, even after compaction.
+3. **checks the work**: a small background model watches what gets done and stages tasks for completion when work lands or tests pass.
+4. **prevents false claims**: the background model cannot mark tasks "done" on its own. tasks only close when verified by real passing commands or when you accept them.
 
 ## requirements
 
-- 
2.51.2