Folken2 The deck-style learning loop
The agent gets better at matching the user's deck style over time. The mechanism is a markdown topic called deck-style that accumulates fingerprints and gets compressed into rules.
Stage 1 — collect fingerprints (every kept slide)
For each kept slide, call learn_style_from_kept_slide(title, bullets, notes, layout_name). This appends a structured note like:
## Kept slide
- layout: Title and Content
- title: "Q3 revenue beat plan by 8%" (6 w)
- bullets: 4 (avg 7.5 w, max 9 w)
- notes: yes (ratio 1.8)
These are raw signals, not rules. Don't show them to the user; they're working memory.
A "kept slide" means: the user accepted the agent's generated slide, or applied a tightening with no further edits, or hit Insert-as-new-slide on a proposed slide. Edits before keep are also worth recording — the post-edit fingerprint is the gold-standard signal.
Stage 2 — consolidate (every ~10 samples)
When fingerprints accumulate, read them and derive durable rules. Then call consolidate_deck_style(distilled_markdown) with a tight rulebook.
A good rulebook looks like:
# User deck style — rulebook (v2)
## Bullets
- Default: 4 bullets per content slide.
- Length: average 7 words; cap at 10.
- Phrasing: parallel verb-led ("Cut", "Build", "Ship").
## Titles
- Statement titles, not labels.
- Average 6 words; cap at 10.
- No trailing punctuation.
## Speaker notes
- Always present on content slides.
- 2-4 lines; carry the narration, not the bullets.
- Notes-to-bullets word ratio ~1.5-2.0.
## Layouts
- "Title and Content" for body slides.
- "Section Header" for transitions only.
## Voice tics
- No exclamation marks. Convert ! → . if drafting.
- No emoji.
- Em-dashes — used sparingly.
Keep it under ~2KB. Rules the outlining and tightening tools can apply mechanically.
Stage 3 — when the user edits before keeping
If the taskpane reports an edit (kept slide differs from the proposed slide), that delta is the strongest learning signal. Save the delta as a memory note:
recall_memory → check for "edit-patterns" topic
save_memory(topic="edit-patterns", content="User cuts trailing periods on bullets. User shortens verb-phrases from 'Improving' to 'Improve'.")
These get folded into the rulebook on the next consolidation.
Anti-patterns
- Over-fitting to one slide. A single 3-bullet slide doesn't mean the user always wants 3 bullets. Wait for >=5 samples before claiming a rule.
- Treating layout choice as a rule. Layout depends on slide role. "User likes Title-and-Content" is meaningless — every content slide uses it.
- Burying durable rules in raw fingerprints. That's why Stage 2 exists. The rulebook is what
recall_deck_stylereturns to outlining and tightening; raw fingerprints should be pruned. - Forgetting to consolidate. If the deck-style topic grows past ~5KB, consolidate now.
- Confusing per-deck choices with per-user style. A pitch and a status update have different bullet styles; a per-intent override is fine, but don't promote a one-deck choice to a global rule.