feat: Initial release of claude-learn plugin v1.0.0
Commands: - /learn:analyze - Analyze conversation for patterns and gotchas - /learn:import - Import from other memory files (auto-build-memory.md, JSON) - /learn:reflect - Consolidate and clean memory - /learn:status - Show memory statistics Features: - Stop hook suggests /learn:analyze after significant sessions - Uses single memory file: .claude/rules/claude-learn-memory.md - Structured format for patterns (solutions) and gotchas (problems) - Import support for migrating existing memories 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
128
README.md
Normal file
128
README.md
Normal file
@@ -0,0 +1,128 @@
|
||||
# Claude Learn
|
||||
|
||||
A Claude Code plugin for capturing lessons learned during development sessions.
|
||||
|
||||
## Features
|
||||
|
||||
- **Automatic Detection**: Stop hook suggests capturing lessons after significant sessions
|
||||
- **Pattern & Gotcha Tracking**: Structured format for reusable solutions and problems to avoid
|
||||
- **Import Support**: Bring in existing memories from other formats
|
||||
- **Reflection Tools**: Consolidate and promote patterns to CLAUDE.md
|
||||
|
||||
## Installation
|
||||
|
||||
### Option 1: Marketplace (Recommended)
|
||||
|
||||
Add to your `~/.claude/settings.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"plugin-marketplaces": [
|
||||
"git@gitea.romfast.ro:romfast/claude-learn.git"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Then install:
|
||||
|
||||
```bash
|
||||
claude plugin install learn@romfast-tools
|
||||
```
|
||||
|
||||
### Option 2: Direct from Git
|
||||
|
||||
```bash
|
||||
git clone git@gitea.romfast.ro:romfast/claude-learn.git
|
||||
claude --plugin-dir /path/to/claude-learn/plugin
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/learn:analyze` | Analyze conversation and propose lessons |
|
||||
| `/learn:analyze auto` | Auto-detect all categories |
|
||||
| `/learn:analyze patterns` | Focus on patterns only |
|
||||
| `/learn:analyze gotchas` | Focus on gotchas only |
|
||||
| `/learn:import <file>` | Import from another memory file |
|
||||
| `/learn:reflect` | Consolidate and clean up memory |
|
||||
| `/learn:status` | Show memory statistics |
|
||||
|
||||
## Usage Flow
|
||||
|
||||
```
|
||||
1. Work normally with Claude Code
|
||||
↓
|
||||
2. Claude finishes a significant response
|
||||
↓
|
||||
3. Stop Hook analyzes (15s)
|
||||
↓
|
||||
4. "💡 Run /learn:analyze to capture lessons"
|
||||
↓
|
||||
5. User: /learn:analyze
|
||||
↓
|
||||
6. Claude lists proposals (patterns, gotchas)
|
||||
↓
|
||||
7. User selects: [1, 3, all, none]
|
||||
↓
|
||||
8. Claude updates .claude/rules/claude-learn-memory.md
|
||||
↓
|
||||
9. Periodically: /learn:reflect for consolidation
|
||||
```
|
||||
|
||||
## Memory File Format
|
||||
|
||||
The plugin creates and maintains `.claude/rules/claude-learn-memory.md` with this structure:
|
||||
|
||||
```markdown
|
||||
# Claude Learn Memory
|
||||
|
||||
## Patterns
|
||||
|
||||
### Pattern Title
|
||||
**Discovered**: 2025-01-06 (feature: user-dashboard)
|
||||
**Description**: What the pattern does and when to use it
|
||||
|
||||
**Example** (`src/components/Dashboard.vue:45-52`):
|
||||
\```vue
|
||||
<template>...</template>
|
||||
\```
|
||||
|
||||
**Tags**: vue, components, dashboard
|
||||
|
||||
---
|
||||
|
||||
## Gotchas
|
||||
|
||||
### Gotcha Title
|
||||
**Discovered**: 2025-01-06 (feature: api-integration)
|
||||
**Problem**: What went wrong
|
||||
**Solution**: How to fix it
|
||||
|
||||
**Tags**: api, axios, error-handling
|
||||
|
||||
---
|
||||
|
||||
## Memory Statistics
|
||||
|
||||
- **Total Patterns**: 5
|
||||
- **Total Gotchas**: 3
|
||||
- **Last Session**: 2025-01-06
|
||||
- **Sessions Recorded**: 8
|
||||
```
|
||||
|
||||
## Importing Existing Memories
|
||||
|
||||
If you have an existing memory file (e.g., from auto-build plugin):
|
||||
|
||||
```bash
|
||||
/learn:import .claude/rules/auto-build-memory.md
|
||||
```
|
||||
|
||||
Supported formats:
|
||||
- Markdown with `## Patterns` and `## Gotchas` sections
|
||||
- JSON with `{patterns: [], gotchas: []}` structure
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user