You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
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
-**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.
5.**Local-first applications** - Offline-capable, user-owned data
270
301
6.**Mobile apps** - Embedded graph database on devices
271
302
7.**WASM applications** - Graph database in the browser
272
303
8.**Development/testing** - Local graph DB like SQLite
@@ -293,12 +324,12 @@ Minigraf is designed to run in multiple environments:
293
324
## Unscope
294
325
295
326
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.
297
328
-**Client-server** - No network protocol in core
298
329
-**Enterprise-focused** - No RBAC, no HA, no multi-datacenter
299
330
-**Billion-node scale** - Optimized for <1M nodes (like SQLite)
300
331
301
-
If you need these, use Neo4j, TigerGraph, or similar.
332
+
If you need a distributed graph database, use Neo4j, TigerGraph, or similar.
Copy file name to clipboardExpand all lines: llms.txt
+4-1Lines changed: 4 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,10 @@ Minigraf is the SQLite of graph databases: zero configuration, one `.graph` file
9
9
10
10
## Use for
11
11
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.
13
16
- **Audit-trail applications**: Compliance-grade history where both "what was recorded when" (transaction time) and "what was true when" (valid time) matter independently.
14
17
- **Knowledge graphs**: Interconnected entity-relationship data with recursive traversal (e.g. reachability, ancestry, dependency chains).
15
18
- **Event sourcing / temporal debugging**: Replay past states exactly as they existed at any transaction counter or wall-clock timestamp.
0 commit comments