--- title: "Atlassian Forge Developer - Plugin IDE Inteligente" description: "Um plugin WebStorm/JetBrains oferecendo autocompletion inteligente, validacao em tempo real e documentacao integrada para desenvolvimento Atlassian Forge - 83 escopos OAuth, 71 tipos de eventos, 155+ templates de projetos, totalmente modelados em Kotlin." locale: "pt" canonical: "https://portfolio.josedacosta.info/pt/realizacoes/atlassian-forge-developer-ide-plugin" source: "https://portfolio.josedacosta.info/pt/realizacoes/atlassian-forge-developer-ide-plugin.md" html_source: "https://portfolio.josedacosta.info/pt/realizacoes/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:43:58.639Z" --- # Atlassian Forge Developer - Plugin IDE Inteligente Um plugin WebStorm/JetBrains oferecendo autocompletion inteligente, validacao em tempo real e documentacao integrada para desenvolvimento Atlassian Forge - 83 escopos OAuth, 71 tipos de eventos, 155+ templates de projetos, totalmente modelados em Kotlin. **Date:** Abril 2025 - Julho 2025 **Duration:** ~3 meses **Role:** Desenvolvedor & Arquiteto Solo **Technologies:** Kotlin 2.1.20, IntelliJ Platform SDK 2.5.0, Gradle 8.13, Java 21, SnakeYAML, GitHub Actions, Qodana, Kover ### Key Metrics - Linhas Kotlin: **-** - main + testes compilados - Arquivos Totais: **-** - 112 arquivos em todas as categorias - Escopos OAuth: **-** - Totalmente modelados com descricoes - Templates Forge: **-** - Catalogados por produto & tipo de UI ## Apresentacao _Visao geral e contexto do projeto_ - **Atlassian Forge Developer** e um plugin para WebStorm (e IDEs JetBrains compativeis) que fornece suporte inteligente para desenvolvimento de aplicacoes **Atlassian Forge**. Oferece autocompletion contextual, realce de sintaxe avancado, validacao em tempo real e correcoes automaticas para arquivos `manifest.yml` - o arquivo de configuracao central de toda aplicacao Forge. - O plugin e destinado a desenvolvedores que constroem aplicacoes cloud para o ecossistema Atlassian (Jira, Confluence, Bitbucket, Compass, Jira Service Management) via plataforma Forge. Antes deste plugin, desenvolvedores editavam seus arquivos manifest.yml sem nenhuma assistencia do IDE: sem sugestoes, sem validacao, sem documentacao contextual. Cada erro neste arquivo so era revelado no momento do deploy, causando ciclos de debug custosos. - O plugin e exclusivamente projetado para aplicacoes **Forge** e nao suporta aplicacoes Atlassian Connect (que usam `atlassian-connect.json`). - Autocompletion YAML contextual baseada na posicao na arvore sintatica - cobrindo propriedades dos 5 produtos Atlassian - Validacao em tempo real contra o schema oficial Forge - propriedades obrigatorias, tipos, patterns, valores deprecados - Correcoes em um clique - adicionar propriedades faltantes, atualizar runtimes deprecados, gerar app IDs ARI validos - Realce de sintaxe avancado - distincao visual por tipo de elemento, configuravel via Settings - Busca integrada de documentacao Atlassian - filtragem por produto e tipo de conteudo, copia Markdown para ferramentas de IA - Gerenciamento de variaveis de ambiente Forge - interface visual com suporte multi-ambiente e criptografia - Assistente de criacao de projetos Forge - 155+ templates oficiais por produto e tipo de UI - Integracao Forge CLI - comandos deploy, tunnel, install, lint diretamente do IDE **Detection Text:** O plugin so ativa suas funcionalidades quando detecta um projeto Forge genuino via criterio duplo: o `manifest.yml` contem um `app.id` comecando com `ari:cloud:ecosystem::` E um `package.json` no mesmo diretorio contem pelo menos uma dependencia `@forge/`. Isso garante que o plugin nunca interfira com outros arquivos YAML. ## Objetivos, Contexto, Desafios & Riscos _Contexto estrategico e desafios identificados_ ### Obj Devex Suporte nativo do IDE para desenvolvimento Forge no WebStorm ### Obj Error Validacao em tempo real detecta erros antes do deploy ### Obj Coverage Jira, Confluence, Bitbucket, Compass, JSM + Rovo ### Obj Docs Documentacao Atlassian pesquisavel diretamente do IDE ### Obj Templates Templates oficiais Forge acessiveis via assistente de projeto **Objectives Intro:** O plugin Atlassian Forge Developer foi criado para preencher uma lacuna critica: a ausencia total de ferramentas IDE para o formato proprietario manifest.yml usado pelo Atlassian Forge. **Obj Devex Label:** Experiencia do Desenvolvedor **Obj Devex Value:** Primeira classe **Obj Error Label:** Reducao de Erros **Obj Error Value:** Pre-deploy **Obj Coverage Label:** Cobertura de Produtos **Obj Coverage Value:** 5 produtos **Obj Docs Label:** Documentacao **Obj Docs Value:** Integrada **Obj Templates Label:** Templates **Obj Templates Value:** 155+ **Context Text:** O projeto se baseia no **template oficial da JetBrains** para desenvolvimento de plugins IntelliJ Platform. O schema do manifest Forge e complexo e proprietario: cobre centenas de propriedades distribuidas entre modulos de 5 produtos Atlassian, 83 escopos OAuth 2.0, 71 tipos de eventos e 155+ templates de projetos. Todo este schema teve que ser modelado em Kotlin para alimentar o autocompletion e a validacao. **Stakes Text:** **Produtividade do desenvolvedor**: cada minuto economizado na configuracao Forge impacta milhares de desenvolvedores no ecossistema Atlassian. **Qualidade do codigo**: deteccao de erros pre-deploy evita ciclos de debug custosos na plataforma cloud. **Posicionamento estrategico**: ser o primeiro plugin IDE dedicado ao Forge proporciona vantagem competitiva significativa no JetBrains Marketplace. **Risk1 Title:** Dependencia do schema Atlassian **Risk1 Desc:** O schema Forge evolui regularmente; o plugin deve acompanhar atualizacoes ou arrisca ficar obsoleto **Risk2 Title:** Compatibilidade IDE **Risk2 Desc:** Suportar versoes 2024.2 a 2025.2 do WebStorm (builds 242-252) requer testes de compatibilidade rigorosos **Risk3 Title:** Complexidade do PSI **Risk3 Desc:** Manipular a arvore sintatica (PSI) da IntelliJ Platform e tecnicamente exigente e propenso a regressoes sutis **Risk4 Title:** Adocao do mercado **Risk4 Desc:** Versao pre-release (0.1.0) pode limitar a adocao inicial no Marketplace ## As Etapas - O que Eu Fiz _Jornada de implementacao da inicializacao a estabilizacao_ - Fase 1 - Fase 2 - Fase 3 - Fase 4 **Phase1 Title:** Inicializacao & Configuracao **Phase1 Period:** Abril 2025 **Phase2 Title:** Desenvolvimento das Funcionalidades Principais **Phase2 Period:** Maio - Junho 2025 **Phase3 Title:** Funcionalidades Avancadas **Phase3 Period:** Junho - Julho 2025 **Phase4 Title:** Testes & Estabilizacao **Phase4 Period:** Continuo ## Os Atores - As Interacoes _Modelo de colaboracao e ecossistema de partes interessadas_ - Este plugin foi desenvolvido como **projeto solo** sob a marca **Addly** (https://addly.app), uma empresa dedicada a criacao de ferramentas de produtividade para desenvolvedores. Como unico desenvolvedor, gerenciei todo o ciclo de vida do produto: arquitetura, implementacao, testes, CI/CD, documentacao e preparacao para o Marketplace. - O desenvolvimento foi assistido pelo **Claude Code** para geracao de codigo e sessoes de pair-programming. O workflow combinava minha expertise profunda no dominio Atlassian Forge com implementacao acelerada por IA - um modelo onde o humano fornece visao, arquitetura e conhecimento de dominio enquanto a IA assiste na execucao do codigo. **Table Source:** Fonte **Table Lines:** Linhas **Table Percent:** % do Total **Table Files:** Arquivos **Ext Deps Text:** **Atlassian** forneceu a plataforma Forge, documentacao e API de busca Algolia. **JetBrains** forneceu o IntelliJ Platform SDK, template de plugin e infraestrutura de distribuicao do Marketplace. A **comunidade de desenvolvedores Forge** representa a base de usuarios alvo. ## Os Resultados _Entregas, metricas e crescimento pessoal_ ### 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 configuracao JSON - **Padroes avancados Kotlin** - coroutines, serializacao, DSL, convencoes IntelliJ Platform - **Dominio do IntelliJ Platform SDK** - manipulacao PSI, extension points, inspecoes, quick fixes, tool windows, completion contributors, syntax highlighters - **Arquitetura de plugins IDE** - gestao de ciclo de vida, extension points, acoes, listeners, gestao de tipos de arquivo - **Developer Experience (DevEx) como disciplina** - entender que uma ferramenta IDE economizando 5 minutos por dia por desenvolvedor se justifica rapidamente em escala - **Workflows de desenvolvimento assistido por IA** - uso de Claude Code com especificacoes detalhadas (CLAUDE.md) para implementacao acelerada mantendo o controle arquitetural - **Precisao na modelagem de dominio** - os arquivos de schema (ManifestSchema, Scopes, EventTypes) representam o valor fundamental; quanto mais preciso o modelo, mais util o plugin **For Product:** Para o Produto **Metric Extensions:** Extensoes do Plugin **Metric Workflows:** Workflows CI/CD **Metric Icons:** Icones & Visuais **Metric Scripts:** Scripts Utilitarios **For Company:** Para a Empresa (Addly) **For Company Text:** O plugin e um **produto publicavel** no JetBrains Marketplace com pipeline de publicacao totalmente automatizado (assinatura + deploy). Fornece **cobertura completa** do schema Forge para os 5 produtos Atlassian Cloud. Ate o momento, **nenhum concorrente direto** existe no Marketplace JetBrains para suporte especifico ao Atlassian Forge. **For Me:** Para Mim - O que Aprendi **For Me Text:** Este projeto aprofundou minha expertise em diversas areas tecnicas e estrategicas: ## O Dia Seguinte do Projeto _Estado pos-desenvolvimento e trajetoria futura_ **Immediate Text:** O plugin atingiu a **versao 0.1.0** com todas as funcionalidades principais implementadas. O pipeline de publicacao no JetBrains Marketplace e totalmente automatizado via GitHub Actions: uma GitHub Release aciona assinatura, empacotamento e deploy. O CI/CD inclui 5 workflows cobrindo build, testes, analise estatica (Qodana), verificacao de compatibilidade e release automatizado. **Evolution Text:** O roadmap imediato inclui: **commitar o codigo fonte inicial** no git (atualmente nao versionado), melhorar a **cobertura de testes** alem do ratio atual de ~14.5%, **internacionalizar** todas as mensagens de UI (atualmente 8 propriedades i18n) e criar **scripts de atualizacao automatica do schema** para acompanhar mudancas do Atlassian Forge programaticamente. **Current Text:** O plugin esta em **desenvolvimento ativo** como parte de uma serie mais ampla de plugins IDE JetBrains construidos sob a marca Addly. Este plugin particular foi escolhido para esta apresentacao porque melhor demonstra a profundidade tecnica e completude de produto alcancaveis com o IntelliJ Platform SDK. Outros plugins da serie seguem padroes similares de modelagem de dominio profunda combinada com integracao IDE completa. ## Minha Visao Critica _Retrospectiva honesta sobre sucessos e areas de melhoria_ - **Developer Experience (DevEx) e um dominio de alto impacto** - uma ferramenta que economiza 5 minutos por dia por desenvolvedor se justifica rapidamente em escala no ecossistema Atlassian - **A IntelliJ Platform e poderosa mas exigente** - manipulacao do PSI, extension points e convencoes da API requerem investimento significativo de aprendizado mas permitem construir ferramentas profundamente integradas - **A modelagem de dominio e o valor fundamental** - os arquivos de schema (ManifestSchema, Scopes, EventTypes) representam o valor do plugin; quanto mais preciso e completo o modelo, mais util o plugin se torna - **IA como acelerador de desenvolvimento** - as especificacoes CLAUDE.md + workflow Claude Code demonstram como IA pode assistir o desenvolvimento de projetos complexos, da implementacao ao debugging, enquanto o humano mantem a visao e controle arquitetural