En résumé
Le contributeur principal développe Linkr avec VS Code et Claude Code, sur les modèles Opus, et le dépôt est préparé pour cet usage — mais c’est une façon de faire, pas une obligation. Vous installez Linkr depuis les sources, vous travaillez sur votre branche, et chaque tâche confiée à Claude tourne dans son propre worktree — plusieurs agents peuvent ainsi avancer en parallèle sans se gêner. Trois skills du dépôt couvrent la relecture du code, les alertes de sécurité et la documentation.
Pas besoin d'écrire du code pour aider
Signaler un bug, dire qu’un écran prête à confusion, décrire un cas d’usage que Linkr gère mal : tout cela se fait par une issue, sur FramaGit ou sur le miroir GitHub. Le fichier CONTRIBUTING.md du dépôt détaille ces contributions. Cette page s’adresse à celles et ceux qui veulent modifier le code.
Les outils
Le contributeur principal travaille dans VS Code, avec l’extension Claude Code et les modèles Opus d’Anthropic, choisis avec la commande /model. C’est pour cet environnement que le dépôt est préparé aujourd’hui : ses consignes et ses skills sont écrits pour Claude Code.
Ce n’est pas une obligation : vous pouvez utiliser l’éditeur, l’assistant et le modèle de votre choix. Ce que Claude Code apporte en plus, c’est le contexte : il lit en ouvrant le dépôt le fichier CLAUDE.md, qui renvoie aux conventions de code (docs/conventions.md), aux composants d’interface à réutiliser (docs/ui-patterns.md) et à l’architecture (docs/architecture.md). Il applique ces règles sans que vous ayez à les rappeler.
Cet outillage est amené à évoluer. Un fichier AGENTS.md — le format ouvert que lisent la plupart des assistants de code — est notamment prévu, pour que ces consignes servent à n’importe quel agent et que le dépôt dépende moins de Claude Code.
Installer Linkr depuis les sources
Pour développer, Linkr s’installe en mode serveur, depuis les sources : vous clonez le dépôt, installez les dépendances Node.js et Python, et une seule commande lance le backend et le frontend avec rechargement à chaud. La procédure complète, pas à pas, est dans Installation manuelle.
git clone https://framagit.org/interhop/linkr/linkr.git
cd linkr
npm installSi vous comptez aussi toucher à la documentation, clonez le dépôt du site à côté de celui de Linkr, dans le même dossier parent :
git clone https://framagit.org/interhop/linkr/linkr-website.gitTravailler sur une branche
Créer votre branche
Partez de la branche de développement et créez la vôtre, nommée d’après ce que vous faites :
git checkout -b feature/export-csvConfier les tâches à Claude
Ouvrez le dépôt dans VS Code, lancez Claude Code et décrivez ce que vous voulez. Pour toute nouvelle tâche, Claude crée un worktree : une copie de travail du dépôt, dans un dossier voisin, avec sa propre sous-branche, ses propres ports et son propre dossier de données. Le worktree part de votre branche telle qu’elle est commitée : ce qui n’est pas commité ne le suit pas.
# dossier ../linkr-export-csv-dialog, branche feature/export-csv-dialog
npm run worktree:new -- export-csv-dialogLancer et relire
Claude ne lance jamais l’application lui-même : il vous donne la commande à coller dans un nouveau terminal VS Code, l’adresse du frontend, et le moyen d’ajouter le worktree à votre fenêtre (Fichier › Ajouter un dossier à l’espace de travail…) pour voir ses fichiers et ses modifications.
Fusionner
Une fois la tâche terminée et relue, vous fusionnez sa branche dans la vôtre, depuis votre dossier principal, puis vous supprimez le worktree :
git merge feature/export-csv-dialog
npm run worktree:remove -- export-csv-dialog --branchPlusieurs agents en même temps
C’est tout l’intérêt des worktrees : chaque agent a ses fichiers, son git status et son application qui tourne, sans voir les modifications en cours des autres. Vous pouvez lancer trois tâches dans trois conversations Claude Code, et les fusionner dans votre branche au fur et à mesure qu’elles aboutissent. Le détail est dans docs/worktrees.md.
Quand votre branche est prête, poussez-la et ouvrez une merge request sur FramaGit. Au moment du git push, des hooks lancent les contrôles de qualité — lint, typage, tests — et bloquent la poussée si l’un d’eux échoue.
Les skills
Un skill est un ensemble d’instructions rangé dans le dépôt (.claude/skills/), que Claude Code charge quand vous tapez son nom précédé d’une barre oblique. Le dépôt en contient plusieurs ; trois servent au quotidien.
/code-review
Une relecture structurée des derniers changements : sécurité, qualité du code, cohérence avec le reste de l’application, commentaires inutiles, respect des conventions. Claude reprend là où la relecture précédente s’était arrêtée — chaque passage est consigné, avec sa date et le dernier commit relu, dans REVIEW-LOG.md. À lancer avant de pousser une série de modifications, ou avant une version.
/dependabot-triage
Le tri des alertes de sécurité Dependabot du miroir GitHub. Claude classe chaque alerte — déjà corrigée une fois la branche fusionnée, faux positif, bloquée en amont, ou à corriger — puis propose le correctif ou la clôture, et note chaque décision dans TRIAGE-LOG.csv pour ne jamais retraiter la même alerte. Il faut un accès au dépôt GitHub et une session gh auth login : ce skill concerne surtout les mainteneurs.
/update-website-docs
La mise à jour de cette documentation, quand une fonctionnalité change ou qu’une page manque. Claude lit le code de l’application pour reprendre les libellés exacts de l’interface, écrit la page en français et en anglais, met à jour la navigation, et vérifie les liens et la compilation du site. Il suppose que linkr-website est cloné à côté de linkr.
Jamais de données de patients
Ni dans une issue, ni dans une capture, ni dans un fichier d’exemple, ni dans une conversation avec un assistant — même partiellement dé-identifiées. Travaillez avec les données de démonstration.
Pour aller plus loin
- Installation manuelle — installer Linkr depuis les sources.
- Modes de déploiement — ce qui change entre le navigateur seul et le serveur.
- Skills — les skills côté utilisateur, pour piloter Linkr depuis un agent.