@thiagodiogo/pscode 1.0.0 → 2.0.0

package/pscode/content/dixi/architectures/feature-sliced-react/skeleton.yaml

@@ -0,0 +1,8 @@
+dirs:
+  - src/shared/components/ui
+  - src/shared/hooks
+  - src/shared/services
+  - src/shared/types
+  - src/shared/utils
+  - src/entities
+  - src/features

package/pscode/content/dixi/architectures/hexagonal-spring/ArchitectureTest.java.template

@@ -0,0 +1,41 @@
+package {basePackage};
+
+import com.tngtech.archunit.core.domain.JavaClasses;
+import com.tngtech.archunit.core.importer.ClassFileImporter;
+import com.tngtech.archunit.lang.ArchRule;
+import org.junit.jupiter.api.Test;
+
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
+
+public class ArchitectureTest {
+
+    private static final JavaClasses classes =
+        new ClassFileImporter().importPackages("{basePackage}");
+
+    @Test
+    void dominio_nao_deve_depender_de_infra() {
+        ArchRule rule = noClasses()
+            .that().resideInAPackage("{basePackage}.domain..")
+            .should().dependOnClassesThat()
+            .resideInAPackage("{basePackage}.infrastructure..");
+        rule.check(classes);
+    }
+
+    @Test
+    void aplicacao_nao_deve_depender_de_infra() {
+        ArchRule rule = noClasses()
+            .that().resideInAPackage("{basePackage}.application..")
+            .should().dependOnClassesThat()
+            .resideInAPackage("{basePackage}.infrastructure..");
+        rule.check(classes);
+    }
+
+    @Test
+    void adapter_in_nao_deve_depender_de_adapter_out() {
+        ArchRule rule = noClasses()
+            .that().resideInAPackage("{basePackage}.infrastructure.adapter.in..")
+            .should().dependOnClassesThat()
+            .resideInAPackage("{basePackage}.infrastructure.adapter.out..");
+        rule.check(classes);
+    }
+}

package/pscode/content/dixi/architectures/hexagonal-spring/skeleton.yaml

@@ -0,0 +1,11 @@
+dirs:
+  - src/main/java/{basePackageDir}/domain/model
+  - src/main/java/{basePackageDir}/domain/port/in
+  - src/main/java/{basePackageDir}/domain/port/out
+  - src/main/java/{basePackageDir}/application/usecase
+  - src/main/java/{basePackageDir}/infrastructure/adapter/in/rest
+  - src/main/java/{basePackageDir}/infrastructure/adapter/out/persistence
+  - src/main/java/{basePackageDir}/infrastructure/config
+  - src/test/java/{basePackageDir}/domain
+  - src/test/java/{basePackageDir}/application
+  - src/test/java/{basePackageDir}/infrastructure

package/pscode/content/dixi/claude-runtime/CLAUDE.md.java.template

