codebloom

# 🌸 Codebloom

> **Codebloom** — Parce qu'un bon projet commence par une graine bien plantée, et qu'avec les bons outils, le code éclot.

Un plugin [Claude Code](https://docs.anthropic.com/en/docs/claude-code) qui structure ton workflow de A à Z : setup, développement, debugging, review, déploiement. Compatible avec tout stack, tout projet.

## 📦 Installation

**1. Ajouter le marketplace :**
```bash
/plugin marketplace add vendeesign/codebloom
```

**2. Installer le plugin :**
```bash
/plugin install codebloom@codebloom
```

C'est tout. Les commandes et skills sont immédiatement disponibles dans tous tes projets.

### Mise à jour

```bash
/plugin marketplace update codebloom
/plugin update codebloom@codebloom
```

### Désinstallation

```bash
/plugin uninstall codebloom@codebloom
```

## 🧠 Philosophie

Codebloom intègre 4 principes comportementaux (inspirés d'[Andrej Karpathy](https://github.com/forrestchang/andrej-karpathy-skills)) dans chaque commande pour que Claude Code travaille **mieux** :

| Principe | Le problème qu'il résout |
|----------|--------------------------|
| 🔍 **Ne pas deviner** | Les LLM choisissent silencieusement quand c'est ambigu → Codebloom force à demander et montrer les tradeoffs |
| 🎯 **Code minimal** | Les LLM adorent over-engineer → 100 lignes quand 100 suffisent, pas 1000 |
| 🛡️ **Changements chirurgicaux** | Les LLM touchent du code non concerné → Codebloom interdit les modifications hors périmètre |
| ✅ **Vérifier avant de valider** | Les LLM disent "c'est fait" sans vérifier → Chaque commande exige un build/test |

## 🗂️ Commandes

### Cycle de vie

| Commande | Description |
|----------|-------------|
| `/setup [new\|existing\|refresh]` | 🚀 Setup interactif — nouveau projet, existant ou refresh. Argument optionnel pour accès direct. |
| `/hello` | 👋 Briefing de début de session — état du projet, tâches en cours, prochaines actions. |
| `/push` | 📤 Fin de session — met à jour doc + changelog + TODO.md, commit conventionnel, push. |

### Développement

| Commande | Description |
|----------|-------------|
| `/feature [description]` | ✨ Implémenter une feature avec plan → validation → code → vérification. |
| `/fix [description]` | 🐛 Debugging méthodique : comprendre → isoler → corriger → documenter dans le changelog. |
| `/test [cible]` | 🧪 Générer des tests pertinents pour un fichier, module ou feature. |
| `/todo [texte\|go\|ideas]` | 📋 Backlog rapide — noter, afficher, exécuter les tâches ou explorer les idées du `TODO.md`. |

### Qualité

| Commande | Description | Built-in utilisé |
|----------|-------------|-------------------|
| `/clean [cible]` | ✂️ Simplification + refactoring : nettoyer, restructurer, dégraisser. | Étend `/code-simplify` |
| `/review [cible]` | 🔍 Review complète avec consignes avancées + score /10. | Étend `/code-review` |
| `/audit` | 🏥 Audit de santé global : deps, sécu, archi, tests, doc, code mort. | — |
| `/deploy [cible]` | 🚀 Checklist pré-déploiement et accompagnement. | — |

> 💡 `/review` et `/clean` étendent les commandes built-in de Claude Code avec des consignes supplémentaires (principes Karpathy, conventions CLAUDE.md, DESIGN_SYSTEM.md).

## 🧩 Skills (auto-invoquées)

Les skills sont des guides contextuels que Claude charge **automatiquement** quand le contexte correspond — sans que tu aies à taper de commande.

| Skill | Se charge quand... |
|-------|---------------------|
| 🎙️ `interview` | Besoin flou ou complexe, demande explicite de cadrage |
| 🎯 `code-quality` | Claude écrit ou modifie du code |
| 📝 `git-conventions` | Opérations git (commits, branches, PRs) |
| 📄 `doc-sync` | Changements significatifs dans le code |
| 🔒 `security-first` | Code touchant auth, inputs, API, secrets, gestion d'erreurs |
| 📦 `dependency-check` | Ajout d'une nouvelle dépendance |
| ♿ `accessibility` | Code UI (HTML, JSX, composants, formulaires, navigation) |

> 💡 Les commandes sont des **workflows explicites** (tu les lances). Les skills sont des **garde-fous implicites** (elles se chargent toutes seules quand c'est pertinent).

## 🔔 Hooks (notifications audio + visuelles)

Codebloom inclut des hooks cross-platform qui te notifient quand Claude :
- **Termine une action** → son discret + flash visuel
- **A besoin de ton retour** (permission, question, idle) → son d'alerte + flash visuel

| Plateforme | Audio | Visuel |
|------------|-------|--------|
| **Windows** | SystemSounds | Flash orange dans la barre des tâches |
| **macOS** | afplay (sons système) | Notification centre de notifications |
| **Linux** | paplay / terminal bell | notify-send (notification desktop) |

Fonctionne automatiquement sur **macOS**, **Linux** et **Windows**. Aucune configuration nécessaire — les hooks s'activent à l'installation du plugin.

## 📚 Fichiers de référence

`/setup` crée ces fichiers à la racine de ton projet. Claude les consulte automatiquement pour respecter tes conventions :

| Fichier | Rôle | Créé par |
|---------|------|----------|
| `TODO.md` | 📋 Backlog — bugs, tâches, idées, historique | `/setup`, `/todo` |
| `CHANGELOG.md` | 📋 Historique des versions ([Keep a Changelog](https://keepachangelog.com/)) | `/setup` |
| `DESIGN_SYSTEM.md` | 🎨 Charte graphique — couleurs, typo, spacing, composants | `/setup` |
| `API_DOC.md` | 📡 Documentation API — endpoints, auth, erreurs | `/setup` |

Les templates sont dans `references/`.

## 🔄 Workflow type

```
/setup          ← Démarrage du projet (une fois)
    ↓
/hello          ← Début de chaque session
    ↓
/feature ...    ← Développer
/fix ...        ← Corriger
/test ...       ← Tester
/todo ...       ← Noter un bug, tâche ou idée
/todo go        ← Exécuter les tâches du backlog dans l'ordre
    ↓
/clean          ← Nettoyer le code
/review         ← Vérifier la qualité
/audit          ← Santé globale (régulièrement)
    ↓
/push           ← Fin de session
    ↓
/deploy         ← Mise en production
```

## ⚙️ Prérequis

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installé
- Git configuré
- Plugins Claude Code requis : `/code-review` et `/code-simplifier`

## 🤝 Contribuer

Les commandes et skills sont des fichiers Markdown — faciles à lire, modifier et partager.
Les PR sont les bienvenues.

## 💜 Soutenir le projet

Si Codebloom t'aide au quotidien, tu peux soutenir son développement :

**Solana (SOL)** : `CNJ81Uz9mjeudEcV2xcqPzwT9WPDLB3sifjfpLcbSWzw`