--- title: "Atlassian Forge Developer - Plugin IDE Intelligent" description: "Un plugin WebStorm/JetBrains offrant autocompletion intelligente, validation temps reel et documentation integree pour le developpement Atlassian Forge - 83 scopes OAuth, 71 types d'evenements, 155+ templates de projets, entierement modelises en Kotlin." locale: "fr" canonical: "https://portfolio.josedacosta.info/fr/realisations/atlassian-forge-developer-ide-plugin" source: "https://portfolio.josedacosta.info/fr/realisations/atlassian-forge-developer-ide-plugin.md" html_source: "https://portfolio.josedacosta.info/fr/realisations/atlassian-forge-developer-ide-plugin" author: "José DA COSTA" date: "2025" type: "achievement" slug: "atlassian-forge-developer-ide-plugin" tags: ["Kotlin 2.1.20", "IntelliJ Platform SDK 2.5.0", "Gradle 8.13", "Java 21", "SnakeYAML", "GitHub Actions", "Qodana", "Kover"] generated_at: "2026-04-23T15:42:32.399Z" --- # Atlassian Forge Developer - Plugin IDE Intelligent Un plugin WebStorm/JetBrains offrant autocompletion intelligente, validation temps reel et documentation integree pour le developpement Atlassian Forge - 83 scopes OAuth, 71 types d'evenements, 155+ templates de projets, entierement modelises en Kotlin. **Date:** Avril 2025 - Juillet 2025 **Duration:** ~3 mois **Role:** Developpeur & Architecte Solo **Technologies:** Kotlin 2.1.20, IntelliJ Platform SDK 2.5.0, Gradle 8.13, Java 21, SnakeYAML, GitHub Actions, Qodana, Kover ### Key Metrics - Lignes Kotlin: **-** - main + tests compiles - Fichiers Totaux: **-** - 112 fichiers toutes categories - Scopes OAuth: **-** - Entierement modelises avec descriptions - Templates Forge: **-** - Catalogues par produit & type d'UI ## Presentation _Vue d'ensemble et contexte du projet_ - **Atlassian Forge Developer** est un plugin pour WebStorm (et les IDE JetBrains compatibles) qui fournit un support intelligent pour le developpement d'applications **Atlassian Forge**. Il offre de l'autocompletion contextuelle, de la coloration syntaxique avancee, de la validation en temps reel et des correctifs automatiques pour les fichiers `manifest.yml` - le fichier de configuration central de toute application Forge. - Le plugin s'adresse aux developpeurs qui construisent des applications cloud pour l'ecosysteme Atlassian (Jira, Confluence, Bitbucket, Compass, Jira Service Management) via la plateforme Forge. Avant ce plugin, les developpeurs editaient leurs fichiers manifest.yml sans aucune assistance de l'IDE : pas de suggestions, pas de validation, pas de documentation contextuelle. Chaque erreur ne se revelait qu'au moment du deploiement, entrainant des cycles de debug couteux. - Le plugin est exclusivement concu pour les applications **Forge** et ne supporte **pas** les applications Atlassian Connect (qui utilisent `atlassian-connect.json`). - Autocompletion YAML contextuelle basee sur la position dans l'arbre syntaxique - couvrant les proprietes des 5 produits Atlassian - Validation temps reel contre le schema officiel Forge - proprietes requises, types, patterns, valeurs deprecees - Correctifs en un clic - ajout de proprietes manquantes, mise a jour des runtimes deprecees, generation d'app ID ARI valides - Coloration syntaxique avancee - distinction visuelle par type d'element, configurable via Settings - Recherche integree de documentation Atlassian - filtrage par produit et type de contenu, copie Markdown pour outils IA - Gestion des variables d'environnement Forge - interface visuelle avec support multi-environnements et chiffrement - Assistant de creation de projets Forge - 155+ templates officiels par produit et type d'UI - Integration Forge CLI - commandes deploy, tunnel, install, lint directement depuis l'IDE **Detection Text:** Le plugin n'active ses fonctionnalites que lorsqu'il detecte un veritable projet Forge via un double critere : le `manifest.yml` contient un `app.id` commencant par `ari:cloud:ecosystem::` ET un `package.json` dans le meme repertoire contient au moins une dependance `@forge/`. Cela garantit que le plugin n'interfere pas avec d'autres fichiers YAML. ## Objectifs, Contexte, Enjeux & Risques _Contexte strategique et defis identifies_ ### Obj Devex Support natif IDE pour le developpement Forge dans WebStorm ### Obj Error La validation temps reel detecte les erreurs avant le deploiement ### Obj Coverage Jira, Confluence, Bitbucket, Compass, JSM + Rovo ### Obj Docs Documentation Atlassian consultable directement depuis l'IDE ### Obj Templates Templates officiels Forge accessibles via l'assistant de projet **Objectives Intro:** Le plugin Atlassian Forge Developer a ete cree pour combler un manque critique : l'absence totale d'outillage IDE pour le format proprietaire manifest.yml utilise par Atlassian Forge. **Obj Devex Label:** Experience Developpeur **Obj Devex Value:** Premier choix **Obj Error Label:** Reduction des erreurs **Obj Error Value:** Pre-deploiement **Obj Coverage Label:** Couverture produits **Obj Coverage Value:** 5 produits **Obj Docs Label:** Documentation **Obj Docs Value:** Integree **Obj Templates Label:** Templates **Obj Templates Value:** 155+ **Context Text:** Le projet s'appuie sur le **template officiel de JetBrains** pour le developpement de plugins IntelliJ Platform. Le schema du manifest Forge est complexe et proprietaire : il couvre des centaines de proprietes reparties entre les modules de 5 produits Atlassian, 83 scopes OAuth 2.0, 71 types d'evenements et 155+ templates de projets. Ce schema a du etre entierement modelise en Kotlin pour alimenter l'autocompletion et la validation. **Stakes Text:** **Productivite developpeur** : chaque minute gagnee sur la configuration Forge se repercute sur des milliers de developpeurs dans l'ecosysteme Atlassian. **Qualite du code** : la detection d'erreurs avant deploiement evite des cycles de debug couteux sur la plateforme cloud. **Positionnement strategique** : etre le premier plugin IDE dedie a Forge donne un avantage concurrentiel significatif sur le JetBrains Marketplace. **Risk1 Title:** Dependance au schema Atlassian **Risk1 Desc:** Le schema Forge evolue regulierement ; le plugin doit suivre les mises a jour sous peine de devenir obsolete **Risk2 Title:** Compatibilite IDE **Risk2 Desc:** Supporter les versions 2024.2 a 2025.2 de WebStorm (builds 242-252) necessite des tests de compatibilite rigoureux **Risk3 Title:** Complexite du PSI **Risk3 Desc:** La manipulation de l'arbre syntaxique (PSI) de l'IntelliJ Platform est techniquement exigeante et sujette a des regressions subtiles **Risk4 Title:** Adoption marche **Risk4 Desc:** La version pre-release (0.1.0) peut limiter l'adoption initiale sur le Marketplace ## Les Etapes - Ce que j'ai fait _Parcours d'implementation de l'initialisation a la stabilisation_ - Phase 1 - Phase 2 - Phase 3 - Phase 4 **Phase1 Title:** Initialisation & Configuration **Phase1 Period:** Avril 2025 **Phase2 Title:** Developpement des Fonctionnalites Principales **Phase2 Period:** Mai - Juin 2025 **Phase3 Title:** Fonctionnalites Avancees **Phase3 Period:** Juin - Juillet 2025 **Phase4 Title:** Tests & Stabilisation **Phase4 Period:** Continu ## Les Acteurs - Les Interactions _Modele de collaboration et ecosysteme des parties prenantes_ - Ce plugin a ete developpe en **projet solo** sous la marque **Addly** (https://addly.app), une entite dediee a la creation d'outils de productivite pour developpeurs. En tant que developpeur unique, j'ai gere l'integralite du cycle de vie produit : architecture, implementation, tests, CI/CD, documentation et preparation Marketplace. - Le developpement a ete assiste par **Claude Code** pour la generation de code et les sessions de pair-programming. Le workflow combinait mon expertise approfondie du domaine Atlassian Forge avec une implementation acceleree par IA - un modele ou l'humain fournit la vision, l'architecture et la connaissance du domaine tandis que l'IA assiste l'execution du code. **Table Source:** Source **Table Lines:** Lignes **Table Percent:** % du Total **Table Files:** Fichiers **Ext Deps Text:** **Atlassian** a fourni la plateforme Forge, la documentation et l'API de recherche Algolia. **JetBrains** a fourni l'IntelliJ Platform SDK, le template de plugin et l'infrastructure de distribution Marketplace. La **communaute de developpeurs Forge** represente la base d'utilisateurs cible. ## Les Resultats _Livrables, metriques et evolution personnelle_ ### Metric Extensions Completion, annotator, inspection, highlighter, tool windows, etc. ### Metric Workflows Build, release, UI tests, template cleanup, template verify ### Metric Icons 7 icones SVG + 10 PNG readme + 2 SVG readme ### Metric Scripts 1 bash + 3 JS + 1 configuration JSON - **Patterns avances Kotlin** - coroutines, serialisation, DSL, conventions IntelliJ Platform - **Maitrise de l'IntelliJ Platform SDK** - manipulation PSI, extension points, inspections, quick fixes, tool windows, completion contributors, syntax highlighters - **Architecture de plugins IDE** - gestion du cycle de vie, extension points, actions, listeners, gestion des types de fichiers - **Le Developer Experience (DevEx) comme discipline** - comprendre qu'un outil IDE economisant 5 minutes par jour par developpeur se justifie rapidement a l'echelle - **Workflows de developpement assiste par IA** - utilisation de Claude Code avec des specifications detaillees (CLAUDE.md) pour accelerer l'implementation tout en maintenant le controle architectural - **Precision de la modelisation de domaine** - les fichiers de schema (ManifestSchema, Scopes, EventTypes) representent la valeur fondamentale ; plus le modele est precis, plus le plugin est utile **For Product:** Pour le Produit **Metric Extensions:** Extensions Plugin **Metric Workflows:** Workflows CI/CD **Metric Icons:** Icones & Visuels **Metric Scripts:** Scripts Utilitaires **For Company:** Pour l'Entreprise (Addly) **For Company Text:** Le plugin est un **produit publiable** sur le JetBrains Marketplace avec un pipeline de publication entierement automatise (signature + deploiement). Il fournit une **couverture complete** du schema Forge pour les 5 produits Atlassian Cloud. A ce jour, **aucun concurrent direct** n'existe sur le Marketplace JetBrains pour le support specifique d'Atlassian Forge. **For Me:** Pour Moi - Ce que j'ai appris **For Me Text:** Ce projet a approfondi mon expertise dans plusieurs domaines techniques et strategiques : ## Les Lendemains du Projet _Etat post-developpement et trajectoire future_ **Immediate Text:** Le plugin a atteint la **version 0.1.0** avec toutes les fonctionnalites principales implementees. Le pipeline de publication sur le JetBrains Marketplace est entierement automatise via GitHub Actions : une GitHub Release declenche la signature, le packaging et le deploiement. La CI/CD comprend 5 workflows couvrant build, tests, analyse statique (Qodana), verification de compatibilite et release automatisee. **Evolution Text:** La feuille de route immediate comprend : **committer le code source initial** dans git (actuellement non versionne), ameliorer la **couverture de tests** au-dela du ratio actuel de ~14.5%, **internationaliser** tous les messages UI (actuellement 8 proprietes i18n), et creer des **scripts de mise a jour automatique du schema** pour suivre les changements Atlassian Forge par programmation. **Current Text:** Le plugin est en **developpement actif** dans le cadre d'une serie plus large de plugins IDE JetBrains construits sous la marque Addly. Ce plugin particulier a ete choisi pour cette presentation car il demontre le mieux la profondeur technique et la completude produit realisables avec l'IntelliJ Platform SDK. Les autres plugins de la serie suivent des patterns similaires de modelisation de domaine approfondie combinee avec une integration IDE complete. ## Mon Regard Critique _Retrospective honnete sur les reussites et les axes d'amelioration_ - **Le Developer Experience (DevEx) est un domaine a fort impact** - un outil qui fait gagner 5 minutes par jour a chaque developpeur se justifie rapidement a l'echelle de l'ecosysteme Atlassian - **L'IntelliJ Platform est puissante mais exigeante** - la manipulation du PSI, les extension points et les conventions de l'API necessitent un investissement d'apprentissage significatif mais permettent de construire des outils tres integres - **La modelisation du domaine est la valeur fondamentale** - les fichiers de schema (ManifestSchema, Scopes, EventTypes) representent la valeur du plugin ; plus le modele est precis et complet, plus le plugin devient utile - **L'IA comme accelerateur de developpement** - les specifications CLAUDE.md + workflow Claude Code demontrent comment l'IA peut assister le developpement de projets complexes, de l'implementation au debugging, tandis que l'humain maintient la vision et le controle architectural