ea27f27f7f
- global CLAUDE.md (time tracking via MCP lesstime) - workspace CLAUDE.md (dev_malio inventory) - commands : ticket-writer, push-tickets-lesstime, full-project-review, bump-version - MCP install guide (Code + Desktop) + .mcp.json.example - scripts/install.sh + sync.sh
79 lines
3.4 KiB
Markdown
79 lines
3.4 KiB
Markdown
# 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/
|