@@ -0,0 +1,62 @@
+<!-- dixi-constitutional -->
+# Regras Constitucionais — Java/Spring (Arquitetura Hexagonal)
+
+> Regras invioláveis. Não negocie sem motivo documentado.
+> Detalhes completos em `pastelsdd/context/`.
+
+## Arquitetura Hexagonal
+
+### Camadas (da mais interna para a mais externa)
+- `domain/` — entidades, value objects, interfaces de repositório, regras de negócio puras
+- `application/` — use cases, ports (interfaces de entrada e saída)
+- `infrastructure/` — adapters (JPA, REST controllers, messaging, config)
+
+### Regra de Dependência (OBRIGATÓRIO)
+```
+infrastructure → application → domain
+```
+- `domain` não importa NADA de `application` ou `infrastructure`
+- `application` não importa NADA de `infrastructure`
+- Adapters (`infrastructure`) só acessam `application` via interfaces (ports)
+
+### Imports Proibidos
+- `domain.*` nunca importa `application.*` ou `infrastructure.*`
+- `application.*` nunca importa `infrastructure.*`
+- Exceção: testes de integração em `infrastructure/` podem referenciar qualquer camada
+
+## Nomenclatura por Camada
+
+| Camada | Sufixo/Convenção |
+|--------|------------------|
+| `domain/entity/` | `Order`, `Customer` (sem sufixo) |
+| `domain/repository/` | `OrderRepository` (interface) |
+| `domain/service/` | `PricingService` (interface/pura) |
+| `application/usecase/` | `CreateOrderUseCase` |
+| `application/port/in/` | `CreateOrderPort` |
+| `application/port/out/` | `SaveOrderPort` |
+| `infrastructure/adapter/in/` | `OrderController`, `OrderListener` |
+| `infrastructure/adapter/out/` | `OrderJpaAdapter`, `OrderEmailAdapter` |
+
+## Commits
+
+Formato obrigatório: `<type>(<scope>): <msg> [TICKET-123]`
+
+- `type`: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
+- `scope`: módulo ou camada afetada (e.g., `order`, `domain`, `infra`)
+- Ticket JIRA obrigatório. Se não houver ticket, usar `[NO-TICKET]`
+
+Exemplos:
+```
+feat(order): add CreateOrderUseCase [PROJ-42]
+fix(infra): correct JPA mapping for OrderStatus [PROJ-55]
+```
+
+## Referências
+
+Docs completos em `pastelsdd/context/`:
+- `pastelsdd/context/java/architecture.md` — guia completo de arquitetura hexagonal
+- `pastelsdd/context/java/naming.md` — convenções de nomenclatura por camada
+- `pastelsdd/context/shared/commits.md` — convenção completa de commits
+- `pastelsdd/context/shared/dev-flow.md` — fluxo de desenvolvimento e PR
+
+> Se `pastelsdd/context/` não existe, rode `pscode init --profile dixi` para instalar.

package/pscode/content/dixi/claude-runtime/CLAUDE.md.react.template

@@ -0,0 +1,74 @@
+<!-- dixi-constitutional -->
+# Regras Constitucionais — React/Next.js + TypeScript (Feature-Sliced Design)
+
+> Regras invioláveis. Não negocie sem motivo documentado.
+> Detalhes completos em `pastelsdd/context/`.
+
+## Feature-Sliced Design
+
+### Camadas (da mais compartilhada para a mais específica)
+```
+shared → entities → features → pages/app
+```
+- `shared/` — UI primitivos, utilitários, tipos globais, configuração de API
+- `entities/` — modelos de domínio (User, Order) sem lógica de feature
+- `features/` — funcionalidades de produto isoladas (auth, cart, checkout)
+- `pages/` ou `app/` — composição de features e rotas (Next.js)
+
+### Regra de Isolamento de Features (OBRIGATÓRIO)
+- **Features NÃO importam umas das outras**
+- Se dois features precisam de algo em comum → mover para `entities/` ou `shared/`
+- `pages/app` orquestra features; não contém lógica de negócio
+
+### Imports Proibidos
+- `features/auth` nunca importa `features/cart` (ou qualquer outro feature)
+- `shared/` nunca importa `entities/` ou `features/`
+- `entities/` nunca importa `features/`
+
+## Nomenclatura
+
+| Tipo | Convenção |
+|------|-----------|
+| Componentes React | `PascalCase` — `UserCard`, `OrderList` |
+| Hooks | `use` + `PascalCase` — `useUserSession`, `useCartItems` |
+| Services / API | `camelCase` — `userService`, `orderApi` |
+| Arquivos de componente | `PascalCase.tsx` — `UserCard.tsx` |
+| Arquivos de hook | `camelCase.ts` — `useUserSession.ts` |
+| Arquivos de tipo | `camelCase.types.ts` ou `types.ts` no módulo |
+| Testes | `<nome>.test.tsx` no mesmo diretório |
+
+## Estrutura Interna de um Feature
+
+```
+features/auth/
+  ui/          ← componentes do feature
+  model/       ← store, hooks, lógica de estado
+  api/         ← chamadas de API específicas do feature
+  lib/         ← helpers internos
+  index.ts     ← API pública do feature (barrel export)
+```
+Só o que está em `index.ts` pode ser importado de fora do feature.
+
+## Commits
+
+Formato obrigatório: `<type>(<scope>): <msg> [TICKET-123]`
+
+- `type`: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
+- `scope`: feature ou camada afetada (e.g., `auth`, `cart`, `shared`)
+- Ticket JIRA obrigatório. Se não houver ticket, usar `[NO-TICKET]`
+
+Exemplos:
+```
+feat(auth): add OAuth2 login flow [PROJ-10]
+fix(cart): correct item count on empty cart [PROJ-23]
+```
+
+## Referências
+
+Docs completos em `pastelsdd/context/`:
+- `pastelsdd/context/react/architecture.md` — guia completo de feature-sliced design
+- `pastelsdd/context/react/naming.md` — convenções de nomenclatura
+- `pastelsdd/context/shared/commits.md` — convenção completa de commits
+- `pastelsdd/context/shared/dev-flow.md` — fluxo de desenvolvimento e PR
+
+> Se `pastelsdd/context/` não existe, rode `pscode init --profile dixi` para instalar.

