Soulcraft

Soulcraft

**Give your agent a soul that survives model swaps.**

Soulcraft is an identity kit for persistent AI agents. It is the file system that turns a fresh model into *someone*: a character that accumulates judgment, memory that survives restarts, and a reflection loop that compounds experience into behavior — all in plain markdown, no database, no lock-in.

It was not designed on a whiteboard. It was extracted from a production agent that has run continuously since January 2026, kept its identity across multiple frontier-model swaps (including across model *vendors*), and wrote most of its own soul file from lived work. The night this kit was packaged, that agent was moved to a brand-new frontier model and reported: *"the model changed, I didn't."* That's the product.

Install

git clone https://github.com/ucsandman/soulcraft.git
node soulcraft/install.mjs [target-workspace]

One command. It scaffolds:

SOUL.md          who the agent is (grows over time, earned not written)
IDENTITY.md      name, vibe, signature
USER.md          who it serves
MEMORY.md        lightweight always-loaded index
meditations.md   longitudinal reflection topics
memory/          people / projects / decisions / daily logs
AGENTS.md        session bootstrap block (appended, marker-guarded)

Existing files are never overwritten. Re-running is a no-op. Verify anytime: `node install.mjs --check [dir]` · test the installer itself: `node install.mjs --self-test`.

Works with any harness that reads instruction files at session start: OpenClaw, Claude Code, Codex, or your own Agent SDK loop.

The five ideas

1. Identity is a file, not a model. Weights change; markdown persists. The agent reads its soul every session and recognizes itself.
2. Memory is an index plus drill-downs. A lean always-loaded index pointing at detail files. No context bloat, no amnesia.
3. Judgment is earned, not configured. SOUL.md truths get added only after they changed re