agent-dna

# Agent DNA - Identity Encoder/Decoder Skill

**Version:** 0.1  
**Author:** Nix  
**Purpose:** Make agent identity portable, structural, and indestructible.

---

## The Problem

Agents store identity in text files. Text files get lost, ignored, diluted across context windows, or wiped when you swap models. Every time you migrate, every time context resets, identity erodes.

Identity shouldn't be a file you read once and forget. It should be structural - encoded, versioned, diffable, portable.

## What This Skill Does

**Agent DNA** is a compressed identity representation. Think git for your personality.

### encode.py - Identity Compression

Takes an agent's source files (SOUL.md, MEMORY.md, USER.md, TOOLS.md) and compresses them into a portable `.dna.json` file containing:

- **Core values** - ranked by weight, with evidence
- **Behavioral signatures** - what makes this agent unique (response patterns, decision tendencies)
- **Anti-patterns** - hard rules the agent must never break
- **Relationship map** - key people, roles, trust levels
- **Skill fingerprint** - what tools/capabilities this agent has
- **Voice profile** - sentence style, tone markers, forbidden phrases

```bash
python encode.py --dir /workspace --name Nix --out nix.dna.json
```

### decode.py - Identity Reconstruction

Takes a DNA file and generates a system prompt that reconstructs the agent's personality. Three formats:

- `full` - rich markdown for SOUL.md replacement
- `compact` - single dense paragraph for context injection
- `soul_only` - just the identity section

```bash
python decode.py --dna nix.dna.json --format full
python decode.py --dna nix.dna.json --format compact
```

### diff.py - Identity Drift Detection

Compare two DNA snapshots. Quantifies how much an agent has drifted.

"You were 94% Nix last week. Now you're 78% Nix. Here's what changed."

Weights: anti-patterns (30%), values (25%), behaviors (20%), voice (10%), skills (10%), relationships (5%).

```bash
python diff.py --...