voice-learn

name	voice-learn
description	Improves a voice profile by learning from manual edits. Use after editing generated text to refine registers and close voice drift over time.
globs	**/*.{md,txt}
alwaysApply	false
category	writing-quality
tags	["voice","learning","improvement","feedback","iteration"]
tools	[]
complexity	high
model_hint	opus
estimated_tokens	2000
progressive_loading	true
modules	["modules/snapshot-management.md","modules/pattern-analysis.md"]
dependencies	["scribe:voice-extract","scribe:voice-generate","scribe:voice-review"]

Voice Learning Skill

Learn from user edits to improve the voice profile over time.

Method: Three-Stage Comparison

Every piece flows through three stages:

1. Pre-review: Raw generation output (before review agents)
2. Post-review: After user accepts/rejects advisory fixes
3. Post-edit: User's manually edited final version

The learning agent compares stages 2 and 3 (post-review vs post-edit) to identify patterns in what the user changed. These patterns inform register and rule updates.

Core Rules

1. Sharpen, don't add: Modify existing rules to cover new patterns. Rule bloat degrades output.
2. Tag specificity: Register-specific patterns go to registers. Universal patterns go to craft rules or agents.
3. Flag contradictions: Opposite patterns across pieces require user resolution.
4. Evidence threshold: Patterns need 3+ instances (or 1-2 matching existing accumulator entries) before becoming rules.
5. Detection surface: Structural changes increase AI detectability. Craft-level changes are neutral. Prefer craft-level updates.
6. Rule count check: Suggest consolidation if any section has 8+ rules.

Required TodoWrite Items

1. voice-learn:snapshots-loaded - All three stages read
2. voice-learn:diff-analyzed - Changes categorized
3. voice-learn:accumulator-checked - Prior patterns reviewed
4. voice-learn:proposals-generated - Updates proposed
5. voice-learn:user-approved - Changes accepted by user

Step 1: Load Snapshots

Load: @modules/snapshot-management

PROFILE_DIR="$HOME/.claude/voice-profiles/{name}"
SNAP_DIR="$PROFILE_DIR/learning/snapshots"

# Find the most recent snapshot set
# Format: {piece-name}-{timestamp}-{stage}.md

Read all three stages for the target piece.

Step 2: Diff Analysis

Load: @modules/pattern-analysis

Compare post-review vs post-edit. Categorize every change: