@thiagodiogo/pscode 2.1.0 → 2.2.0

package/pscode/content/dixi/commands/ps/explore.md

@@ -0,0 +1,14 @@
+---
+name: "PS: Explore (Dixi)"
+description: Explore mode with Dixi stack-aware context
+category: Workflow
+tags: [workflow, explore, dixi]
+---
+
+Enter explore mode with Dixi architectural awareness.
+
+**Dixi preamble** (execute before entering explore mode):
+1. Read `.pscode-dixi.yaml` (if present) to identify `stack` and `family`.
+2. Read `pastelsdd/context/architecture.md` (if present) to load architectural constraints — reference them when evaluating options and trade-offs.
+
+Then execute the standard `pscode-explore` skill instructions in full.

package/pscode/content/dixi/commands/ps/propose.md

@@ -0,0 +1,14 @@
+---
+name: "PS: Propose (Dixi)"
+description: Propose a new change with Dixi stack-aware context
+category: Workflow
+tags: [workflow, artifacts, propose, dixi]
+---
+
+Propose a new change with Dixi architectural awareness.
+
+**Dixi preamble** (execute before generating any artifact):
+1. Read `.pscode-dixi.yaml` (if present) to identify `stack` and `family`.
+2. Read `pastelsdd/context/architecture.md` (if present) to load architectural constraints — use them as guardrails when writing the proposal and design.
+
+Then execute the standard `pscode-propose` skill instructions in full.

package/pscode/content/dixi/commands/ps/trello-setup.md

@@ -0,0 +1,14 @@
+---
+name: "PS: Trello Setup (Dixi)"
+description: "Configure Trello integration for your Pscode workflow — checks MCP, reads or creates a board, and writes pscode/trello.yaml"
+category: Setup
+tags: [trello, setup, integration, config, dixi]
+---
+
+Configure Trello integration for your Pscode workflow.
+
+This skill writes `pscode/trello.yaml` — a small config file that all Trello-aware commands
+(`/ps:draft`, `/ps:propose`, `/ps:apply`, `/ps:complete`) read at runtime to know which
+Trello list corresponds to each workflow stage and which labels are available.
+
+Then execute the standard `pscode-trello-setup` skill instructions in full.

package/pscode/content/dixi/commands/pstld/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/commands/pstld/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/commands/pstld/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/commands/pstld/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`