# CLAUDE.md

Development instructions for the claude-plugins repository.

## Repository Structure

```
claude-plugins/
├── .claude-plugin/
│   └── marketplace.json       # Lists all plugins
├── plugins/
│   └── learn/                 # Learn plugin
│       ├── .claude-plugin/plugin.json
│       ├── commands/          # Slash commands
│       ├── hooks/             # Event hooks
│       ├── rules/             # Rule files
│       └── templates/         # Templates
├── README.md                  # Marketplace README
├── CLAUDE.md                  # This file
└── CHANGELOG.md               # Version history
```

## Adding a New Plugin

1. Create plugin directory:
   ```bash
   mkdir -p plugins/new-plugin/.claude-plugin
   mkdir -p plugins/new-plugin/commands
   ```

2. Create `plugins/new-plugin/.claude-plugin/plugin.json`:
   ```json
   {
     "name": "new-plugin",
     "description": "What the plugin does",
     "version": "1.0.0",
     "author": { "name": "Romfast Team" }
   }
   ```

3. Add to `.claude-plugin/marketplace.json`:
   ```json
   {
     "name": "new-plugin",
     "source": "./plugins/new-plugin",
     "description": "...",
     "version": "1.0.0",
     "keywords": [...]
   }
   ```

4. Create commands in `plugins/new-plugin/commands/`

## Testing

```bash
# Test specific plugin
claude --plugin-dir ./plugins/learn

# Verify commands appear
/learn:status
```

## Git

```bash
git remote: git@gitea.romfast.ro:romfast/claude-plugins.git
git push origin main
```

## Learn Plugin Details

See [plugins/learn/README.md](./plugins/learn/README.md) for full documentation.

Key files:
- `plugins/learn/commands/analyze.md` - Main analysis command
- `plugins/learn/commands/status.md` - Statistics display
- `plugins/learn/commands/import.md` - Import from other formats
- `plugins/learn/commands/reflect.md` - Cross-domain consolidation