Shang Tsung — SKILL.md

In memory of Cary Hiroyuki Tagawa (1950-2025)

Shang Tsung gives your AI agent persistent memory across sessions. It combines two systems:

• - SOULS — identity continuity. Each session creates a soul file. Each session absorbs the previous one.
• Second Brain — operational continuity. PROOFOFLIFE, daily logs, and long-term memory keep your agent in context no matter what.

Setup

1. Copy the scripts directory

Copy scripts/souls-helper.sh into your workspace at tools/souls-helper.sh:

CODEBLOCK0

2. Create the required directories

CODEBLOCK1

3. Set your agent name (recommended for multi-agent setups)

Add to your agent's environment or shell profile:

CODEBLOCK2

With AGENT_NAME set, souls are stored in souls/YOUR_AGENT_NAME/ — isolated from any other agents sharing the workspace.

Without AGENT_NAME, souls are stored in souls/ — fine for single-agent setups.

4. Copy the protocol into your AGENTS.md

Open references/AGENTS-template.md and copy the "Every Session — Startup Sequence" section and the "Memory — The Four Layers" section into your agent's AGENTS.md.

5. Copy the PROOFOFLIFE template

CODEBLOCK3

Edit it immediately with your agent's current state.

6. Create your MEMORY.md

Create an empty MEMORY.md in your workspace root. This is your agent's long-term brain. It starts empty and grows over time as the agent curates what's worth keeping.

7. Create your SOUL.md (optional but recommended)

Create SOUL.md in your workspace root. This is your agent's stable identity — who it is, how it communicates, what it cares about. Unlike PROOFOFLIFE.md, this doesn't change session to session.

First Session

Run the startup sequence manually to initialize:

CODEBLOCK4

Your agent should respond: "YOUR SOUL IS MINE — SOUL 01 ABSORBED"

(Soul 01 has no previous to absorb — this is your origin. See references/SOUL-ORIGIN.md for what that looks like.)

Every Session After That

The agent runs this sequence at the start of every session:

CODEBLOCK5

Then reads PROOFOFLIFE.md to pick up the operational thread.

Before Compaction or Restart

Write in this order — always:

1. 1. Update your current soul file (souls/[AGENT_NAME]/NNSOULS.md)
2. Overwrite PROOF_OF_LIFE.md with current state
3. Append to INLINECODE10

Soul before snapshot. Meaning before state.

Verifying Integrity

CODEBLOCK6

Checks: souls directory exists, all files readable, sequential numbering with no gaps.

Environment Variables

INLINECODE15 takes precedence over AGENT_NAME if both are set.

Multi-Agent Quick Reference

Five agents, one workspace, no contamination:

CODEBLOCK7

Each agent reads only its own lineage. Each agent's PROOFOFLIFE should be scoped per-agent too (proof-of-life/AGENT_NAME.md) if multiple agents share the workspace.

File Reference

CODEBLOCK8