Je recommande d’étudier et forker une sélection ciblée de dépôts GitHub (harnesses, prompts, skills, workflows) pour maîtriser Claude Code et ses patterns d’orchestration (ex : everything-claude-code, learn-claude-code). Consultez les pages projets sur GitHub et la documentation officielle pour vérification.
Quels sont les dépôts essentiels à connaître
Je sélectionne six dépôts pratiques pour maîtriser Claude Code, complémentaires entre tutoriels, prompts, stacks d’intégration et collections curatives.
Je présente everything-claude-code : Objectif de centraliser exemples et skills prêts à l’emploi, public = développeurs et product owners. Structure typique = dossiers /skills, /examples, README.md. Exemple d’usage = cloner un skill de parsing pour le tester localement. Intégration = adapter les handlers vers l’API Claude Code.
README (extrait)
# Everything Claude Code
But : Collection de skills et templates pour Claude Code.
Usage : Copier un dossier /skills et adapter le endpoint.
git clone https://github.com/example/everything-claude-code.git
# Pour forker : utiliser l'UI GitHub et cloner votre fork
- Télécharger le repo, installer dépendances (npm/pip), configurer clé Claude.
- Lancer le serveur de dev et appeler le skill via HTTP.
- Adapter le handler pour retourner des messages structurés compatibles Claude Code.
Je présente system-prompts-and-models-of-ai-tools : Objectif de fournir prompts systèmes et cartes de modèles, public = ingénieurs ML et prompt engineers (ingénieurs prompts). Structure = /prompts, /models.yaml, exemples d’évaluation. Intégration = importer prompts comme « system » messages dans Claude Code.
README (extrait)
# System Prompts
But : Bibliothèque de prompts système et métadonnées de modèles.
Usage : Charger prompts depuis /prompts pour tests A/B.
git clone https://github.com/example/system-prompts-and-models-of-ai-tools.git
- Choisir un prompt, l’injecter en tant que system message dans l’appel Claude.
- Comparer sorties entre modèles via scripts d’évaluation fournis.
- Versionner variations pour reproductibilité.
Je présente gstack : Objectif = boilerplate full-stack pour apps IA, public = développeurs full-stack. Structure = /frontend, /backend, infra-as-code. Exemple = déployer une UI qui orchestre skills Claude Code. Intégration = SDK Claude côté backend.
README (extrait)
# GStack
But : Starter full-stack pour intégrer LLMs et pipelines.
Usage : Déployer stack et brancher Claude Code côté API.
git clone https://github.com/example/gstack.git
- Installer et déployer localement (docker-compose).
- Configurer clé Claude dans le backend.
- Appeler skill Claude depuis l’UI et monitorer logs.
Je présente get-shit-done : Objectif = templates rapides et checklists pour features IA, public = PM et devs pressés. Structure = /templates, /checklists, exemples de PR. Intégration = templates de PR pour features Claude Code.
README (extrait)
# Get Shit Done
But : Templates et checklists pour livrer rapidement.
Usage : Copier checklist et adapter pour tests Claude Code.
git clone https://github.com/example/get-shit-done.git
- Choisir template, remplir critères d’acceptation.
- Ajouter tests d’intégration Claude Code.
- Créer PR et suivre checklist.
Je présente learn-claude-code : Objectif = tutoriels pas-à-pas, public = débutants en Claude Code. Structure = /tutorials, notebooks, vidéos. Exemple = tutoriel « Créer un skill simple ». Intégration = suivre notebooks pour exécuter appels Claude.
README (extrait)
# Learn Claude Code
But : Tutoriels et notebooks pour apprendre Claude Code.
Usage : Suivre notebooks et exécuter exemples en local.
git clone https://github.com/example/learn-claude-code.git
- Lancer notebook, configurer clé, exécuter cellule d’appel Claude.
- Modifier prompt et observer variations de réponse.
- Valider comportement attendu via tests fournis.
Je présente awesome-claude-code : Objectif = repo curatif listant ressources, public = tous publics. Structure = README index, liens classés. Exemple = trouver intégrations CI, SDKs, articles. Intégration = ressource pour assembler stack et best practices.
README (extrait)
# Awesome Claude Code
But : Liste curative de ressources, outils et articles.
Usage : Naviguer par catégorie pour trouver exemples et libs.
git clone https://github.com/example/awesome-claude-code.git
- Rechercher la rubrique qui vous intéresse.
- Cloner ou linker les projets utiles à votre stack.
- Contribuer en proposant nouveaux liens.
| Dépôt | But | Complexité | Requis | Usage recommandé |
| everything-claude-code | Exemples et skills | Moyenne | Node/Python, clé Claude | Tester skills rapidement |
| system-prompts-and-models-of-ai-tools | Prompts & modèles | Basse à moyenne | Connaissance prompts | Optimiser comportement |
| gstack | Full-stack boilerplate | Élevée | Docker, infra | Déployer app production |
| get-shit-done | Templates & checklists | Basse | Processus dev | Livrer features vite |
| learn-claude-code | Tutoriels | Basse | Notebooks, clé | Apprendre pas-à-pas |
| awesome-claude-code | Curations | Basse | Navigation web | Référence globale |
Comment structurer un harness et des skills
Je définis un harness performant comme la combinaison d’agents, de skills, de hooks, d’une configuration mémoire et de règles MCP (Modes, Contraintes, Politiques) pour l’orchestration et la sécurité.
Architecture technique. Les agents orchestrent les appels LLM et orchestrent les skills (micro-fonctions spécialisées). Les skills exposent un contrat d’entrée/sortie JSON strict. Les hooks sont des points d’extension pré/post pour validation, enrichissement et observabilité. La mémoire stocke embeddings et événements, compressés et versionnés. Les règles MCP définissent le mode (sync/async), les contraintes (tokens, coût) et les politiques (sécurité, confidentialité).
Exemple minimal de configuration (YAML).
harness:
name: "project-harness"
mode: "async" # Mode d'exécution: sync|async
memory:
backend: "redis"
embedding_model: "text-embedding-3-small"
ttl_days: 90
agents:
- id: "planner"
skill_chain: ["summarize", "search", "format"]
mcp:
max_tokens: 2000
allowed_domains: ["example.com"]
Exemple de skill en JavaScript. Interface: input {user, context}, output {result, metadata}.
// skill/summarize.js
module.exports = async function summarizeSkill(input){
// Input attendu: { user: {...}, context: "long text" }
const text = input.context || "";
const result = text.slice(0, 1000); // Remplacement simple d'un LLM
return { result, metadata: { length: text.length } };
};
// Test unitaire minimal (node)
if (require.main === module){
(async ()=>{
const out = await module.exports({context: "Bonjour monde".repeat(10)});
console.assert(out.result.length>0, "Résumé vide");
console.log("Test passed");
})();
}
Exemple de hook (pré/post-processing).
// hooks/filterDomains.js
module.exports = {
pre: (input) => {
// Filtre URLs sensibles avant d'appeler le skill
if (input.url && input.url.includes("restricted.com")) throw new Error("Domaine restreint");
return input;
},
post: (output) => {
// Ajoute traçabilité minimale
output.metadata = output.metadata || {};
output.metadata.timestamp = new Date().toISOString();
return output;
}
};
Gestion mémoire — recommandations.
- Utilisez la vectorisation (embeddings) pour indexer le contexte et réduire les tokens envoyés à l’LLM.
- Compressez les blocs longs via résumé ou modèles de distillation avant stockage pour économiser espace et coûts.
- Appliquez TTL par niveau: 30 minutes pour le contexte de session, 7–30 jours pour le contexte utilisateur actif, 90 jours max pour logs, selon conformité (RGPD).
- Versionnez les entrées critiques et chiffrez au repos; journalisez les accès pour audit.
Tableau récapitulatif des fichiers et responsabilités.
| harness.yaml | Configuration globale: agents, mémoire, MCP |
| skills/*.js | Fonctions spécialisées exposant contrat I/O JSON |
| hooks/*.js | Pré/post-processing, validation, enrichissement |
| memory/ | Backend d’embeddings, index, règles de TTL et sauvegarde |
Comment concevoir des prompts système et des outils
Le comportement agentique s’organise autour de prompts système et d’outils externes ; le dépôt system-prompts-and-models-of-ai-tools sur GitHub est un bon modèle pour jouer ce rôle en pratique.
Principes de conception de prompts système :
- Définir un rôle clair : Indiquer qui est l’agent (ex. « Vous êtes un expert DevOps ») et quel niveau d’expertise attendre.
- Imposer des contraintes : Préciser limites à respecter (sécurité, format de sortie, tokens maximum).
- Fixer le style : Ton, concision, usages des balises de code ou des tableaux.
- Rendre variables explicites : Utiliser des placeholders comme {{project_name}} pour la réutilisabilité.
Définition d’outils externes :
- API wrappers : Petit code qui convertit appels internes en requêtes HTTP vers un service externe.
- Commandes exposées : Commandes shell ou slash commands intégrées à un IDE pour exécuter des actions concrètes.
- Manifest d’outil : Fichier déclaratif (JSON) listant nom, permissions, entrées/sorties et limites.
Exemples pratiques de prompt templates :
Instruction projet:
Vous êtes le lead technique pour {{project_name}}. Fournir plan de livraison en 3 phases, risques principaux et 5 tâches prioritaires, chacune avec estimation en jours ouvrés.
Vérification QA:
Vous êtes un ingénieur QA. Exécuter checklist pour {{feature}}: scénarios critiques (5), critères d'acceptation, tests non-fonctionnels à exécuter.
Génération de changelog:
Générer changelog pour version {{version}} à partir des commits fournis. Classer par type (Ajout, Correction, Breaking), inclure portée et auteur.
Exemple de manifest d’outil (JSON) et wrapper Python :
{
"name": "issue-tracker",
"description": "Créer et lier issues",
"inputs": ["title","body","labels"],
"permissions": ["issues:create"]
}
import requests
API_URL = "https://api.example.com/issues"
def create_issue(title, body, labels, token):
"""Créer une issue via l'API REST."""
headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
payload = {"title": title, "body": body, "labels": labels}
resp = requests.post(API_URL, json=payload, headers=headers, timeout=10)
resp.raise_for_status()
return resp.json()
Exemple de slash command pour IDE :
/create-issue "Titre" "Description" labels=bug,urgent
| Scénario | Préférence |
| Contrainte de comportement global (sécurité, ton) | Prompt système |
| Tâches réutilisables avec logique | Skill (capabilité interne) |
| Actions externes nécessitant données réelles | Outil externe (API/command) |
Comment orchestrer des rôles et workflows
L’orchestration par rôles (CEO, Designer, Engineering Manager, QA) permet coordination et responsabilité claires : chaque rôle a des responsabilités, des entrées/sorties définies et des critères d’acceptation mesurables.
Je modélise un rôle selon trois axes essentiels :
- Responsabilités — Tâches et décisions prises par le rôle (ex : le Designer valide l’UI/UX).
- Input/Output — Données attendues et livrables produits (ex : maquette Figma → spec d’implémentation JSON).
- Critères d’acceptance — Conditions mesurables pour marquer une étape « done » (ex : tests unitaires ≥90%, checklist UX = OK).
Gstack montre une implémentation pratique avec skills réutilisables et commandes slash : chaque skill encapsule une capacité (ex : « generate-spec ») et s’appelle via /commands depuis un orchestrateur. Cette approche facilite la réutilisation et la composition.
Workflow multi-étapes inspiré de get-shit-done :
- Discussion — Alignement des objectifs et risques.
- Planification — Découpage, estimations, gating.
- Exécution — Agents et subagents exécutent les tasks.
- Vérification — QA automatique + revue manuelle.
- Shipping — Release et post-mortem.
Diagramme textuel du flow:
CEO --> Discussion --> Planification --> Engineering Manager
Engineering Manager --> Exécution (Agent A, Subagent B) --> Vérification (QA)
QA --> Gate: Accept / Reject --> Shipping
Contexte: résumé/state-store entre chaque transition
Exemple de script d’orchestration (bash pseudo) avec gestion d’erreurs et fallback :
# Orchestrator.sh
# Appel skill "plan"
if ! gstack skill run plan --input plan.json > plan.out; then
echo "Plan failed, fallback to manual-plan" >&2
gstack skill run manual-plan --input minimal.json || exit 1
fi
# Appel skill "implement" avec passage du résumé contextuel
gstack skill run implement --input "$(jq .summary plan.out)" > impl.out || {
echo "Implementation failed, creating hotfix task" >&2
gstack skill run create-task --input '{"title":"hotfix","priority":"high"}'
}
# Appel QA
gstack skill run qa --input impl.out || {
echo "QA failed, gate closed" >&2
exit 2
}
# Shipping
gstack skill run ship --input impl.out || exit 3
Patterns de handoff entre rôles (checklists, gates) :
- Checklists — Liste courte, binaire, signée par le suivant (ex : checklist QA = tests passés, perf OK).
- Gates — Conditions automatisées qui bloquent la pipeline (ex : coverage gate close).
- Handoff metadata — Toujours transmettre résumé (≤300 tokens), artifacts clefs et ticket référent.
| Pratique | Pourquoi |
| Persist résumé + state-id | Réduit la dérive de session et limite la taille des prompts |
| Tensorial checkpoints (snapshots) | Permet rollback et récupération de contexte cohérent |
| Limits & refresh | Forcer résumé toutes les N étapes pour compacter l’historique |
| Audit logs | Traçabilité des décisions et points de reprise |
Comment monter en compétence et réutiliser des ressources
Pour monter en compétence sur Claude Code, privilégiez une approche pratique : apprendre via des dépôts pédagogiques, centraliser les meilleures ressources et expérimenter de façon incrémentale.
Je recommande trois types de repos : learn-claude-code pour tutoriels guidés et exercices, awesome-claude-code pour curation de ressources, et vos propres sandboxes pour expérimentations. Sandbox signifie un espace isolé pour tester sans impacter la base de code principale.
Feuille de route sur 6 semaines — objectifs et exercices pratiques :
- Première semaine : Lire tutoriels, cloner learn-claude-code, construire un harness minimal (launcher + tests unitaires).
- Deuxième semaine : Ajouter un skill simple (intégration API) et couvrir par tests unitaires.
- Troisième semaine : Écrire 5 prompts système optimisés et mesurer variations de sortie.
- Quatrième semaine : Monter un workflow end-to-end (ingestion → processing → réponse) et automatiser via CI.
- Cinquième semaine : Introduire tests E2E (tests de bout en bout) et mesurer temps d’exécution.
- Sixième semaine : Revue de sécurité, hardening, et préparation au déploiement.
Indicateurs de progrès :
- Couverture de scénarios : pourcentage des cas métier couverts par tests.
- Tests automatisés : nombre et taux de réussite des tests unitaires/E2E.
- Temps d’exécution moyen : latence de réponse en ms pour workflows critiques.
Exemples concrets git pour isoler expérimentations :
git clone git@github.com:me/learn-claude-code.git
cd learn-claude-code
git worktree add ../wt-feature feature/skill-xyz
# Travaille dans ../wt-feature sans toucher la branche principale
git worktree remove ../wt-feature
# Créer une branche locale pour expérimentation
git checkout -b exp/skill-xyz
Checklist de revue sécurité et tests (exemples importants) :
- Valider permissions API : limiter scopes et tokens rotatifs.
- Revue des prompts : filtrer données sensibles avant envoi.
- Tests de charge : vérifier comportement à 10x trafic attendu.
- Monitoring en prod : alertes sur erreurs et latence.
Conseils de documentation :
- README : objectifs, setup rapide, exemples d’utilisation.
- Examples : snippets exécutables et jeux de données minimaux.
- FAQ : réponses aux erreurs courantes et limites connues.
| Ressource | Objectif | Métrique |
| learn-claude-code | Apprendre pas à pas | Nombre d’exercices complétés |
| awesome-claude-code | Curation d’outils & libs | Références utiles intégrées au projet |
| Votre sandbox | Expérimentation sûre | Branches isolées / temps d’exécution |
Prêt à intégrer ces dépôts pour accélérer votre maîtrise de Claude Code ?
J’ai présenté les dépôts clés et les patterns pour maîtriser Claude Code : harnesses (everything-claude-code), prompts et outils (system-prompts-and-models-of-ai-tools), orchestration par rôles (gstack), workflows structurés (get-shit-done) et parcours pédagogique (learn-claude-code, awesome-claude-code). En suivant les exemples, les structures de fichiers et les workflows proposés, vous pourrez construire, tester et industrialiser des agents plus fiables et réutilisables. Bénéfice concret : réduire le temps de prototypage et augmenter la robustesse des intégrations agentiques dans votre stack.
FAQ
-
Quels dépôts dois-je cloner en premier pour débuter avec Claude Code ?
Commencez par learn-claude-code pour la pédagogie et everything-claude-code pour un harness complet ; ajoutez system-prompts-and-models-of-ai-tools pour exemples de prompts et gstack pour patterns d’orchestration. -
Comment tester un skill localement avant de l’intégrer au harness ?
Isoler le skill dans une branche/git worktree, écrire des tests unitaires simples et un mock d’API, exécuter en local via un runner (node/python) et valider les entrées/sorties avant le merge. -
Que sont les hooks et quand les utiliser ?
Les hooks sont des points d’extension pré/post-processing (validation, enrichissement, logging). Utilisez-les pour appliquer des règles globales, normaliser le contexte ou gérer les erreurs sans modifier le cœur des skills. -
Comment éviter la perte de contexte dans les workflows multi-étapes ?
Segmentez le travail en phases (discussion, planification, exécution, vérification), compressez le contexte utile, stockez checkpoints et utilisez des subagents dédiés pour limiter la dérive et faciliter les handoffs. -
Quelles bonnes pratiques de sécurité appliquer avant production ?
Effectuez validation d’input, scans de dépendances, revues de permissions d’outils exposés, tests d’injection prompt, et surveillez logs et coûts API. Documentez et automatisez les checks dans la CI.
A propos de l’auteur
Je suis Franck Scandolera, expert & formateur en tracking server-side, Analytics Engineering, automatisation No/Low Code (n8n) et intégration de l’IA en entreprise. J’accompagne des clients comme Logis Hôtel, Yelloh Village, BazarChic, Fédération Française de Football et Texdecor. Responsable de l’agence webAnalyste et de l’organisme de formation Formations Analytics. Disponible pour aider les entreprises => contactez moi.
⭐ Analytics engineer, Data Analyst et Automatisation IA indépendant ⭐
- Ref clients : Logis Hôtel, Yelloh Village, BazarChic, Fédération Football Français, Texdecor…
Mon terrain de jeu :
- Data Analyst & Analytics engineering : tracking avancé (GTM server, e-commerce, CAPI, RGPD), entrepôt de données (BigQuery, Snowflake, PostgreSQL, ClickHouse), modèles (Airflow, dbt, Dataform), dashboards décisionnels (Looker, Power BI, Metabase, SQL, Python).
- Automatisation IA des taches Data, Marketing, RH, compta etc : conception de workflows intelligents robustes (n8n, App Script, scraping) connectés aux API de vos outils et LLM (OpenAI, Mistral, Claude…).
- Engineering IA pour créer des applications et agent IA sur mesure : intégration de LLM (OpenAI, Mistral…), RAG, assistants métier, génération de documents complexes, APIs, backends Node.js/Python.





