Epics

Gestion des epics via MCP. Regroupez les user stories et fonctionnalités associées en epics stratégiques pour la planification de projet de haut niveau.

Open Source — GitScrum MCP Server est open source sous la licence MIT. Disponible sur npm et sur GitHub. Serveur Model Context Protocol pour GitScrum — Claude, GitHub Copilot, Cursor et tout client compatible MCP disposent d'un accès opérationnel complet à votre stack de gestion de projets.

L'outil epic fournit 3 actions pour gérer les epics — l'unité organisationnelle de plus haut niveau dans votre hiérarchie de projet. Les epics regroupent les user stories et fonctionnalités associées en initiatives stratégiques, offrant à votre équipe une vue claire des objectifs à grande échelle. Grâce au serveur MCP, votre assistant IA peut créer des epics, mettre à jour leurs détails et lister tous les epics d'un projet.

Les epics dans GitScrum représentent des volumes de travail significatifs qui s'étendent sur plusieurs sprints et contiennent plusieurs user stories. Ils répondent à la question "vers quelle initiative majeure travaillons-nous ?" tandis que les user stories et les tâches gèrent le "comment" et le "quoi précisément." Le serveur MCP permet de construire et gérer cette hiérarchie complète — epics → user stories → tâches — via une conversation en langage naturel.

Aperçu des actions

Action	Objectif	Paramètres requis
`list`	Lister tous les epics d'un projet	`companyslug`, `project``slug`
`create`	Créer un nouvel epic avec titre, description et couleur	`companyslug`, `project``slug`, `title`
`update`	Modifier n'importe quel champ d'un epic existant	`epicuuid`, `company``slug`, `project_slug`

Lister les epics

L'action list retourne tous les epics d'un projet spécifique. Chaque epic dans la réponse inclut son uuid, titre, description, couleur et métadonnées associées. Cela donne à votre assistant IA une vue complète des initiatives stratégiques du projet.

Utilisez cette action pour consulter la feuille de route du projet, identifier quels epics ont le plus d'activité ou vérifier comment le travail est réparti entre les objectifs stratégiques.

Paramètres requis

