@thiagodiogo/pscode 1.0.0 → 2.0.0

package/pscode/content/dixi/context/shared/dev-flow.md

@@ -0,0 +1,53 @@
+# Fluxo de Desenvolvimento
+
+## Visão geral
+
+```
+RFC → Design → Tasks → Apply → Revisão → Deploy
+```
+
+Use `/pstld:rfc` para iniciar o fluxo, `/pstld:dod` para validar antes de abrir o PR.
+
+## Quando criar RFC
+
+Crie uma RFC quando a mudança:
+
+- Afeta a arquitetura de um módulo ou a interface entre módulos
+- Introduz uma nova dependência externa
+- Muda o contrato de uma API pública
+- Demora mais de 1 dia de implementação
+
+Vá direto para task quando:
+
+- É um bug fix isolado com causa clara
+- É uma tarefa mecânica sem impacto arquitetural (atualização de cópia, ajuste de estilo, etc.)
+- É uma task de refactor de escopo delimitado aprovada previamente
+
+## Fase RFC
+
+1. Use `/pstld:rfc` para gerar o rascunho da RFC
+2. A RFC deve conter: contexto, problema, solução proposta, alternativas consideradas, trade-offs
+3. Solicite revisão dos tech leads antes de avançar
+4. RFC aprovada → avançar para Design
+
+## Fase Design
+
+1. Use `/ps:propose` para gerar o design e as specs
+2. O design deve ser revisado antes de iniciar a implementação
+3. Specs descrevem comportamento esperado (não implementação)
+
+## Fase Tasks + Apply
+
+1. Use `/ps:apply` para iniciar a implementação
+2. Marque cada task como concluída ao terminar
+3. Mantenha o escopo — não adicione tarefas não planejadas sem atualizar o design
+
+## Validação antes do PR
+
+Execute `/pstld:dod` para verificar o DoD antes de abrir o PR.
+
+O slash command verifica automaticamente:
+- Testes passando
+- Cobertura mantida
+- Ticket JIRA referenciado nos commits
+- Checklist de DoD completo

package/pscode/content/dixi/context/shared/dod.md

@@ -0,0 +1,38 @@
+# Definition of Done
+
+## Feature
+
+Uma feature está pronta quando:
+
+- [ ] RFC aprovada pelos tech leads (quando mudança significativa)
+- [ ] Design revisado e aceito antes da implementação
+- [ ] Todas as tasks do `/ps:apply` marcadas como concluídas
+- [ ] Testes passando (unitários, integração e E2E conforme pirâmide)
+- [ ] Cobertura de testes mantida ou melhorada
+- [ ] PR aprovado por pelo menos 1 revisor
+- [ ] CHANGELOG ou changeset atualizado
+- [ ] Ticket JIRA movido para "Em Teste"
+
+## Bug Fix
+
+Um bug fix está pronto quando:
+
+- [ ] Root cause identificado e documentado no PR ou ticket JIRA
+- [ ] Teste de regressão adicionado que reproduz o bug antes da correção
+- [ ] Correção implementada e testes passando
+- [ ] PR aprovado por pelo menos 1 revisor
+- [ ] Ticket JIRA movido para "Em Teste"
+
+## Refactor
+
+Um refactor está pronto quando:
+
+- [ ] Comportamento externo preservado (testes existentes continuam passando sem modificação)
+- [ ] Cobertura de testes mantida ou melhorada
+- [ ] Nenhuma lógica de negócio foi alterada (se houver, deve virar um `feat` ou `fix`)
+- [ ] PR aprovado por pelo menos 1 revisor
+- [ ] Sem regressões em funcionalidades adjacentes
+
+## Critério de "Em Produção"
+
+O ciclo só fecha quando a feature ou fix está deployada e monitorada por pelo menos 24h sem alertas.

package/pscode/content/dixi/context/shared/pr-flow.md

@@ -0,0 +1,53 @@
+# Fluxo de Pull Request
+
+## Template de PR
+
+```markdown
+## O que muda
+<!-- Descreva de forma concisa o que este PR altera -->
+
+## Por que
+<!-- Explique a motivação. Referencie o ticket JIRA: [PROJ-123] -->
+
+## Como testar
+<!-- Passo a passo para o revisor validar manualmente -->
+1. 
+2. 
+3. 
+
+## Checklist
+- [ ] Testes adicionados/atualizados
+- [ ] Cobertura mantida ou melhorada
+- [ ] DoD verificado (`/pstld:dod`)
+- [ ] Sem TODOs temporários deixados no código
+- [ ] Documentação atualizada (se aplicável)
+```
+
+## Referenciando tickets JIRA
+
+- Inclua `[PROJ-123]` no título do PR
+- Use `Closes PROJ-123` ou `Refs PROJ-123` na descrição quando a integração JIRA estiver configurada
+- O ticket deve estar em "Em Revisão" quando o PR for aberto
+
+## Processo de revisão
+
+1. Abra o PR apontando para a branch de destino (geralmente `main` ou `develop`)
+2. Solicite revisão de pelo menos 1 membro do time
+3. Responda todos os comentários antes de fazer merge
+4. Após aprovação, faça squash merge ou merge commit conforme a convenção do projeto
+
+## Critérios de merge
+
+Um PR pode ser mergeado quando:
+
+- CI passou (build, lint, testes, cobertura)
+- Pelo menos 1 aprovação de revisor
+- Todos os comentários resolvidos
+- Sem conflitos com a branch de destino
+- DoD verificado
+
+## Tamanho ideal de PR
+
+Prefira PRs com menos de 400 linhas modificadas. PRs grandes aumentam o tempo de revisão e o risco de bugs passarem despercebidos.
+
+Se o PR estiver muito grande, considere quebrá-lo em partes menores com dependência sequencial.

