Learner

Learner - Auto-Discover Patterns

What This Skill Does

Analyzes reflexion episodes to automatically discover:

1. Causal patterns - What actions lead to successful outcomes
2. Skills - Reusable procedures from successful episodes
3. Patterns needing review - Low-performing or conflicting patterns

Run this AFTER completing a feature to consolidate learnings.

Quick Reference

# Discover causal patterns from episodes
npx agentdb learner run 3 0.6 0.7

# Consolidate skills from successful episodes
npx agentdb skill consolidate 3 0.7 7 true

# Prune old/low-quality data
npx agentdb reflexion prune 90 0.5

# View database statistics
npx agentdb db stats

Primary Method: Discover Patterns

Auto-discover causal patterns from reflexion episodes:

npx agentdb learner run 3 0.6 0.7

Parameters (positional)

Examples

Standard discovery:

npx agentdb learner run 3 0.6 0.7

Aggressive (more patterns, lower thresholds):

npx agentdb learner run 2 0.5 0.6

Conservative (fewer, higher-confidence patterns):

npx agentdb learner run 5 0.8 0.9

Dry run (preview without storing):

npx agentdb learner run 3 0.6 0.7 true

Consolidate Skills

Automatically creates reusable skills from successful episodes:

npx agentdb skill consolidate 3 0.7 7 true

Parameters (positional)

Examples

Standard consolidation:

npx agentdb skill consolidate 3 0.7 7 true

Higher thresholds, longer window:

npx agentdb skill consolidate 5 0.8 14 true

Query Discovered Patterns

View Causal Edges

npx agentdb causal query

With filters:

# Filter by cause
npx agentdb causal query "Source trait" "" 0.7 0.1 20

# Filter by minimum confidence and uplift
npx agentdb causal query "" "" 0.8 0.2 10

Search Skills

npx agentdb skill search "data ingestion" 5

Prune Low-Quality Data

Prune Old Episodes

# Remove episodes older than 90 days with reward < 0.5
npx agentdb reflexion prune 90 0.5

Prune Low-Confidence Causal Edges

# Remove edges with confidence < 0.5, uplift < 0.05, older than 90 days
npx agentdb learner prune 0.5 0.05 90

Prune Underperforming Skills

# Remove skills with < 3 uses, < 40% success rate, older than 60 days
npx agentdb skill prune 3 0.4 60

Memory Optimization

Consolidate and compress pattern memory:

npx agentdb optimize-memory --compress true --consolidate-patterns true

Post-Feature Workflow

Run after completing a feature:

# 1. Discover causal patterns
npx agentdb learner run 3 0.7 0.8

# 2. Consolidate skills
npx agentdb skill consolidate 3 0.7 7 true

# 3. View what was learned
npx agentdb db stats

# 4. (Optional) Search discovered skills
npx agentdb skill search "feature-topic" 5

Understanding Results

Causal Edges

Learner creates cause-effect relationships:

Cause: "Using Source trait with health_check"
Effect: "Reliable data ingestion with automatic recovery"
Uplift: 0.35 (35% improvement)
Confidence: 0.92

Skills

Consolidated from successful episodes:

Name: "http-source-implementation"
Description: "Implement HTTP polling source with retry"
Success Rate: 0.89
Uses: 7

Thresholds Guide

For min-attempts

For min-success-rate

For min-confidence

Maintenance Schedule

Advanced: Causal Experiments

For A/B testing approaches:

# Create experiment
npx agentdb causal experiment create "batch-size-test" "batch_size_1000" "memory_usage"

# Add observations
npx agentdb causal experiment add-observation 1 true 0.15   # treatment
npx agentdb causal experiment add-observation 1 false 0.45  # control

# Calculate results
npx agentdb causal experiment calculate 1

The Pattern Workflow

1. BEFORE work:  get-pattern  → Search for relevant patterns
2. DURING work:  Apply patterns, note gaps
3. AFTER work:   reflexion    → Record what helped
                 save-pattern → Store NEW discoveries manually
                 learner      → Auto-discover patterns (THIS SKILL)

Related Skills

• get-pattern - Search patterns BEFORE work
• save-pattern - Store NEW patterns manually
• reflexion - Record feedback that feeds learner

What NOT to Use This For

Learner is for AUTOMATIC discovery, not manual pattern management.