adaptive-learning-agents

# Adaptive Learning Agent

**Learn from errors and corrections in real-time. Continuously improve by capturing failures, user feedback, and successful patterns.**

Free and open-source (MIT License) • Zero dependencies • Works locally

---

## 🚀 Why This Skill?

### Problem Statement
Working with Claude or any AI agent means encountering:
- Mistakes that need correction
- Unexpected API behaviors
- Better approaches discovered through experimentation
- Knowledge gaps that get revealed during use

But there's no systematic way to **learn from these moments** and apply the knowledge next time.

### The Solution
**Adaptive Learning Agent** captures every error, correction, and successful pattern automatically. Then retrieves relevant learnings before tackling similar problems again.

### Real Use Cases
- **Bug discovery**: Record an error once, never struggle with it again
- **Prompt optimization**: Keep track of what prompt variations work best
- **API integration**: Remember quirky behaviors and workarounds
- **Workflow improvement**: Document shortcuts and best practices
- **Team knowledge**: Export and share learnings across projects

---

## ✨ What You Get

### Four Core Functions

**1. Record Learnings**
```python
agent.record_learning(
    content="Use claude-sonnet for 90% of tasks—faster and cheaper",
    category="technique",
    context="Model selection"
)
```
Capture successful patterns, insights, and best practices.

**2. Record Errors**
```python
agent.record_error(
    error_description="JSON parsing failed on null values",
    context="Processing API response",
    solution="Add null check before parsing"
)
```
Document failures and solutions automatically.

**3. Search & Retrieve Learnings**
```python
results = agent.search_learnings("JSON parsing")
recent = agent.get_recent_learnings(limit=5)
by_category = agent.get_learnings_by_category("bug-fix")
```
Find relevant knowledge instantly when you need it.

**4. View Summaries**
```python
summary = agen