From 4c46b2ac2647c60f9d5b0bfedde093fbff5986b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Isaque=20B=C3=B6ck?= Date: Wed, 20 May 2026 17:22:21 -0300 Subject: [PATCH] chore: remove skills folder --- skills/CONTRIBUTING.md | 33 ---------- skills/README.md | 20 ------ skills/_template.md | 55 ---------------- skills/migracao-azion-theme.md | 115 --------------------------------- 4 files changed, 223 deletions(-) delete mode 100644 skills/CONTRIBUTING.md delete mode 100644 skills/README.md delete mode 100644 skills/_template.md delete mode 100644 skills/migracao-azion-theme.md diff --git a/skills/CONTRIBUTING.md b/skills/CONTRIBUTING.md deleted file mode 100644 index e2b09b18..00000000 --- a/skills/CONTRIBUTING.md +++ /dev/null @@ -1,33 +0,0 @@ -# Contributing Skills - -Guia para criacao e manutencao de skills em `skills/`. - -## Objetivo - -Garantir que todas as skills tenham formato consistente, regras claras e resultado auditavel. - -## Regras obrigatorias - -- Usar `skills/_template.md` como estrutura base. -- Definir entradas e saidas de forma objetiva. -- Declarar guardrails explicitos (o que a skill nunca deve fazer). -- Incluir criterio de conclusao verificavel (Definition of Done). -- Evitar acoplamento com arquivo unico; usar escopo por diretorio/glob. - -## Processo recomendado - -1. Criar a skill a partir do template. -2. Revisar se as secoes obrigatorias foram preenchidas. -3. Validar se a skill aponta para fontes de verdade (docs, guias, padroes do repo). -4. Incluir ao menos um exemplo de uso. -5. Atualizar `skills/README.md` com a descricao curta no catalogo. - -## Checklist de revisao - -- [ ] Nome e objetivo claros. -- [ ] Entradas e saidas bem definidas. -- [ ] Workflow sequencial sem ambiguidades. -- [ ] Regras de decisao e fallback documentadas. -- [ ] Guardrails cobrindo operacoes de risco. -- [ ] Definition of Done mensuravel. -- [ ] Exemplo de uso incluso. diff --git a/skills/README.md b/skills/README.md deleted file mode 100644 index 24801dcc..00000000 --- a/skills/README.md +++ /dev/null @@ -1,20 +0,0 @@ -# Skills - -Colecao de skills operacionais para acelerar tarefas recorrentes no monorepo. - -## Quando usar - -- Quando uma tarefa for repetitiva e exigir as mesmas decisoes de implementacao. -- Quando for importante padronizar formato de saida, checklist e criterio de conclusao. -- Quando houver risco de divergencia entre PRs para o mesmo tipo de mudanca. - -## Convencoes - -- Cada skill deve viver em um arquivo unico em `skills/*.md`. -- Cada skill deve seguir o formato padrao descrito em `skills/_template.md`. -- Toda nova skill ou atualizacao deve seguir `skills/CONTRIBUTING.md`. -- Skills devem ser orientadas por escopo (diretorio/glob), nunca por arquivo fixo. - -## Catalogo - -- `migracao-azion-theme`: migra estilos legados (Tailwind padrao + HEX hardcoded) para tokens do `@aziontech/theme`, com foco em semantica, consistencia visual e suporte a light/dark mode. diff --git a/skills/_template.md b/skills/_template.md deleted file mode 100644 index 84c3a5ce..00000000 --- a/skills/_template.md +++ /dev/null @@ -1,55 +0,0 @@ -# Skill: - -## Metadata - -- `name`: `` -- `version`: `1.0.0` -- `owner`: `` -- `status`: `draft|active|deprecated` -- `last_updated`: `YYYY-MM-DD` - -## Purpose - -Descricao curta do objetivo da skill em 1-2 frases. - -## Inputs - -- Escopo aceito (diretorio/glob/conjunto de arquivos). -- Restricoes relevantes. -- Dependencias de contexto (docs, configuracoes, padroes). - -## Outputs - -- Formato de saida esperado. -- Artefatos que devem ser gerados (ex.: relatorio, diff, checklist). - -## Workflow - -1. Passo 1. -2. Passo 2. -3. Passo 3. - -## Rules - -- Regra de priorizacao principal. -- Regras de decisao para casos comuns. - -## Guardrails - -- O que nunca deve ser feito. -- Limites de alteracao aceitaveis. - -## Fallbacks - -- O que fazer quando nao houver mapeamento direto. -- Como registrar pendencias e excecoes. - -## Definition of Done - -- [ ] Criterio objetivo 1. -- [ ] Criterio objetivo 2. -- [ ] Criterio objetivo 3. - -## Example - -Exemplo de invocacao e resultado esperado. diff --git a/skills/migracao-azion-theme.md b/skills/migracao-azion-theme.md deleted file mode 100644 index 4b5b6c6e..00000000 --- a/skills/migracao-azion-theme.md +++ /dev/null @@ -1,115 +0,0 @@ -# Skill: migracao-azion-theme - -## Metadata - -- `name`: `migracao-azion-theme` -- `version`: `1.0.0` -- `owner`: `webkit-design-system` -- `status`: `active` -- `last_updated`: `2026-04-24` - -## Purpose - -Migrar estilos legados para `@aziontech/theme`, removendo HEX hardcoded e classes Tailwind nao semanticas quando aplicavel. - -## Inputs - -- Escopo de migracao em diretorio, glob ou conjunto de arquivos. -- Exemplo de escopos validos: - - `packages/webkit/src/components/**` - - `packages/webkit/src/core/**` - - qualquer escopo informado pelo usuario -- Fonte de verdade obrigatoria: - - `docs/MIGRACAO_AZION_THEME.md` - -Importante: nao assumir arquivo especifico fixo. - -## Outputs - -- Diff com alteracoes aplicadas no escopo informado. -- Relatorio curto contendo: - - resumo da migracao - - tabela `antes -> depois` por tipo (`text`, `bg`, `border`) - - lista de excecoes justificadas - - pendencias de tokenizacao - - checklist de validacao preenchido - -## Workflow - -1. Auditar o escopo: - - localizar HEX hardcoded - - localizar classes Tailwind legadas de cor - -2. Classificar intencao visual de cada ocorrencia: - - texto, fundo, borda - - estado semantico (`primary`, `danger`, `success`, `warning`, `link`) - - superficie/canvas - -3. Aplicar substituicoes: - - semantico primeiro - - primitivo como fallback - -4. Validar o resultado: - - sem regressao de estados (`hover`, `focus`, `disabled`, `active`) - - aderencia a light/dark mode - - ausencia de novos HEX desnecessarios - -5. Reportar resultados: - - arquivos alterados - - mapeamentos aplicados - - pendencias e excecoes - -## Rules - -1. Prioridade de substituicao: - 1. token semantico (`text-default`, `text-muted`, `bg-surface`, `bg-primary`, `border-subtle`, etc.) - 2. token primitivo mais proximo (`orange-500`, `violet-300`, `slate-900`, etc.) - 3. se nao houver match adequado, registrar pendencia de tokenizacao - -2. Mapeamento base (resumo): - - `#fe601f` / `#f3652b` -> `primary` (ou `orange-500`) - - `#d95522` / `#d94a03` -> `primary-hover` (ou `orange-600`) - - `#ef4444` / `#dc2626` -> `danger` (ou `red-500`/`red-600`) - - `#22c55e` / `#16a34a` -> `success` (ou `green-500`/`green-600`) - - `#eab308` / `#ca8a04` -> `warning` (ou `yellow-500`/`yellow-600`) - - `#13131a` -> `slate-950` (avaliar `bg-surface`/`bg-canvas`) - - `#353040` -> `slate-900` (avaliar `border-subtle`) - - `#b5b1f4` -> `violet-300` - - `#8a84ec` -> `violet-500` - -3. Preservar: - - estrutura, eventos, props e logica existente - - acessibilidade e comportamento interativo - - consistencia com padrao dominante no projeto - -## Guardrails - -- Nao introduzir novos HEX hardcoded sem justificativa. -- Nao alterar comportamento funcional para resolver apenas estilo. -- Nao misturar padroes de nomenclatura no mesmo componente sem motivo claro. -- Nao assumir equivalencias semanticas sem validar intencao visual. - -## Fallbacks - -- Se nao houver token semantico equivalente, usar token primitivo mais proximo. -- Se nao houver primitivo adequado, manter valor atual temporariamente e registrar pendencia. -- Em casos de branding/ilustracao (ex.: SVGs de marca), excecao pode ser aceita com justificativa no relatorio. - -## Definition of Done - -- [ ] Nenhum novo HEX hardcoded foi introduzido no escopo alterado. -- [ ] Estados visuais e interativos foram preservados. -- [ ] Tokens semanticos foram priorizados sobre primitivos quando possivel. -- [ ] Todo fallback primitivo foi usado apenas quando necessario e documentado. -- [ ] Pendencias de tokenizacao foram registradas quando aplicavel. - -## Example - -Input: - -- Escopo: `packages/webkit/src/components/**` - -Output esperado: - -- Arquivos migrados dentro do escopo com substituicao de HEX/classes legadas. -- Relatorio com `antes -> depois`, excecoes e checklist final.