---
version: 0.8.1
feature_pitch:
  headline: "Your brain skills learned from production"
  description: "Back-linking iron law, filing rules, enrichment protocol, media ingest, citation requirements, voice crash fixes -- all battle-tested from real production deployments. Superseded by v0.9.0."
---

# v0.8.1 Migration: Battle-Tested Skill Patterns

This migration updates your agent's brain-writing patterns and voice recipe.
No schema changes, no database migrations. Skills and recipes only.

## What's New

### Back-Linking Iron Law
Every skill that writes to the brain now enforces bidirectional linking. If a
page mentions a person or company, that entity's page MUST link back. This was
the single biggest knowledge graph integrity rule missing from v0.8.0.

### Brain Filing Rules (`skills/_brain-filing-rules.md`)
Cross-cutting rules for where brain pages go. File by PRIMARY SUBJECT, not
format or source. Includes common misfiling patterns table and notability gate.

### Enrichment Protocol (rewritten)
The enrich skill is now a full 7-step pipeline with 3-tier system (scale effort
to entity importance), person page section template (What They Believe, Building,
Motivates, Hobby Horses, Trajectory), pluggable data source table, and validation.

### Media Ingestion Workflows
The ingest skill now handles articles, videos, podcasts, PDFs, screenshots, and
social media content. Each with a complete input->process->write workflow.

### Citation Requirements
Every fact needs inline `[Source: ...]` citations across all skills. Three formats
defined (direct, API/external, synthesis) with source precedence hierarchy.

### Voice Recipe Production Fixes
Critical fixes from a production voice deployment: unicode crash fix (non-ASCII
breaks Twilio WebSocket), PII scrub from voice context, identity-first prompt
architecture, Smart VAD default, auto-upload call audio, and the DIY STT+LLM+TTS
pipeline (Deepgram+Claude+Cartesia) as an alternative to OpenAI Realtime.

### X-to-Brain Recipe Enhancements
Image OCR via vision models, real-time monitoring via Filtered Stream API,
6-dimension tweet rating rubric, outbound tweet monitoring, X-to-Brain automatic
pipeline, and cron staggering for resource management.

## Agent Instructions

### Step 1: Verify skills are updated

Check that your skills directory has the new files:
```bash
ls skills/_brain-filing-rules.md && echo "Filing rules: OK"
grep -q '"version": "0.8.1"' skills/manifest.json && echo "Manifest: OK"
```

Files that should be updated:
- `skills/_brain-filing-rules.md` (new)
- `skills/enrich/SKILL.md` (rewritten)
- `skills/ingest/SKILL.md` (expanded)
- `skills/maintain/SKILL.md` (expanded)
- `skills/query/SKILL.md` (updated)
- `skills/briefing/SKILL.md` (updated)
- `recipes/twilio-voice-brain.md` (v0.8.1 production fixes)
- `recipes/x-to-brain.md` (v0.8.1 enhancements)

### Step 2: Review existing brain pages for back-link gaps

Spot-check: pick 5 recently created pages and verify that every entity mentioned
has a back-link from the entity's page to the mentioning page.

If back-links are missing, add them:
```
- **YYYY-MM-DD** | Referenced in [page title](path/to/page.md) -- brief context
```

### Step 3: Review filing

Check for pages in `sources/` that should be in a subject-specific directory
(people/, companies/, concepts/, civic/). See `skills/_brain-filing-rules.md`.

### Step 4: Voice recipe (if using)

If you have voice-to-brain set up:
1. Apply the unicode sanitization fix to your voice server
2. Add PII scrub to your prompt builder
3. Move identity to the TOP of your system prompt
4. Consider switching to Smart VAD (Silero) as default

### Step 5: X-to-brain recipe (if using)

If you have X-to-brain set up:
1. Add image OCR to your tweet processing pipeline
2. Consider Filtered Stream API for real-time monitoring
3. Stagger your cron schedules (max 1 per minute)

### Step 6: Done

```bash
mkdir -p ~/.gbrain/migrations
echo '{"version":"0.8.1","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","status":"complete"}' >> ~/.gbrain/migrations/completed.jsonl
```
