HandbookTutoriel : Dev Studio

Tutoriel : Dev Studio

Lire, classer, corriger et améliorer le backlog de BoostEcom avec Markdown et Claude Code, puis suivre les PR, les runs historiques, la CI et le design.

Ce que Dev Studio centralise

Le Dev Studio se trouve dans le footer du panneau gauche de l'Admin Panel, accessible sur /admin/platform/dev-studio. Un collaborateur possédant la permission platform.dev.operate utilise /ops/dev. Il s'agit du même cockpit partagé, avec des accès adaptés.

  • Travail : backlog, décisions à prendre.
  • Livraison : GitHub, runs et historique, commandes CI.
  • Design : sources du design system et références Figma/Excalidraw.

Il n'y a plus de lien « Réglages Dev Studio » séparé dans le menu Plateforme, ni de plafond financier par délégué. Les références design se gèrent dans Design.

Classer et comprendre les items

  1. Dans Travail → Backlog, les cartes s'affichent initialement par importance : P0 (critique), P1 (haute), P2 (normale), P3 (basse), puis priorité non renseignée. Ce classement suit les priorités déjà renseignées, il ne prétend pas calculer l'urgence réelle.
  2. Dans Trier, choisissez Catégorie, puis importance pour regrouper les items par pilier (application, IA, facturation, etc.) en gardant l'ordre P0 à P3 dans chaque pilier. Les autres filtres permettent de restreindre par statut, pilier, priorité et type.
  3. Ouvrez Améliorer sur une carte pour lire le texte Markdown mis en forme, son titre, sa catégorie et sa priorité. Modifier permet de changer le titre, le Markdown et la priorité ; le statut, la taille et les dépendances restent modifiables.
  4. Pour une tâche confuse, utilisez Rechercher et reformuler avec Claude Code. Le bouton ouvre Claude Code sur le web et copie la consigne avec le titre et le contenu actuels. Collez-la dans une session qui a accès au dépôt, afin de vérifier le code, les tickets et la documentation avant de proposer un titre, une catégorie, une priorité et des critères d'acceptation mieux justifiés.
  5. Revenez dans Modifier pour examiner et reporter les corrections retenues. Proposer la modification ouvre une PR draft sur GitHub, ou ajoute un commit à la PR draft déjà ouverte pour ce même item. Une PR passée en review humaine n'est jamais modifiée par ce formulaire ; aucun changement n'est appliqué sur main automatiquement. Une recatégorisation qui déplace le fichier exige également l'ajustement de ses références dans une PR revue.

Important : le bouton Claude Code prépare le travail de recherche ; il ne génère pas une réponse dans l'éditeur, ne vérifie pas seul les fichiers du dépôt et ne prétend pas modifier automatiquement le backlog. Il faut une session Claude authentifiée et autorisée à lire le dépôt.

Lancer une tâche avec Claude Code

Le bouton de lancement d'une carte ouvre le dernier mode utilisé. Sa flèche permet de choisir entre Claude Code navigateur, Desktop/local, une commande Claude Code cloud ou Claude Code dans le terminal Cursor. Dans Cursor, c'est la CLI Claude Code qui est utilisée, et non l'agent IA natif de Cursor. Le compte et l'abonnement Claude restent gérés dans les applications Claude, pas dans Dev Studio.

Le lancement ouvre ou prépare une session ; il ne crée ni budget API, ni run GitHub Actions payant, ni trace automatique d'exécution. Pour connaître l'avancement, regardez la branche, la PR ou les anciens runs suivis dans les vues GitHub et Runs.

Design et références communes

L'onglet Design affiche les sources du design system et les liens externes de travail. Un administrateur peut enregistrer les références partagées dans la même section. L'ancienne URL de réglages redirige vers Design.

Si un contrôle ne fonctionne pas

  • Claude Code n'a pas accès au dépôt : connectez le compte ou ouvrez le dépôt dans une session locale autorisée ; aucune recherche n'est présumée réussie.
  • Le navigateur refuse le presse-papiers : la consigne de recherche reste visible dans Voir et copier la consigne de recherche.
  • Le bouton de lancement est désactivé : l'item n'est pas dans un état lançable, ou un run suivi existe déjà.
  • Modification refusée par GitHub : les droits GITHUB_FLEET_TOKEN ou la création de PR peuvent être indisponibles ; aucune modification directe de main n'est effectuée.
  • Les workflows GitHub Actions sont indisponibles : le lanceur Claude Code par abonnement ne dépend pas de leur quota.

La validation finale d'une reformulation, d'une priorité ou d'un changement de catégorie appartient toujours au responsable du produit.