# CLAUDE.md

Development instructions for the claude-learn plugin.

## Project Structure

```
claude-learn/
├── .claude-plugin/marketplace.json  # Marketplace entry
├── plugin/                          # Plugin code
│   ├── .claude-plugin/plugin.json   # Plugin manifest
│   ├── commands/                    # Slash commands
│   ├── hooks/                       # Event hooks
│   ├── rules/                       # Rule files
│   └── templates/                   # JSON templates
├── README.md                        # User documentation
├── CLAUDE.md                        # This file
└── CHANGELOG.md                     # Version history
```

## Key Decisions

1. **Single Memory File**: Plugin uses only `.claude/rules/claude-learn-memory.md`
2. **Import for Migration**: Use `/learn:import` to bring in existing memories
3. **User Confirmation**: Always list proposals before saving
4. **Stop Hook**: Suggests, doesn't auto-run

## Testing

```bash
# Test locally
claude --plugin-dir ./plugin

# Verify commands appear
/learn:status
```

## Release Process

1. Update version in `plugin/.claude-plugin/plugin.json`
2. Update version in `.claude-plugin/marketplace.json`
3. Update CHANGELOG.md
4. Commit and push to main
5. Tag release: `git tag v1.0.0 && git push --tags`