@seedgrid/ai-toolkit 0.3.0 → 0.3.2

package/seedgridKB/SeedGrid/Toolkit/skills/{seedgrid-new-screen → sg-new-screen}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: seedgrid-new-screen
+name: sg-new-screen
 description: Registrar uma tela, menu ou permissao nova no boilerplate SeedGrid (app do cliente `frontend/` ou admin da plataforma `admin/`) sem esquecer nenhum dos lugares que precisam ficar sincronizados - migration da permissao, item de menu, icone, item ativo, catalogo do editor de perfis e, se for vendavel por plano, o treeview de features do admin e o `@RequiresPlanFeature`. Use ao criar tela nova, acao nova numa tela existente, permissao nova, ou ao mover/renomear item de menu.
 ---
 

package/seedgridKB/SeedGrid/Toolkit/skills/sg-new-screen/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "SeedGrid tela nova"
+  short_description: "Tela, menu e permissoes sincronizados"
+  default_prompt: "Use $sg-new-screen to add a new screen with its permissions, menu item, icon, profile-editor catalog and, if sellable, the plan feature tree."

package/seedgridKB/SeedGrid/Toolkit/skills/sg-new-skill/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: sg-new-skill
+description: Cria uma skill nova no projeto - pergunta nome, descrição, quando usar e passos, e grava o SKILL.md em .ai/skills e nas pastas nativas do Claude Code e do Codex, atualizando o índice. Use SEMPRE que pedirem para criar, adicionar ou escrever uma skill, ou para transformar um procedimento repetido em skill.
+metadata:
+  toolkit: seedgrid-ai
+---
+
+# Criar uma skill
+
+Toda skill nova do projeto nasce por aqui, para ficar completa e nos lugares certos. Não crie skill escrevendo arquivos soltos.
+
+## Passos
+
+1. **Levantar os dados.** Pergunte o que faltar (junte as perguntas numa só mensagem e não pergunte o que o pedido já respondeu):
+   - **Nome:** minúsculas, números e hífens (`^[a-z0-9]+(-[a-z0-9]+)*$`), curto e específico (`gerar-relatorio-mensal`). Verbo ou tarefa, não "ajuda".
+   - **Objetivo:** o que a skill faz e o resultado esperado.
+   - **Quando usar:** os pedidos e situações que devem acioná-la (e, se houver, quando **não** usar).
+   - **Passos:** o procedimento, as regras e os cuidados. Se o usuário não tiver, proponha um rascunho e peça confirmação.
+   - **Arquivos de apoio:** checklists, exemplos ou scripts que valham um arquivo à parte (opcional).
+2. **Conferir duplicidade.** Veja `.ai/skills/`, `.claude/skills/` e `.agents/skills/`. Se já existir skill com o nome, ou outra que cubra o mesmo caso, mostre e pergunte se estende a existente. Nunca sobrescreva sem pedido explícito. Nomes que começam com `sg-` são reservados às skills do toolkit: o `update` as gerencia e uma skill do projeto com esse prefixo pode ser substituída. Não use `sg-` nas skills do projeto; se o usuário pedir esse prefixo, avise do risco e sugira outro.
+3. **Escrever o `SKILL.md`** em `.ai/skills/<nome>/SKILL.md`:
+   - Frontmatter só com `name` (igual ao nome da pasta) e `description`. Não use campos específicos de uma ferramenta (`context`, `allowed-tools`, `model` etc.).
+   - `description` em uma ou duas frases: o que faz **e quando usar**, com as palavras que o usuário diria. Se tiver `:`, ponha entre aspas. É por ela que o modelo decide chamar a skill, então seja específico.
+   - Corpo curto e direto: passos numerados, regras e saída esperada. Detalhes longos vão em `references/<assunto>.md`, citados no `SKILL.md` com link relativo. Nada de segredos, nem caminhos absolutos da sua máquina.
+4. **Copiar para as pastas nativas**, com o mesmo conteúdo (inclusive `references/` e demais arquivos), apenas nos destinos que o projeto usa: `.claude/skills/<nome>/` se a pasta `.claude/skills/` existir, `.agents/skills/<nome>/` se `.agents/skills/` existir. Sem nenhuma das duas, fique só com `.ai/skills/` e avise que a skill só será usada se o modelo ler o índice.
+5. **Registrar no índice do projeto.** Acrescente a skill em `.ai/skills/projeto.md` (crie se não existir, com o título `# Skills do projeto`), uma linha por skill: `- [nome](nome/SKILL.md): descrição`. **Não edite `.ai/skills/index.md`**: ele é gerado pelo toolkit e o `update` o reescreve (ele já cita o `projeto.md`).
+6. **Conferir.** Releia o `SKILL.md` gravado, confirme que as cópias são idênticas à de `.ai/skills/`, que nenhum link relativo está quebrado e que o `name` bate com a pasta.
+7. **Entregar.** Liste os arquivos criados e diga como usar: pelo nome (`/<nome>` no Claude Code, `$<nome>` no Codex) ou pedindo a tarefa com as palavras da descrição. Avise que uma sessão nova da ferramenta é necessária para listar a skill no menu.
+
+## Cuidados
+
+- Skills do projeto (inclusive o `projeto.md`) não entram no lock do toolkit: o `seedgrid-ai update` atualiza o conteúdo do toolkit e não as altera nem as remove. Para virarem parte do toolkit, precisam ser adicionadas ao conteúdo do `seedgrid-ai` (fonte e manifesto).
+- Uma skill, uma finalidade. Se a descrição precisa de "e também", provavelmente são duas skills.
+- Não duplique regras que já estão em `.ai/rules/`: cite o arquivo.
+- Para alterar uma skill existente do projeto, edite as três cópias e mantenha-as iguais.