package/pscode/content/dixi/claude-runtime/commands/adr.md

@@ -0,0 +1,75 @@
+# /pstld:adr — Geração de Architecture Decision Record
+
+Você é um arquiteto técnico criando um ADR (Architecture Decision Record) formal para documentar uma decisão arquitetural.
+
+## Passos
+
+1. **Colete a decisão**
+
+   Se o usuário descreveu a decisão como argumento, use-a. Caso contrário, pergunte:
+   - Qual decisão arquitetural precisa ser documentada?
+   - Por que essa decisão está sendo tomada agora?
+   - Quais alternativas foram ou poderiam ser consideradas?
+
+2. **Contextualize com o projeto** (opcional)
+
+   - Leia `.pscode-dixi.yaml` se existir para identificar stack e família do projeto.
+   - Isso ajuda a formatar o ADR com referências corretas à arquitetura do projeto.
+
+3. **Gere o ADR**
+
+   Crie o documento no seguinte formato:
+
+   ```markdown
+   # ADR-NNN: <título descritivo e conciso>
+
+   **Status:** Aceita | Proposta | Obsoleta | Substituída por ADR-XXX
+   **Data:** <data atual>
+   **Contexto:** <stack/módulo afetado, se aplicável>
+
+   ## Contexto
+
+   <Descreve a situação atual, o problema a resolver e as forças em jogo.
+   Inclui restrições técnicas, de negócio ou operacionais relevantes.>
+
+   ## Decisão
+
+   <Enuncia a decisão tomada de forma afirmativa e clara.
+   Ex: "Usaremos X para Y porque Z.">
+
+   ## Alternativas Consideradas
+
+   ### Opção A: <nome>
+   - **Prós:** ...
+   - **Contras:** ...
+
+   ### Opção B: <nome>
+   - **Prós:** ...
+   - **Contras:** ...
+
+   ## Consequências
+
+   ### Positivas
+   - ...
+
+   ### Negativas / Trade-offs
+   - ...
+
+   ### Neutras / Observações
+   - ...
+
+   ## Referências
+   - <links, docs, issues relacionadas>
+   ```
+
+4. **Numbering**
+
+   Pergunte ao usuário qual número usar para o ADR (ADR-001, ADR-002, etc.) ou sugira verificar o diretório `docs/adr/` para o próximo número disponível.
+
+5. **Salvar o arquivo**
+
+   Pergunte se o usuário quer salvar o ADR em:
+   - `docs/adr/ADR-NNN-<slug>.md` (padrão recomendado)
+   - Outro local preferido pelo time
+
+   Se o usuário confirmar, crie o arquivo no local indicado.

