From db56bd7c5454941641d6421aa743df33c92d7cc0 Mon Sep 17 00:00:00 2001
From: Andres Vergara <andres@lifewealthco.com>
Date: Fri, 27 Mar 2026 09:49:50 -0700
Subject: [PATCH 1/2] fix: move demo GIF inside div so GitHub renders it

Assisted-By: Claude Opus 4.6
---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f7329f2..a02b1e2 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,7 @@ Each primitive is a standalone binary. No server, no configuration, no runtime d
 - **knowledgeprim**: knowledge graph with hybrid search (FTS5 + vectors)
 - **queueprim**: persistent work queues with priority, retries, and dead-letter
 
+---
 
 **Not sure if you need this?** Paste this into your agent:
 
@@ -23,6 +24,7 @@ Each primitive is a standalone binary. No server, no configuration, no runtime d
 
 It will map primkit to your actual workflow and give you a straight answer.
 
+---
 
 ```bash
 # One command. Database auto-created on first use.
@@ -35,9 +37,10 @@ taskprim done t_abc123
 
 *An agent creates a task, queries open work, and marks it done, all from the shell.*
 
-</div>
 ![primkit demo](docs/assets/demo.gif)
 
+</div>
+
 
 ### Install
 

From 12db23efb4869d9684760d1a4ccc2f814224bec6 Mon Sep 17 00:00:00 2001
From: Andres Vergara <andres@lifewealthco.com>
Date: Fri, 27 Mar 2026 10:04:49 -0700
Subject: [PATCH 2/2] docs: add "Let your agent decide" section with copy-paste
 prompt

Elevate agent evaluation prompt to h2 heading with fenced code block
for GitHub copy button, reword description paragraph, promote tagline
to h2 inside hero div.

Assisted-By: Claude Opus 4.6
---
 README.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index a02b1e2..7224ed7 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <div align="center">
   <img src="docs/assets/logo.png" width="128" alt="primkit" />
   <h1>primkit</h1>
-  <p><strong>Persistent state for AI agents. Four CLI tools, embedded SQLite, zero infrastructure.</strong></p>
+  <h2>Persistent state for AI agents. Four CLI tools, embedded SQLite, zero infrastructure.</h2>
 
   [![CI](https://github.com/propifly/primkit/actions/workflows/ci.yml/badge.svg)](https://github.com/propifly/primkit/actions/workflows/ci.yml)
   [![Release](https://img.shields.io/github/v/release/propifly/primkit)](https://github.com/propifly/primkit/releases/latest)
@@ -9,7 +9,7 @@
   [![Go 1.26+](https://img.shields.io/badge/go-1.26+-00ADD8.svg)](https://go.dev/dl/)
 </div>
 
-Each primitive is a standalone binary. No server, no configuration, no runtime dependencies. State survives session ends, terminal closes, and context window limits.
+primkit gives AI agents structured, persistent state that survives session ends, terminal closes, and context window limits. Each primitive is a standalone binary backed by embedded SQLite. No server, no configuration, no runtime dependencies.
 
 - **taskprim**: task lifecycle, dependencies, frontier queries
 - **stateprim**: key-value state, dedup checks, append-only logs
@@ -17,10 +17,13 @@ Each primitive is a standalone binary. No server, no configuration, no runtime d
 - **queueprim**: persistent work queues with priority, retries, and dead-letter
 
 ---
+## Let your agent decide
 
-**Not sure if you need this?** Paste this into your agent:
+Paste this into Claude Code, Cursor, Codex, or any agent with web access:
 
-> *Read https://github.com/propifly/primkit/blob/main/docs/agent-reference.md, then tell me whether primkit would help with what we've been doing, and which primitives are relevant.*
+```
+Read https://github.com/propifly/primkit/blob/main/docs/agent-reference.md, then tell me whether primkit would help with what we've been doing, and which primitives are relevant.
+```
 
 It will map primkit to your actual workflow and give you a straight answer.