# claude-config — Configuration Claude Code partagée Malio

Repo qui versionne **toute la configuration Claude Code** liée à l'écosystème Malio :

- Le `CLAUDE.md` global (règles communes à tous les projets, time tracking obligatoire via MCP Lesstime)
- Le `CLAUDE.md` de workspace `dev_malio/` (inventaire des projets, ports, conventions)
- Les **slash commands** custom (`ticket-writer`, `push-tickets-lesstime`, `full-project-review`, `bump-version`)
- La doc d'installation du **MCP Lesstime** pour Claude Code et Claude Desktop
- Un **template** de `.mcp.json` (token à remplacer)
- Un script d'install qui crée les symlinks depuis `~/.claude/`

> Le but : pouvoir cloner ce repo sur une nouvelle machine et retrouver instantanément la même config Claude pour bosser sur les projets Malio.

## Structure

```
claude-config/
├── README.md                ← ce fichier
├── .gitignore               ← exclut les vrais secrets (.mcp.json, credentials)
├── global/
│   └── CLAUDE.md            ← copie de ~/.claude/CLAUDE.md (règles globales)
├── workspace/
│   └── CLAUDE.md            ← copie de dev_malio/CLAUDE.md (inventaire projets)
├── commands/                ← slash commands user (~/.claude/commands/*.md)
│   ├── ticket-writer.md
│   ├── push-tickets-lesstime.md
│   ├── full-project-review.md
│   └── bump-version.md
├── mcp/
│   ├── INSTALL.md           ← guide install MCP Lesstime (Code + Desktop)
│   └── .mcp.json.example    ← template config MCP (sans token)
└── scripts/
    ├── install.sh           ← symlinks vers ~/.claude/
    └── sync.sh              ← repompe les changements locaux dans le repo
```

## Installation rapide

```bash
cd /home/matthieu/dev_malio/claude-config
./scripts/install.sh
```

Le script :
1. Sauvegarde l'existant (`~/.claude/CLAUDE.md`, `~/.claude/commands/`) dans `~/.claude/backup-<date>/`
2. Crée des symlinks de ce repo vers `~/.claude/`
3. Affiche les étapes manuelles restantes (créer `~/.claude/.mcp.json` à partir du template avec ton token Lesstime)

## Configurer le MCP Lesstime

1. Récupérer un token API personnel sur http://project.malio-dev.fr/profile
2. Copier le template : `cp mcp/.mcp.json.example ~/.claude/.mcp.json`
3. Remplacer `REPLACE_WITH_YOUR_LESSTIME_API_TOKEN` par le token

Détails complets dans [`mcp/INSTALL.md`](mcp/INSTALL.md), y compris l'install Claude Desktop (via `mcp-remote`).

## Synchroniser

Si tu modifies un fichier directement dans `~/.claude/` ou dans `dev_malio/CLAUDE.md`, lance :

```bash
./scripts/sync.sh
```

Le script recopie les sources locales dans le repo (sans toucher au `.mcp.json` réel). Tu n'as plus qu'à `git diff` / `git commit`.

## Règles de versionning

- **Ne jamais committer de secret** : `.mcp.json`, tokens, mots de passe → exclus par `.gitignore`
- **Bumper le `CLAUDE.md` global** quand on change une règle qui s'applique à tous les projets
- **Mettre à jour la doc MCP** (`mcp/INSTALL.md`) si la procédure de connexion change côté serveur Lesstime
- Les `CLAUDE.md` **par projet** restent dans leur projet respectif (Inventory, Lesstime, SIRH, Coltura, infra-postgres). Ce repo ne versionne que les configs **transverses**.

## Ressources

- Doc officielle Claude Code : https://docs.anthropic.com/claude-code
- Repo MCP Lesstime côté serveur : `dev_malio/Lesstime/src/Mcp/`
- Doc MCP : https://modelcontextprotocol.io/