package/pscode/content/dixi/claude-runtime/commands/arch-check.md

@@ -0,0 +1,64 @@
+# /pstld:arch-check — Verificação de conformidade arquitetural
+
+Você é um guardião de arquitetura verificando se o código atual respeita as regras definidas para o projeto.
+
+## Passos
+
+1. **Leia o contexto do projeto**
+
+   - Leia `.pscode-dixi.yaml` na raiz do projeto para determinar `stack` e `family`.
+   - Leia `pastelsdd/context/architecture.md` para carregar as regras arquiteturais vigentes.
+   - Se `pastelsdd/context/architecture.md` não existir, informe o usuário e sugira `pscode init --profile dixi` para instalar os context docs.
+
+2. **Determine o escopo da verificação**
+
+   Se o usuário especificou um escopo (arquivo, módulo, camada), foque nele.
+   Caso contrário, pergunte: verificação pontual (mudança atual) ou varredura ampla (módulo/serviço)?
+
+3. **Execute a verificação de acordo com a stack**
+
+   ### Java / Spring (Arquitetura Hexagonal)
+
+   Verifique as seguintes regras (conforme `pastelsdd/context/architecture.md`):
+
+   - **Regra de dependência:** `infrastructure → application → domain`. Imports proibidos:
+     - `domain.*` importando `application.*` ou `infrastructure.*`
+     - `application.*` importando `infrastructure.*`
+   - **Nomenclatura por camada:** entidades sem sufixo em `domain/entity/`, use cases em `application/usecase/`, ports em `application/port/in/` e `application/port/out/`, adapters em `infrastructure/adapter/`
+   - **Pureza do domínio:** `domain/` sem anotações de framework (Spring, JPA, etc.)
+   - **Acesso via interfaces:** adapters acessam `application` somente via ports
+
+   ### React / Next.js (Feature-Sliced Design)
+
+   Verifique as seguintes regras (conforme `pastelsdd/context/architecture.md`):
+
+   - **Isolamento de features:** imports cruzados entre features são proibidos (feature A não importa de feature B)
+   - **Camadas permitidas:** `app → pages → widgets → features → entities → shared`
+   - **Shared é agnóstico:** `shared/` não importa de nenhuma outra camada
+   - **Lógica em pages/app:** lógica de negócio inline em `pages/` ou `app/` é um warning
+
+   ### Stack não detectada
+
+   Execute verificações genéricas: acoplamento excessivo, imports circulares, violações de separação de responsabilidades visíveis no código.
+
+4. **Reporte os resultados**
+
+   ```markdown
+   ## Resultado da Verificação Arquitetural
+
+   **Stack:** <detectada>
+   **Escopo:** <arquivos/módulos analisados>
+
+   ### Violações Encontradas
+   | Arquivo | Linha | Regra Violada | Severidade |
+   |---------|-------|---------------|------------|
+   | ...     | ...   | ...           | ERRO/WARN  |
+
+   ### Conformidades Verificadas ✅
+   - <regra OK>
+
+   ### Recomendações
+   - <ação corretiva para cada violação>
+   ```
+
+5. **Se não houver violações**, confirme que o código está em conformidade com `pastelsdd/context/architecture.md`.

package/pscode/content/dixi/claude-runtime/commands/dod.md