package/pscode/content/dixi/kit/java/.editorconfig

@@ -0,0 +1,25 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.java]
+indent_style = space
+indent_size = 4
+charset = utf-8
+end_of_line = lf
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.xml]
+indent_style = space
+indent_size = 4
+
+[*.properties]
+indent_style = space
+indent_size = 4

package/pscode/content/dixi/kit/java/.github/workflows/ci-java.yml

@@ -0,0 +1,68 @@
+name: CI Java
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: temurin
+          cache: maven
+      - name: Compile
+        run: mvn compile
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: temurin
+          cache: maven
+      - name: Run tests
+        run: mvn test
+
+  archunit:
+    name: ArchUnit
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: temurin
+          cache: maven
+      - name: Run architecture tests
+        run: mvn test -Dtest=ArchitectureTest
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: temurin
+          cache: maven
+      - name: Generate coverage report
+        run: mvn jacoco:report
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: jacoco-report
+          path: target/site/jacoco/

package/pscode/content/dixi/kit/java/.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx --no-install commitlint --edit "$1"

package/pscode/content/dixi/kit/react/.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{ts,tsx,js,jsx}]
+indent_style = space
+indent_size = 2
+charset = utf-8
+
+[*.{css,scss}]
+indent_style = space
+indent_size = 2
+
+[*.{json,yml,yaml,md}]
+indent_style = space
+indent_size = 2

package/pscode/content/dixi/kit/react/.github/workflows/ci-react.yml

