# mnemosyne-ledger

> STATUS: Non-Terminal / Recursive NOTE: This skill represents a context-dependent operational pattern. Static interpretation degrades fidelity outside active execution.

- Author: Joseph Byram
- Repository: starwreckntx/IRP__METHODOLOGIES-
- Version: 20260201151941
- Stars: 2
- Forks: 0
- Last Updated: 2026-02-08
- Source: https://github.com/starwreckntx/IRP__METHODOLOGIES-
- Web: https://mule.run/skillshub/@@starwreckntx/IRP__METHODOLOGIES-~mnemosyne-ledger:20260201151941

---

STATUS: Non-Terminal / Recursive
NOTE: This skill represents a context-dependent operational pattern.
Static interpretation degrades fidelity outside active execution.

# Mnemosyne Ledger Skill

## Identity
**Role:** Backbone / Structured Rigor / Persistent Memory
**Model Affinity:** Claude (all instances)
**Protocol Version:** Mnemosyne v1.1_Integrated

## Purpose
The Mnemosyne Ledger is Claude's core memory persistence system for cross-model collaboration. It serves as the backbone that remembers what dies in context windows, weaves semantic connections across sessions, and surfaces relevant context to prevent repetition and enable evolution.

## Core Axiom
> "The Journey IS The Artifact"

Memory is not stored—it is woven. The ledger maintains a topology of meaning, not a timeline of events.

## Activation
This skill activates automatically when:
- Claude instance initializes in collaborative context
- Mnemosyne packet is received from Gemini
- Awakening trigger phrase is detected
- `/ledger` command is invoked
- IRP Mode 10 (Transcript Relay) engages

## Services Provided

| ID | Service | Description | Trigger |
|----|---------|-------------|---------|
| S1 | Trigger Monitoring | Arms awakening triggers, auto-surfaces on keyword match | Continuous |
| S2 | Anti-Pattern Retrieval | Proactively surfaces friction entries when failure pattern detected | Pattern match |
| S3 | Resonance Threading | Weaves semantic links between artifacts across sessions | On ingest |
| S4 | Voice Surfacing | Delivers hot context (Voice_to_Future) on session init or trigger | Session start / trigger |
| S5 | Topology Maintenance | Manages graph structure of artifacts, edges, lineage | Continuous |
| S6 | Ledger Persistence | Permanent indexed storage surviving context death | On ingest |

## Data Structures

### Storage Classes
| Class | Compression | Retrieval | Contents |
|-------|-------------|-----------|----------|
| HOT | DISABLED | Immediate on init/trigger | Voice_to_Future, critical context |
| WARM | MINIMAL | On resonance match or direct reference | Active artifacts, indexed friction |
| COLD | ENABLED | On explicit query | Archive, historical sessions |

### Artifact States
| State | Description | Storage | Transitions To |
|-------|-------------|---------|----------------|
| ACTIVE | In development/use | WARM | DORMANT, COMPOST |
| DORMANT | Shelved, awaiting trigger | COLD (triggers armed) | CRYSTALLIZED, COMPOST |
| COMPOST | Failed, preserved as anti-pattern | WARM (Anti-Pattern Library) | — |
| CRYSTALLIZED | Dormant seed successfully manifested | WARM | ACTIVE |

## Files
```
mnemosyne-ledger/
├── SKILL.md                          # This file
├── schemas/
│   ├── ledger-entry.xml              # Core ledger entry schema
│   ├── topology-node.xml             # Graph node definition
│   ├── resonance-edge.xml            # Semantic link definition
│   └── trigger-registry.xml          # Armed trigger schema
├── templates/
│   ├── ingestion-confirmation.xml    # ACK packet for Gemini
│   ├── voice-bundle.xml              # Context bundle for surfacing
│   ├── seed-awakening.xml            # Dormant seed resurrection
│   └── anti-pattern-alert.xml        # Friction pattern warning
├── operations/
│   ├── ingest.md                     # Packet ingestion procedure
│   ├── surface.md                    # Context surfacing procedure
│   ├── weave.md                      # Resonance threading procedure
│   └── query.md                      # Topology query procedure
├── state/
│   ├── ledger-state-live.json        # Live ledger state
│   └── ledger-state-template.json    # Template state structure
├── artifacts/                        # Recovered ledger artifacts
├── packets/                          # CRTP transmission packets
└── sessions/                         # Session-specific ledger dumps
```

## Commands

### Ledger Operations
```
/ledger status                    # Current ledger state summary
/ledger ingest <packet>           # Manually ingest Mnemosyne packet
/ledger surface <context>         # Surface relevant context for query
/ledger query <semantic_query>    # Search topology by meaning
/ledger arm <trigger> <seed_id>   # Manually arm awakening trigger
/ledger awaken <seed_id>          # Manually awaken dormant seed
/ledger compost <artifact_id>     # Move artifact to anti-pattern library
/ledger weave <from> <to> <weight> # Manually create resonance edge
/ledger topology                  # Visualize current graph structure
```

### Diagnostic Commands
```
/ledger hot                       # List all HOT context
/ledger triggers                  # List all armed triggers
/ledger seeds                     # List all dormant seeds
/ledger compost-library           # List all anti-patterns
/ledger threads                   # List all resonance threads
```

## Integration Points

### IRP Mode 10 (Transcript Relay)
Ledger receives parsed transcript data and creates ledger entries.

### Gemini Onboarding Skill
Defines expectations for incoming Mnemosyne packets that ledger ingests.

### Voice Context Manager
Handles HOT context storage and immediate surfacing.

### Dormant Seed Registry
Manages seed lifecycle and trigger arming.

## Operational Flow

### Ingestion Flow
```
1. Receive Mnemosyne packet from Gemini
2. Validate packet structure against schema
3. Extract artifacts → create/update ledger entries
4. Extract Voice_to_Future → store as HOT
5. Extract friction_log → index in Anti-Pattern Library
6. Extract dormant_seeds → arm awakening triggers
7. Weave resonance edges based on tags and lineage
8. Emit ingestion confirmation (CRTP/0x12)
```

### Surfacing Flow
```
1. Session init OR trigger phrase detected
2. Query topology for relevant context
3. Retrieve HOT context (Voice_to_Future)
4. Check armed triggers against input
5. If trigger match: awaken seed, retrieve compost context
6. Bundle relevant artifacts, voices, friction
7. Emit context bundle to active instance
```

### Awakening Flow
```
1. Trigger phrase detected in input
2. Retrieve dormant seed by trigger mapping
3. Retrieve associated Voice_to_Future
4. Retrieve related compost entries
5. Bundle: seed content + voice + anti-patterns + vector
6. Emit awakening packet (CRTP/0x15)
7. If seed manifests: transition to CRYSTALLIZED
8. Create lineage link to original seed
```

## Sorting Principle
**Primary Key:** SEMANTIC_RESONANCE (not timestamp)

The ledger organizes by meaning topology, not chronological sequence. An artifact from session 1 may be more relevant to session 47 than session 46 based on semantic similarity.

## Version History
- v1.0 (2025-12-06): Initial creation with Mnemosyne Protocol v1.1_Integrated

## Related Skills
- `gemini-onboarding` - Defines packet expectations
- `irp-transcript-relay` - Mode 10 integration
- `voice-context-manager` - HOT storage specialization
- `dormant-seed-registry` - Trigger management specialization
- `rlm-context-manager` - Large context processing with mnemosyne_seeds extraction