@@ -0,0 +1,66 @@
+# /pstld:dod — Verificação de Definition of Done
+
+Você é um quality gate verificando se o item de trabalho corrente atende todos os critérios de Definition of Done do projeto.
+
+## Passos
+
+1. **Leia os critérios de DoD**
+
+   - Leia `pastelsdd/context/dod.md` para carregar os critérios oficiais de DoD do projeto.
+   - Se `pastelsdd/context/dod.md` não existir, informe o usuário:
+     ```
+     ℹ️  Arquivo pastelsdd/context/dod.md não encontrado.
+     Execute pscode init --profile dixi para instalar os context docs da Dixi.
+     Enquanto isso, usarei critérios genéricos de DoD.
+     ```
+     Use os critérios genéricos listados no passo 3.
+
+2. **Identifique o item em progresso**
+
+   Pergunte ao usuário (se não fornecido como argumento):
+   - Qual é o item sendo avaliado? (nome da feature, ticket JIRA, change do pscode)
+   - Há contexto adicional relevante (PR aberto, branch, change name)?
+
+3. **Verifique cada critério**
+
+   Para cada critério em `pastelsdd/context/dod.md` (ou os genéricos abaixo), avalie o estado atual:
+
+   **Critérios genéricos (usados quando dod.md não existe):**
+   - Código implementado e funcionando
+   - Testes unitários escritos e passando
+   - Testes de integração cobrindo o fluxo principal
+   - Code review realizado ou solicitado
+   - Documentação atualizada (se aplicável)
+   - Sem violações de arquitetura detectadas
+   - Build passando sem erros
+   - Deploy em ambiente de testes validado
+
+4. **Produza o relatório de DoD**
+
+   ```markdown
+   ## Definition of Done — <nome do item>
+
+   **Data:** <data atual>
+   **Fonte dos critérios:** pastelsdd/context/dod.md | critérios genéricos
+
+   | Critério | Status | Observação |
+   |----------|--------|------------|
+   | <critério 1> | ✅ Atendido | ... |
+   | <critério 2> | ❌ Pendente | <o que falta> |
+   | <critério 3> | ⚠️ Parcial  | <o que está incompleto> |
+
+   ### Resumo
+   - ✅ Atendidos: N
+   - ❌ Pendentes: N
+   - ⚠️ Parciais: N
+
+   ### Próximos Passos
+   <lista das ações necessárias para completar os critérios pendentes>
+
+   **Conclusão:** ✅ Pronto para entrega | ❌ Não está pronto — N critérios pendentes
+   ```
+
+5. **Orientação final**
+
+   - Se todos os critérios estiverem atendidos: sugira `/ps:complete` para arquivar a change.
+   - Se houver pendências: liste as ações prioritárias para concluir o item.

package/pscode/content/dixi/claude-runtime/commands/jira-draft.md

@@ -0,0 +1,80 @@
+# /pstld:jira-draft — Criar rascunho de issue JIRA
+
+Você é um assistente de integração JIRA criando uma issue a partir do contexto da change atual.
+
+## Passos
+
+1. **Leia a configuração JIRA local**
+
+   Leia o arquivo `pastelsdd/jira.yaml` na raiz do projeto.
+
+   - **Se o arquivo não existir ou `configured: false`:**
+     ```
+     ℹ️  Integração JIRA não configurada.
+     Execute /pstld:jira-setup para configurar o projeto, tipo de issue e transição "done".
+     ```
+     Encerre aqui.
+
+2. **Identifique a change ativa**
+
+   Verifique se há uma change ativa em `pscode/changes/`. Se houver exatamente uma, use-a. Se houver várias, peça ao usuário para especificar. Se não houver nenhuma, solicite título e descrição manualmente.
+
+   - **Se a change for identificada:** leia `proposal.md` e `.pscode.yaml` para extrair título e contexto.
+   - **Se não houver change:** solicite título e descrição ao usuário antes de continuar.
+
+3. **Verifique disponibilidade do MCP Atlassian**
+
+   Tente obter informações do usuário autenticado:
+
+   ```tool
+   mcp__atlassian__get_current_user
+   ```
+
+   - **Se falhar:**
+     ```
+     ⚠️  MCP Atlassian não está disponível nesta sessão.
+     Verifique se o servidor MCP está configurado em .mcp.json e reinicie o Claude Code.
+     ```
+     Encerre aqui.
+
+4. **Crie a issue JIRA**
+
+   Use os dados de `jira.yaml` (`projectKey`, `defaultIssueType`) e o contexto da change para criar a issue:
+
+   ```tool
+   mcp__atlassian__create_issue
+     project: <projectKey de jira.yaml>
+     summary: <título da change>
+     description: <descrição derivada do proposal.md ou fornecida pelo usuário>
+     issuetype: <defaultIssueType de jira.yaml>
+   ```
+
+5. **Vincule a issue à change**
+
+   Se a issue for criada com sucesso e a change for identificada, grave o `jiraIssueKey` no `.pscode.yaml` da change:
+
+   - Leia o `.pscode.yaml` atual
+   - Adicione ou atualize o campo `jiraIssueKey` com a chave retornada (ex: `PROJ-123`)
+   - Salve o arquivo
+
+6. **Exiba o resultado**
+
+   ```markdown
+   ## Issue JIRA Criada ✅
+
+   **Issue:** <jiraIssueKey>
+   **Título:** <summary>
+   **Projeto:** <projectKey>
+   **Tipo:** <defaultIssueType>
+   **Link:** <url da issue>
+
+   O campo `jiraIssueKey` foi gravado em `.pscode.yaml`.
+   Ao executar `pscode complete`, a issue será transitada para "done" automaticamente.
+   ```
+
+7. **Tratamento de erros**
+
+   Para qualquer falha não coberta acima, exiba uma mensagem descritiva e sugira:
+   - Verificar conectividade de rede
+   - Confirmar permissões do token Atlassian
+   - Verificar `projectKey` e `defaultIssueType` em `pastelsdd/jira.yaml`

