Skip to content

Commit 7ee40cf

Browse files
adityamukhoclaude
andcommitted
docs: sharpen agentic positioning in README and llms.txt
README: - Add "For AI Agents" section with verifiable reasoning framing, agent error-correction example (belief retract + :as-of rewind), and five specific agentic use cases - Reframe "Distributed" in Unscope as intentional per-agent private memory rather than a limitation - Promote AI agents to top of Target Use Cases list llms.txt: - Expand agent memory entry with root cause analysis framing - Add verifiable agent reasoning as explicit use case - Add task planning agents (DAG of sub-tasks) - Add code dependency / debugging agents Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 6a5c6ed commit 7ee40cf

2 files changed

Lines changed: 42 additions & 8 deletions

File tree

README.md

Lines changed: 38 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -260,13 +260,44 @@ No other database offers this combination:
260260

261261
**Minigraf = SQLite's simplicity + Datomic's temporal model**
262262

263+
### For AI Agents
264+
265+
Minigraf is a natural fit for agents that need **verifiable reasoning** — the ability to reconstruct exactly what the agent knew at the moment it made a decision, even after its beliefs have been updated or corrected.
266+
267+
Because every fact carries both a *transaction time* (when it was recorded) and a *valid time* (when it was true in the world), an agent's entire decision-making lineage is preserved and queryable:
268+
269+
```datalog
270+
;; Agent records a belief
271+
(transact [[:agent :belief/sky-color "blue"]])
272+
273+
;; Belief is later corrected
274+
(retract [[:agent :belief/sky-color "blue"]])
275+
(transact [[:agent :belief/sky-color "red"]])
276+
277+
;; Reconstruct what the agent believed at tx 1 — before the correction
278+
(query [:find ?color :as-of 1 :where [:agent :belief/sky-color ?color]])
279+
;; => "blue"
280+
```
281+
282+
**Agentic use cases:**
283+
284+
- **Agent memory with provenance** - Store what an agent believes, retract and correct without losing history, replay past states to audit decisions
285+
- **Verifiable reasoning** - Post-hoc root cause analysis: rewind to the exact knowledge state at the moment of a mistake
286+
- **Task planning graphs** - Model a DAG of sub-tasks as a graph; update dependencies over time; query historical task states
287+
- **Code dependency agents** - Embed call graphs or module dependency graphs; traverse them with recursive Datalog rules
288+
- **Multi-agent coordination** - Each agent carries its own `.graph` file as a private, embedded memory store — no shared server required
289+
290+
**Why embedded (no server) is a feature for agents, not a limitation:**
291+
292+
An agent's memory is private to that agent instance. Embedding Minigraf directly in the agent's process means no network latency, no external service to manage, offline-capable operation, and a portable `.graph` file that travels with the agent. The single-file model also makes agent memory trivially snapshotable, versioned, or rolled back.
293+
263294
### Target Use Cases
264295

265-
1. **Audit-heavy applications** - Finance, healthcare, legal (bi-temporal = compliance)
266-
2. **Event sourcing** - Full history, time travel debugging
267-
3. **Personal knowledge bases** - Obsidian, Logseq, Roam-like apps
268-
4. **Local-first applications** - Offline-capable, user-owned data
269-
5. **AI/RAG systems** - Knowledge graphs with provenance
296+
1. **AI agents** - Verifiable reasoning, agent memory with provenance, task planning
297+
2. **Audit-heavy applications** - Finance, healthcare, legal (bi-temporal = compliance)
298+
3. **Event sourcing** - Full history, time travel debugging
299+
4. **Personal knowledge bases** - Obsidian, Logseq, Roam-like apps
300+
5. **Local-first applications** - Offline-capable, user-owned data
270301
6. **Mobile apps** - Embedded graph database on devices
271302
7. **WASM applications** - Graph database in the browser
272303
8. **Development/testing** - Local graph DB like SQLite
@@ -293,12 +324,12 @@ Minigraf is designed to run in multiple environments:
293324
## Unscope
294325

295326
Minigraf will **NOT** be (by design):
296-
- **Distributed** - No clustering, no sharding, no replication
327+
- **Distributed** - No clustering, no sharding, no replication. For agents, this is intentional: each agent instance owns its own private `.graph` file. No shared server, no network calls, no contention.
297328
- **Client-server** - No network protocol in core
298329
- **Enterprise-focused** - No RBAC, no HA, no multi-datacenter
299330
- **Billion-node scale** - Optimized for <1M nodes (like SQLite)
300331

301-
If you need these, use Neo4j, TigerGraph, or similar.
332+
If you need a distributed graph database, use Neo4j, TigerGraph, or similar.
302333

303334
## Testing
304335

llms.txt

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,10 @@ Minigraf is the SQLite of graph databases: zero configuration, one `.graph` file
99

1010
## Use for
1111

12-
- **Agent memory with provenance**: Store facts an agent asserted, when it asserted them, and query any past state. Retract and correct beliefs without losing history.
12+
- **Agent memory with provenance**: Store facts an agent asserted, when it asserted them, and query any past state. Retract and correct beliefs without losing history. Rewind to the exact knowledge state at the moment of a bad decision for root cause analysis.
13+
- **Verifiable agent reasoning**: Preserve an agent's full decision-making lineage. Post-hoc audits can reconstruct what the agent believed at any transaction counter or timestamp.
14+
- **Task planning agents**: Model sub-task DAGs as a graph. Update dependencies and status over time. Query historical task states with `:as-of`.
15+
- **Code dependency / debugging agents**: Embed call graphs or module dependency graphs; traverse with recursive Datalog rules.
1316
- **Audit-trail applications**: Compliance-grade history where both "what was recorded when" (transaction time) and "what was true when" (valid time) matter independently.
1417
- **Knowledge graphs**: Interconnected entity-relationship data with recursive traversal (e.g. reachability, ancestry, dependency chains).
1518
- **Event sourcing / temporal debugging**: Replay past states exactly as they existed at any transaction counter or wall-clock timestamp.

0 commit comments

Comments
 (0)