writer-memory

Files (7)

• SKILL.md
• character-tracker.ts · lib/
• memory-manager.ts · lib/
• relationship-graph.ts · lib/
• scene-organizer.ts · lib/
• synopsis-builder.ts · lib/
• synopsis-template.md · templates/

SKILL.md (first lines)

# Writer Memory - Agentic Memory System for Writers

Persistent memory system designed for creative writers, with first-class support for Korean storytelling workflows.

## Overview

Writer Memory maintains context across Claude sessions for fiction writers. It tracks:

- **Characters (캐릭터)**: Emotional arcs (감정궤도), attitudes (태도), dialogue tone (대사톤), speech levels
- **World (세계관)**: Settings, rules, atmosphere, constraints
- **Relationships (관계)**: Character dynamics and evolution over time
- **Scenes (장면)**: Cut composition (컷구성), narration tone, emotional tags
- **Themes (테마)**: Emotional themes (정서테마), authorial intent

All data persists in `.writer-memory/memory.json` for git-friendly collaboration.

## Commands

| Command | Action |
|---------|--------|
| `/oh-my-codex:writer-memory init <project-name>` | Initialize new project memory |
| `/oh-my-codex:writer-memory status` | Show memory overview (character count, scene count, etc) |
| `/oh-my-codex:writer-memory char add <name>` | Add new character |
| `/oh-my-codex:writer-memory char <name>` | View character details |
| `/oh-my-codex:writer-memory char update <name> <field> <value>` | Update character field |
| `/oh-my-codex:writer-memory char list` | List all characters |
| `/oh-my-codex:writer-memory rel add <char1> <char2> <type>` | Add relationship |
| `/oh-my-codex:writer-memory rel <char1> <char2>` | View relationship |
| `/oh-my-codex:writer-memory rel update <char1> <char2> <event>` | Add relationship event |
| `/oh-my-codex:writer-memory scene add <title>` | Add new scene |
| `/oh-my-codex:writer-memory scene <id>` | View scene details |
| `/oh-my-codex:writer-memory scene list` | List all scenes |
| `/oh-my-codex:writer-memory theme add <name>` | Add theme |
| `/oh-my-codex:writer-memory world set <field> <value>` | Set world attribute |
| `/oh-my-codex:writer-memory query <question>` | Query memory naturally (Korean supported) |
| `/oh-my-codex:writer-memory validate <character> <dialogue>` | Check if dialogue matches character tone |
| `/oh-my-codex:writer-memory synopsis` | Generate emotion-focused synopsis |
| `/oh-my-codex:writer-memory export` | Export full memory as readable markdown |
| `/oh-my-codex:writer-memory backup` | Create manual backup |

## Memory Types

### 캐릭터 메모리 (Character Memory)

Tracks individual character attributes essential for consistent portrayal:

| Field | Korean | Description |
|-------|--------|-------------|
| `arc` | 감정궤도 | Emotional journey (e.g., "체념 -> 욕망자각 -> 선택") |
| `attitude` | 태도 | Current disposition toward life/others |
| `tone` | 대사톤 | Dialogue style (e.g., "담백", "직설적", "회피적") |
| `speechLevel` | 말투 레벨 | Formality: 반말, 존댓말, 해체, 혼합 |
| `keywords` | 핵심 단어 | Characteristic words/phrases they use |
| `taboo` | 금기어 | Words/phrases they would never say |
| `emotional_baseline` | 감정 기준선 | Default emotional state |
| `triggers` | 트리거 | What provokes emotional reactions |

**Example:**
```
/writer-memory char add 새랑
/writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
/writer-memory char update 새랑 tone "담백, 현재충실, 감정억제"
/writer-memory char update 새랑 speechLevel "해체"
/writer-memory char update 새랑 keywords "그냥, 뭐, 괜찮아"
/writer-memory char update 새랑 taboo "사랑해, 보고싶어"
```

### 세계관 메모리 (World Memory)

Establishes the universe your story inhabits:

| Field | Korean | Description |
|-------|--------|-------------|
| `setting` | 배경 | Time, place, social context |
| `rules` | 규칙 | How the world operates (magic systems, social norms) |
| `atmosphere` | 분위기 | Overall mood and tone |
| `constraints` | 제약 | What cannot happen in this world |
| `history` | 역사 | Relevant backstory |

### 관계 메모리 (Relationship Memory)

Captures the dynamic between characters over time:

| Field | Description |
|-------|-------------|
| `type` | Base relationship: romantic, familial, friendship, rivalry, professional |
| `status` | Current state: budding, stable, strained, broken, healing |
| `power_dynamic` | Who has the upper hand, if any |
| `events` | Timeline of relationship-changing moments |
| `tension` | Current unresolved conflicts |
| `intimacy_level` | Emotional closeness (1-10) |

**Example:**
```
/writer-memory rel add 새랑 해랑 romantic
/writer-memory rel update 새랑 해랑 "첫 키스 - 새랑 회피"
/writer-memory rel update 새랑 해랑 "해랑 고백 거절당함"
/writer-memory rel update 새랑 해랑 "새랑 먼저 손 잡음"
```

### 장면 메모리 (Scene Memory)

Tracks individual scenes and their emotional architecture:

| Field | Korean | Description |
|-------|--------|-------------|
| `title` | 제목 | Scene identifier |
| `characters` | 등장인물 | Who appears |
| `location` | 장소 | Where it happens |
| `cuts` | 컷 구성 | Shot-by-shot breakdown |
| `narration_tone` | 내레이션 톤 | Narrative voice style |
| `emotional_tag` | 감정 태그 | Primary emotions (e.g., "설렘+불안") |
| `purpose` | 목적 | Why this scene exists in the story |
| `before_after` | 전후 변화 | What changes for characters |

### 테마 메모리 (Theme Memory)

Captures the deeper meaning woven through your story:

From realsigridjin/oh-my-codex, MIT.

More from realsigridjin/oh-my-codex