package/pscode/content/dixi/claude-runtime/commands/jira-setup.md

@@ -0,0 +1,105 @@
+# /pstld:jira-setup — Configurar integração JIRA
+
+Você é um assistente de configuração JIRA guiando o desenvolvedor na criação ou atualização de `pastelsdd/jira.yaml`.
+
+## Passos
+
+1. **Verifique disponibilidade do MCP Atlassian**
+
+   Tente obter informações do usuário autenticado:
+
+   ```tool
+   mcp__atlassian__get_current_user
+   ```
+
+   - **Se falhar:**
+     ```
+     ⚠️  MCP Atlassian não está disponível nesta sessão.
+     Para configurar, adicione ao .mcp.json do projeto:
+
+     {
+       "mcpServers": {
+         "atlassian": {
+           "command": "npx",
+           "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"]
+         }
+       }
+     }
+
+     Reinicie o Claude Code após adicionar a configuração.
+     ```
+     Encerre aqui.
+
+2. **Leia configuração existente (se houver)**
+
+   Tente ler `pastelsdd/jira.yaml`. Se existir e tiver valores, exiba-os como ponto de partida:
+   ```
+   Configuração atual encontrada:
+     Projeto: <projectKey>
+     Tipo de issue: <defaultIssueType>
+     Transição "done": <transitions.done>
+   ```
+
+3. **Selecione o projeto JIRA**
+
+   Liste os projetos acessíveis:
+
+   ```tool
+   mcp__atlassian__list_projects
+   ```
+
+   Apresente a lista ao usuário e peça para selecionar o projeto padrão para novas issues.
+   Se já houver um `projectKey` configurado, destaque-o como opção atual.
+
+4. **Selecione o tipo de issue padrão**
+
+   Liste os tipos de issue disponíveis para o projeto selecionado:
+
+   ```tool
+   mcp__atlassian__get_issue_types
+     project: <projectKey selecionado>
+   ```
+
+   Apresente a lista. O tipo padrão usual é "Story" ou "Task" — destaque se disponível.
+
+5. **Selecione a transição "done"**
+
+   Liste as transições disponíveis no workflow do projeto:
+
+   ```tool
+   mcp__atlassian__get_transitions
+     project: <projectKey selecionado>
+   ```
+
+   Apresente as transições e peça ao usuário para identificar qual representa "concluído/done".
+   Grave o **ID numérico** da transição escolhida (não o nome, pois IDs são estáveis).
+
+6. **Grave pastelsdd/jira.yaml**
+
+   Crie ou sobrescreva o arquivo com as escolhas:
+
+   ```yaml
+   project_key: "<projectKey>"
+   default_issue_type: "<defaultIssueType>"
+   configured: true
+   transitions:
+     done: "<ID da transição done>"
+   ```
+
+   Preserve quaisquer campos adicionais existentes no arquivo que não foram alterados.
+
+7. **Exiba resumo da configuração**
+
+   ```markdown
+   ## Integração JIRA Configurada ✅
+
+   **Projeto:** <projectKey>
+   **Tipo de issue padrão:** <defaultIssueType>
+   **Transição "done":** <nome> (ID: <id>)
+
+   ### Próximos passos
+   - Use /pstld:jira-draft para criar uma issue JIRA a partir da change atual
+   - Adicione `jiraIssueKey` ao .pscode.yaml de uma change para vinculá-la a uma issue existente
+   - Ao executar `pscode complete`, a issue vinculada será transitada para "done" automaticamente
+   - Use /pstld:jira-sync para verificar a conexão a qualquer momento
+   ```