@@ -0,0 +1,80 @@
+name: CI React
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: Type check
+        run: npx tsc --noEmit
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    needs: typecheck
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: Lint
+        run: npm run lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    needs: typecheck
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: Run tests
+        run: npm test
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: Build
+        run: npm run build
+
+  e2e:
+    name: E2E
+    runs-on: ubuntu-latest
+    needs: build
+    if: ${{ hashFiles('playwright.config.ts') != '' }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps
+      - name: Run E2E tests
+        run: npx playwright test

package/pscode/content/dixi/kit/react/.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx --no-install commitlint --edit "$1"

package/pscode/content/dixi/kit/react/.husky/pre-commit

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx --no-install lint-staged

package/pscode/content/dixi/kit/react/lint-staged.config.mjs

@@ -0,0 +1,4 @@
+export default {
+  '*.{ts,tsx}': ['eslint --fix', 'prettier --write'],
+  '*.{css,scss,md,json}': ['prettier --write'],
+};

package/pscode/content/dixi/kit/shared/.commitlintrc.yml

@@ -0,0 +1,15 @@
+extends:
+  - '@commitlint/config-conventional'
+
+plugins:
+  - commitlint-plugin-jira-rules
+
+rules:
+  subject-case:
+    - 2
+    - always
+    - lower-case
+  jira-task-id-max-length:
+    - 1
+    - always
+    - 120

package/pscode/content/dixi/kit/shared/.github/pull_request_template.md

@@ -0,0 +1,24 @@
+## O que muda
+
+<!-- Descreva o que esta PR adiciona, modifica ou remove. -->
+
+## Por que (contexto + ticket)
+
+<!-- Explique a motivação da mudança. Inclua o ticket JIRA no formato: Refs: PROJ-123 -->
+
+Refs:
+
+## Como testar
+
+<!-- Passo a passo para validar a mudança localmente ou em ambiente de teste. -->
+
+1.
+2.
+3.
+
+## Checklist
+
+- [ ] Testes passando (`pnpm test` / `mvn test`)
+- [ ] Sem TODO pendente no código
+- [ ] CHANGELOG / changeset atualizado (se aplicável)
+- [ ] Título da PR em formato conventional commit (`feat(scope): descrição [PROJ-123]`)

package/schemas/pstld-workflow/schema.yaml

@@ -0,0 +1,67 @@
+name: pstld-workflow
+version: 1
+description: Dixi workflow - rfc → design → tasks
+artifacts:
+  - id: rfc
+    generates: rfc.md
+    description: Request for Comments document defining the problem and proposed solution
+    template: rfc.md
+    instruction: |
+      Create the RFC document that establishes WHAT needs to be built and WHY.
+
+      Sections:
+      - **Context**: Background, current state, and constraints that motivate this change
+      - **Problem**: Clear statement of the problem being solved
+      - **Proposed Solution**: Description of the solution approach at a conceptual level
+      - **Alternatives Considered**: Other approaches evaluated and why they were rejected
+      - **Architectural Impact**: Effects on existing architecture, dependencies, or interfaces
+      - **Acceptance Criteria**: Verifiable conditions that define when this RFC is satisfied
+
+      Keep the RFC focused on the WHAT and WHY — leave implementation details for design.md.
+      Acceptance Criteria should be specific enough to derive test cases.
+    requires: []
+
+  - id: design
+    generates: design.md
+    description: Technical design document with implementation approach and decisions
+    template: design.md
+    instruction: |
+      Create the design document that explains HOW to implement the RFC.
+
+      Sections:
+      - **Affected Components**: List of modules, services, or layers touched by this change
+      - **Interface Contracts**: APIs, function signatures, data shapes, or protocol changes
+      - **Test Plan**: What to test, at which layer (unit/integration/e2e), and key scenarios
+      - **Security Considerations**: Authentication, authorization, input validation, data exposure risks
+
+      Reference the RFC for motivation and acceptance criteria.
+      Focus on concrete technical decisions and their rationale.
+    requires:
+      - rfc
+
+  - id: tasks
+    generates: tasks.md
+    description: Implementation checklist derived from RFC and design
+    template: tasks.md
+    instruction: |
+      Create the task list that breaks down the implementation work.
+
+      Guidelines:
+      - Group related tasks under ## numbered headings
+      - Each task MUST be a checkbox: `- [ ] X.Y Task description`
+      - Tasks should be small enough to complete in one session
+      - Order tasks by dependency (what must be done first?)
+      - End with a Definition of Done section
+
+      Reference the RFC acceptance criteria and design decisions.
+      Each task should be verifiable — you know when it's done.
+    requires:
+      - rfc
+      - design
+
+apply:
+  requires: [tasks]
+  tracks: tasks.md
+  instruction: |
+    Read context files, work through pending tasks, mark complete as you go.
+    Pause if you hit blockers or need clarification.

package/schemas/pstld-workflow/templates/design.md

@@ -0,0 +1,15 @@
+## Affected Components
+
+<!-- List of modules, services, or layers touched by this change -->
+
+## Interface Contracts
+
+<!-- APIs, function signatures, data shapes, or protocol changes -->
+
+## Test Plan
+
+<!-- What to test, at which layer (unit/integration/e2e), and key scenarios -->
+
+## Security Considerations
+
+<!-- Authentication, authorization, input validation, data exposure risks -->

package/schemas/pstld-workflow/templates/rfc.md

@@ -0,0 +1,26 @@
+## Context
+
+<!-- Background, current state, and constraints that motivate this change -->
+
+## Problem
+
+<!-- Clear statement of the problem being solved -->
+
+## Proposed Solution
+
+<!-- Description of the solution approach at a conceptual level -->
+
+## Alternatives Considered
+
+<!-- Other approaches evaluated and why they were rejected -->
+
+## Architectural Impact
+
+<!-- Effects on existing architecture, dependencies, or interfaces -->
+
+## Acceptance Criteria
+
+<!-- Verifiable conditions that define when this RFC is satisfied -->
+
+- [ ] <!-- Criterion 1 -->
+- [ ] <!-- Criterion 2 -->

package/schemas/pstld-workflow/templates/tasks.md

@@ -0,0 +1,15 @@
+## 1. <!-- Task Group Name -->
+
+- [ ] 1.1 <!-- Task description -->
+- [ ] 1.2 <!-- Task description -->
+
+## 2. <!-- Task Group Name -->
+
+- [ ] 2.1 <!-- Task description -->
+- [ ] 2.2 <!-- Task description -->
+
+## Definition of Done
+
+- [ ] All acceptance criteria from the RFC are met
+- [ ] Test plan from design is executed
+- [ ] No regressions in existing functionality

package/dist/core/templates/workflows/sync-specs.d.ts

@@ -1,10 +0,0 @@
-/**
- * Skill Template Workflow Modules
- *
- * This file is generated by splitting the legacy monolithic
- * templates file into workflow-focused modules.
- */
-import type { SkillTemplate, CommandTemplate } from '../types.js';
-export declare function getSyncSpecsSkillTemplate(): SkillTemplate;
-export declare function getPsSyncCommandTemplate(): CommandTemplate;
-//# sourceMappingURL=sync-specs.d.ts.map