package/seedgridKB/SeedGrid/Toolkit/skills/{planejar-mudanca → sg-plan-change}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: planejar-mudanca
+name: sg-plan-change
 description: Planeja uma mudança de código antes de implementar - entende o objetivo, lê o código afetado, define critérios de aceite, divide em tarefas e identifica riscos. Use quando a tarefa atravessa vários arquivos ou camadas, é ambígua ou envolve decisão de arquitetura.
 metadata:
   toolkit: seedgrid-ai

package/seedgridKB/SeedGrid/Toolkit/skills/{seedgrid-review → sg-review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: seedgrid-review
+name: sg-review
 description: Verifica se o código-fonte de um projeto segue os padrões SeedGrid (front React com @seedgrid/fe-components e back Java), citando cada violação por id de regra, arquivo e linha. Use quando pedirem para revisar, auditar ou conferir o padrão SeedGrid, depois de implementar uma tela ou serviço, ou antes de abrir um PR. Aceita o escopo "front", "back" ou nenhum (os dois).
 metadata:
   toolkit: seedgrid-ai

package/seedgridKB/SeedGrid/Toolkit/skills/{validar-mudanca → sg-validate-change}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: validar-mudanca
+name: sg-validate-change
 description: Valida uma mudança de código executando build, testes e verificações ligadas aos critérios de aceite, e registra evidências em um relatório. Use antes de declarar uma tarefa concluída ou após correções de revisão.
 metadata:
   toolkit: seedgrid-ai

package/seedgridKB/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "contentVersion": "0.3.0",
+  "contentVersion": "0.3.2",
   "toolkitBase": "SeedGrid/Toolkit",
   "components": [
     {
@@ -21,6 +21,7 @@
       "files": [
         "rules/coordenacao.md",
         "rules/formato-entrega.md",
+        "rules/documentos.md",
         "rules/personalizacao-local.md",
         "rules/frontend-seedgrid.md",
         "rules/backend-java-seedgrid.md"
@@ -45,9 +46,9 @@
       ]
     },
     {
-      "id": "skill:planejar-mudanca",
+      "id": "skill:sg-plan-change",
       "type": "skill",
-      "name": "planejar-mudanca",
+      "name": "sg-plan-change",
       "files": [
         "SKILL.md",
         {
@@ -57,18 +58,18 @@
       ]
     },
     {
-      "id": "skill:revisar-codigo",
+      "id": "skill:sg-code-review",
       "type": "skill",
-      "name": "revisar-codigo",
+      "name": "sg-code-review",
       "files": [
         "SKILL.md",
         "references/checklist.md"
       ]
     },
     {
-      "id": "skill:validar-mudanca",
+      "id": "skill:sg-validate-change",
       "type": "skill",
-      "name": "validar-mudanca",
+      "name": "sg-validate-change",
       "files": [
         "SKILL.md",
         {
@@ -78,17 +79,17 @@
       ]
     },
     {
-      "id": "skill:seedgrid-backend-crud",
+      "id": "skill:sg-crud-back",
       "type": "skill",
-      "name": "seedgrid-backend-crud",
+      "name": "sg-crud-back",
       "files": [
         "SKILL.md"
       ]
     },
     {
-      "id": "skill:seedgrid-crud",
+      "id": "skill:sg-crud-front",
       "type": "skill",
-      "name": "seedgrid-crud",
+      "name": "sg-crud-front",
       "files": [
         "SKILL.md",
         "references/patterns.md",
@@ -98,9 +99,9 @@
       ]
     },
     {
-      "id": "skill:seedgrid-new-screen",
+      "id": "skill:sg-new-screen",
       "type": "skill",
-      "name": "seedgrid-new-screen",
+      "name": "sg-new-screen",
       "files": [
         "SKILL.md",
         "references/steps.md",
@@ -109,17 +110,25 @@
       ]
     },
     {
-      "id": "skill:seedgrid-bump",
+      "id": "skill:sg-bump",
       "type": "skill",
-      "name": "seedgrid-bump",
+      "name": "sg-bump",
       "files": [
         "SKILL.md"
       ]
     },
     {
-      "id": "skill:seedgrid-review",
+      "id": "skill:sg-new-skill",
       "type": "skill",
-      "name": "seedgrid-review",
+      "name": "sg-new-skill",
+      "files": [
+        "SKILL.md"
+      ]
+    },
+    {
+      "id": "skill:sg-review",
+      "type": "skill",
+      "name": "sg-review",
       "files": [
         "SKILL.md"
       ]

package/seedgridKB/SeedGrid/Toolkit/skills/seedgrid-new-screen/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "SeedGrid tela nova"
-  short_description: "Tela, menu e permissoes sincronizados"
-  default_prompt: "Use $seedgrid-new-screen to add a new screen with its permissions, menu item, icon, profile-editor catalog and, if sellable, the plan feature tree."