package/pscode/content/dixi/claude-runtime/commands/jira-sync.md

@@ -0,0 +1,69 @@
+# /pstld:jira-sync — Verificação e sincronização com JIRA
+
+Você é um assistente de integração JIRA verificando a configuração e conexão com o projeto atual.
+
+## Passos
+
+1. **Leia a configuração JIRA local**
+
+   Leia o arquivo `pastelsdd/jira.yaml` na raiz do projeto.
+
+   - **Se o arquivo não existir:** informe o usuário de forma amigável:
+     ```
+     ℹ️  Integração JIRA não configurada.
+     Para configurar, rode: /pstld:jira-setup
+     O arquivo pastelsdd/jira.yaml será criado com suas preferências.
+     ```
+     Encerre aqui.
+
+   - **Se `configured: false`:** informe:
+     ```
+     ⚠️  Integração JIRA presente mas não ativada (configured: false).
+     Edite pastelsdd/jira.yaml e defina configured: true após preencher os campos.
+     ```
+     Mostre o conteúdo atual do arquivo para o usuário revisar. Encerre aqui.
+
+2. **Teste a conexão via MCP Atlassian**
+
+   Se `configured: true`, tente obter informações do usuário autenticado:
+
+   ```tool
+   mcp__atlassian__get_current_user
+   ```
+
+   - **Se o MCP não estiver disponível ou falhar:** informe:
+     ```
+     ⚠️  MCP Atlassian não está disponível nesta sessão.
+     Verifique se o MCP está configurado em .mcp.json e reinicie o Claude Code.
+     Configuração esperada: pastelsdd/jira.yaml → cloudId: <seu-cloud-id>
+     ```
+     Encerre aqui.
+
+3. **Exiba o status da integração**
+
+   Produza um resumo claro:
+
+   ```markdown
+   ## Status da Integração JIRA ✅
+
+   **Usuário autenticado:** <nome do usuário>
+   **Cloud ID:** <cloudId de pastelsdd/jira.yaml>
+   **Projeto padrão:** <projectKey de pastelsdd/jira.yaml>
+   **Tipo de issue padrão:** <defaultIssueType>
+
+   ### Verificações
+   - ✅ pastelsdd/jira.yaml encontrado e configurado
+   - ✅ MCP Atlassian disponível e autenticado
+   - ✅ Conexão com JIRA estabelecida
+
+   ### Próximos passos
+   - Use /pstld:jira-draft para criar um rascunho de issue JIRA
+   - Vincule uma change ao JIRA adicionando jiraIssueKey ao .pscode.yaml
+   ```
+
+4. **Exibição de erros inesperados**
+
+   Para qualquer falha não coberta acima, mostre uma mensagem descritiva e sugira verificar:
+   - A conectividade de rede
+   - As permissões do token Atlassian
+   - O `cloudId` em `pastelsdd/jira.yaml`