Voice Generate

# Generation Pipeline Module

End-to-end generation flow from source material to reviewed text.

## Pipeline Stages

```
Source Material
    |
    v
[Frame as raw notes]
    |
    v
[Load profile + register + craft rules]
    |
    v
[Generate with Opus]
    |
    v
[Auto-fix: banned phrases, em dashes]
    |
    v
[Snapshot: pre-review] (if learning active)
    |
    v
[Dispatch review agents] (optional)
    |
    v
[Present advisories to user]
    |
    v
[Apply user decisions]
    |
    v
[Snapshot: post-review] (if learning active)
    |
    v
Final text (user may edit further)
    |
    v
[/voice-learn captures post-edit] (user-triggered)
```

## Auto-Fix Rules (Silent)

Applied immediately after generation, before review:

```bash
# Em dash replacement (context-aware)
# Before a clause: use comma or colon
# Parenthetical: use parentheses
# List separator: use semicolons

# Banned phrase removal
# "Furthermore," -> "" (start sentence without it)
# "It's important to note" -> "" (remove entirely)
# "delve" -> "explore" or "examine"
# "utilize" -> "use"
# "leverage" -> "use" or remove
# "comprehensive" -> "thorough" or "complete"
# "robust" -> "solid" or remove
# "seamless" -> "smooth" or remove
```

## Model Routing

| Stage | Model | Reason |
|-------|-------|--------|
| Generation | Opus | Tonal shifts, parenthetical subversion |
| Auto-fix | Regex/local | No model needed |
| Prose review | Sonnet | Structured detection prompts |
| Craft review | Sonnet | Structured evaluation prompts |
| Learning analysis | Opus | Nuanced pattern comparison |

## Error Recovery

If generation fails quality checks (> 5 hard failures):
1. Re-generate with stronger emphasis on banned phrases
2. If second attempt still fails, present to user with warning
3. Never loop more than twice (prevents infinite retry)

## Streaming Considerations

For long-form content (> 1000 words):
- Generate in sections (one per major heading)
- Apply auto-fix per section
- Allow user to review section-by-section or all at once
- Snapshot captures the complete assembled text


---
module: register-selection
category: voice-generation
dependencies: [Read, Bash]
estimated_tokens: 300
---

# Register Selection Module

Choose the appropriate voice register for generation.

## Selection Priority

1. **Explicit request**: User says "use casual register"
2. **Context match**: Register metadata matches the task
3. **Default**: Fall back to `registers/default.md`

## Context Matching

Each register file has a `## Context` section describing
when to use it. Match against the user's stated purpose:

```
User: "Write a blog post about..."     -> default or narrative
User: "Draft a technical doc for..."   -> technical
User: "Reply to this Reddit thread..." -> casual
User: "Write an email to my team..."   -> professional
```

## Register Loading

```bash
PROFILE_DIR="$HOME/.claude/voice-profiles/$PROFILE_NAME"
REGISTER_FILE="$PROFILE_DIR/registers/${REGISTER_NAME}.md"

if [ ! -f "$REGISTER_FILE" ]; then
  echo "Register '$REGISTER_NAME' not found. Available:"
  ls "$PROFILE_DIR/registers/"
  echo "Using default register."
  REGISTER_FILE="$PROFILE_DIR/registers/default.md"
fi
```

## Inheritance

Non-default registers inherit from default unless they
explicitly override a section. When loading a non-default
register:

1. Read `default.md` as base
2. Read `{name}.md` for overrides and additions
3. Merge: override sections replace, additions append

## Listing Available Registers

When user asks what registers exist:

```bash
echo "Available voice registers for $PROFILE_NAME:"
for f in "$PROFILE_DIR/registers/"*.md; do
  name=$(basename "$f" .md)
  context=$(grep -A1 "^## Context" "$f" | tail -1)
  echo "  $name: $context"
done
```


---
module: source-framing
category: voice-generation
dependencies: []
estimated_tokens: 400
---

# Source Framing Module

How