Paramètre	Type	Description
`company_slug`	string	Identifiant du workspace (depuis l'outil `workspace`)
`project_slug`	string	Identifiant du projet (depuis l'outil `project`)

Exemples de prompts

Vous :  "Liste tous les epics du projet Backend"
IA :    Appelle epic action=list → retourne tous les epics avec titres, descriptions et couleurs

Vous :  "Quelles sont nos initiatives stratégiques en cours ?"
IA :    Appelle epic action=list → résume les epics du projet comme des objectifs de haut niveau

Vous :  "Montre-moi la feuille de route du projet"
IA :    Appelle epic action=list → présente les epics comme des jalons stratégiques

Créer des epics

L'action create construit un nouvel epic en un seul appel. Les epics sont intentionnellement légers — ils ont besoin d'un titre et peuvent optionnellement inclure une description et une couleur pour l'identification visuelle sur le tableau. Cette simplicité reflète leur rôle de conteneurs stratégiques plutôt que d'éléments de travail au niveau tâche.

Paramètres requis

Paramètre	Type	Description
`company_slug`	string	Identifiant du workspace (depuis l'outil `workspace`)
`project_slug`	string	Identifiant du projet (depuis l'outil `project`)
`title`	string	Nom de l'epic (ex. "Release T1", "Refonte Authentification", "Application Mobile v2")

Paramètres optionnels

Paramètre	Type	Description
`description`	string	Description détaillée au format Markdown. Utilisez-la pour les objectifs, le périmètre, les critères de succès et le contexte.
`color`	string	Code couleur hexadécimal sans le préfixe `#` (ex. `FF5733`, `3B82F6`, `10B981`). Utilisé pour l'identification visuelle dans l'interface GitScrum.

Guide des couleurs

Les epics apparaissent comme des labels colorés dans toute l'interface GitScrum — sur le tableau Kanban, dans les vues sprint et dans les rapports. Choisir des couleurs distinctes pour chaque epic aide votre équipe à identifier visuellement à quelle initiative stratégique appartient une tâche d'un seul coup d'œil.

Conventions de couleurs courantes :

Couleur	Hex	Usage typique
Bleu	`3B82F6`	Fonctionnalités et améliorations
Rouge	`EF4444`	Correctifs critiques ou dette technique
Vert	`10B981`	Infrastructure et DevOps
Violet	`8B5CF6`	Recherche et exploration
Orange	`F59E0B`	Livrables orientés client

Exemples de prompts

Vous :  "Crée un epic 'Release T1' avec la couleur bleue"
IA :    Appelle epic action=create avec title="Release T1", color="3B82F6"

Vous :  "Crée un epic appelé 'Refonte Authentification' avec une description couvrant
         les objectifs de migration OAuth2, SSO et RBAC"
IA :    Appelle epic action=create avec title, description contenant les détails du périmètre

Vous :  "Ajoute un nouvel epic pour la refonte de l'application mobile, utilise la couleur orange"
IA :    Appelle epic action=create avec title="Refonte Application Mobile", color="F59E0B"

Vous :  "Crée trois epics pour le T1 : Performance API, Tableau de bord Utilisateur et
         Intégration Paiement. Utilise des couleurs différentes pour chacun."
IA :    Appelle epic action=create trois fois avec des titres et couleurs distincts

Mettre à jour les epics

L'action update modifie n'importe quel champ d'un epic existant. Seuls les champs que vous spécifiez sont modifiés — tous les autres restent inchangés. C'est utile pour affiner les descriptions des epics au fur et à mesure que le périmètre évolue, changer les couleurs pour une réorganisation visuelle ou renommer les epics pour mieux refléter leur direction actuelle.

Paramètres requis

Paramètre	Type	Description
`epic_uuid`	string	UUID de l'epic (depuis la réponse `list`)
`company_slug`	string	Identifiant du workspace
`project_slug`	string	Identifiant du projet

Paramètres optionnels

Tous les paramètres optionnels de create sont disponibles dans update : title, description, color.

Exemples de prompts

Vous :  "Mets à jour la description de l'epic Release T1 pour inclure le nouveau périmètre de migration API"
IA :    Trouve l'epic via list → appelle epic action=update avec la description enrichie

Vous :  "Change la couleur de l'epic Refonte Authentification en rouge"
IA :    Appelle epic action=update avec color="EF4444"

Vous :  "Renomme l'epic 'Application Mobile v2' en 'Refonte Application Mobile'"
IA :    Appelle epic action=update avec title="Refonte Application Mobile"

Vous :  "Mets à jour tous les epics pour inclure des dates de complétion estimées dans leurs descriptions"
IA :    Liste les epics → met à jour chacun avec des descriptions révisées

Flux de planification stratégique

Les epics sont plus efficaces lorsqu'ils sont utilisés au sommet d'une hiérarchie de planification délibérée. Ce flux montre comment construire une structure de projet complète, des initiatives stratégiques jusqu'aux tâches actionnables.

1. Définir les epics stratégiques

Commencez par établir les initiatives majeures pour le trimestre ou le cycle de release.

Vous :  "Nous planifions le T1. Crée des epics pour : Performance API (vert),
         Tableau de bord Utilisateur (bleu) et Intégration Paiement (violet)"
IA :    Crée trois epics avec des titres descriptifs et des couleurs distinctes

2. Ajouter le périmètre et les critères de succès

Affinez chaque epic avec des descriptions détaillées clarifiant ce que signifie "terminé".

Vous :  "Mets à jour l'epic Performance API avec une description : 'Réduire la latence p95
         à moins de 200ms. Migrer vers le pooling de connexions. Ajouter une couche de cache.'"
IA :    Appelle epic action=update avec la description détaillée

3. Décomposer les epics en user stories

Créez des user stories sous chaque epic pour définir des exigences spécifiques.

Vous :  "Crée des user stories pour l'epic Intégration Paiement :
         - En tant qu'utilisateur, je veux payer par carte bancaire
         - En tant qu'utilisateur, je veux consulter mon historique de paiements
         - En tant qu'admin, je veux émettre des remboursements"
IA :    Crée trois user stories liées au projet

4. Convertir les stories en tâches

Décomposez chaque user story en tâches implémentables qui vont sur le tableau Kanban.

Vous :  "Décompose la story de paiement par carte bancaire en tâches de développement"
IA :    Crée des tâches pour : intégration Stripe, interface du formulaire de paiement,
        validation, gestion des erreurs et génération de reçus

5. Suivre la progression des epics

Vérifiez comment le travail progresse à travers vos initiatives stratégiques.

Vous :  "Montre-moi le statut de tous les epics du projet"
IA :    Liste les epics → pour chacun, filtre les tâches pour calculer les métriques de complétion

Epics et visibilité du projet

Les epics fournissent une couche de communication puissante entre les équipes de développement et les parties prenantes. Quand un chef de projet ou un client demande "sur quoi travaillons-nous ce trimestre ?", la liste des epics fournit la réponse au bon niveau d'abstraction — suffisamment stratégique pour les revues exécutives, suffisamment structuré pour la planification des sprints.

Grâce au serveur MCP, vous pouvez générer des résumés au niveau des epics à la demande :

Vous :  "Donne-moi un point d'avancement de haut niveau pour tous les epics"
IA :    Liste les epics → filtre les tâches par epic → résume la progression de chaque initiative

Vous :  "Quel epic a le plus de travail non terminé ?"
IA :    Liste les epics → analyse la complétion des tâches → identifie l'epic avec le plus de tâches restantes

Résolution automatique du contexte

L'outil epic supporte la résolution automatique du contexte. Si l'assistant IA connaît déjà votre workspace et projet depuis un appel précédent dans la conversation, il transporte ce contexte. Cela signifie que vous pouvez dire "Crée un epic" sans spécifier le projet à chaque fois, tant que l'assistant IA a établi le contexte du projet plus tôt dans la conversation.

Prochaines étapes

User Stories : Définissez des exigences au sein des epics sous forme de user stories structurées.
Tâches : Créez les tâches d'implémentation qui concrétisent vos epics.
Sprints : Planifiez les sprints autour du travail des epics priorisés.
Labels : Catégorisez les tâches à travers les epics avec des labels pour le filtrage.
Démarrage rapide : Configurez le serveur MCP si ce n'est pas déjà fait.