@seedgrid/ai-toolkit 0.3.2 → 0.3.3

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

@@ -1,15 +1,15 @@
 ---
 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.
+description: Cria ou altera uma skill do projeto - pergunta nome, descrição, quando usar e passos, grava o SKILL.md em .ai/skills e sincroniza as pastas nativas do Claude Code e do Codex, atualizando o índice. Use SEMPRE que pedirem para criar, adicionar, escrever, editar, ajustar, renomear ou remover uma skill, ou para transformar um procedimento repetido em skill.
 metadata:
   toolkit: seedgrid-ai
 ---
 
-# Criar uma skill
+# Criar ou alterar uma skill
 
-Toda skill nova do projeto nasce por aqui, para ficar completa e nos lugares certos. Não crie skill escrevendo arquivos soltos.
+Toda skill nova do projeto nasce por aqui, e toda alteração passa por aqui, para ficar completa e nos lugares certos. Não crie nem edite skill escrevendo arquivos soltos. Para **alterar** uma skill existente, vá direto à seção [Alterar uma skill existente](#alterar-uma-skill-existente); os passos abaixo são de **criação**.
 
-## Passos
+## Passos (criar)
 
 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".
@@ -27,9 +27,24 @@ Toda skill nova do projeto nasce por aqui, para ficar completa e nos lugares cer
 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.
 
+## Alterar uma skill existente
+
+Vale para editar o conteúdo, ajustar a descrição, renomear ou remover.
+
+1. **Localizar.** Confirme o nome em `.ai/skills/`. Se não existir, ofereça criar (passos acima). Leia a `.ai/skills/<nome>/` inteira (`SKILL.md` e `references/`).
+2. **Verificar o dono.** Se o nome começa com `sg-`, ela é do toolkit: o `seedgrid-ai update` a sobrescreve e a edição local se perde. Avise e ofereça duas saídas: (a) alterar no conteúdo do `seedgrid-ai` (fonte e manifesto) para valer para todos; (b) criar uma skill do projeto com outro nome, sem `sg-`, que estenda ou substitua o comportamento. Só edite a cópia local de uma `sg-*` se o usuário insistir, e deixe claro que é temporário.
+3. **Comparar as cópias.** Veja se `.claude/skills/<nome>/` e `.agents/skills/<nome>/` (as que existirem) estão iguais a `.ai/skills/<nome>/`. Se divergirem, mostre a diferença e pergunte qual vale antes de editar.
+4. **Combinar a mudança.** Resuma o que vai mudar (antes e depois) e confirme se for uma mudança grande. Respeite as regras do passo 3 de criação: frontmatter só com `name` e `description`, corpo curto, detalhes em `references/`.
+5. **Editar em `.ai/skills/<nome>/`** e só depois replicar o resultado, com o mesmo conteúdo, nas pastas nativas que o projeto usa.
+   - **Renomear:** mude a pasta e o `name` do frontmatter, nas três pastas e nos links relativos. Procure referências ao nome antigo em outras skills, em `.ai/rules/` e no `projeto.md`.
+   - **Remover:** só com pedido explícito. Apague a pasta nas três e a linha do `projeto.md`.
+6. **Atualizar o índice.** Se a descrição, o nome ou a existência mudou, ajuste a linha em `.ai/skills/projeto.md`. Não edite `.ai/skills/index.md`.
+7. **Conferir.** Releia o `SKILL.md` gravado, confirme que as cópias são idênticas, que nenhum link relativo está quebrado e que o `name` bate com a pasta.
+8. **Entregar.** Liste os arquivos alterados, resuma a mudança e avise que uma sessão nova da ferramenta é necessária para o menu refletir nome ou descrição novos.
+
 ## 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.
+- Nunca deixe as cópias divergirem: toda edição termina com as três pastas idênticas.

package/seedgridKB/SeedGrid/Visao-geral.md

@@ -16,10 +16,17 @@ Base de documentação técnica do ecossistema SeedGrid, gerada a partir do cód
 | Crates Rust | `rust/` | Portes 1:1 das extensions para servidores Axum (Java é a fonte da verdade), mais `broker` (mensageria) e `runtime`/`macros` (auto-wiring estilo CDI). |
 | Front-end | `front/seedgrid-fe-components` | Biblioteca React `@seedgrid/fe-components` (componentes `Sg*`), tema, core de módulos, playground e módulos de tela `@seedgrid/fe-*` que consomem as APIs das extensions. |
 
+## Produtos
+
+| Produto | O que é | Documentação |
+|---|---|---|
+| **SeedGrid Pulse** | Hub realtime (REST + WebSocket, replay, retry, DLQ, presença) com SDKs publisher/subscriber em várias linguagens. Pode ser usado por qualquer sistema SeedGrid. | [[SeedGrid/Produtos/Pulse/Visao-geral\|Pulse]] · [[SeedGrid/Produtos/Pulse/Servidor/Instalacao\|servidor]] · [[SeedGrid/Produtos/Pulse/UI/Visao-geral\|UI]] · [[SeedGrid/Produtos/Pulse/SDKs\|SDKs]] |
+
 ## Por onde começar
 
 - **Esqueci o nome de uma propriedade** → [[SeedGrid/Extensions/Catalogo-de-propriedades|Catálogo de propriedades]] (busque com `Ctrl+F` ou pela busca do Obsidian).
 - **Quais valores um enum aceita / o que cada valor faz** → [[SeedGrid/Extensions/Catalogo-de-enums|Catálogo de enums]].
+- **Quero usar o Pulse (realtime, notificações, WebSocket)** → [[SeedGrid/Produtos/Pulse/Visao-geral|Pulse]].
 - **Quero entender uma extension** → [[SeedGrid/Extensions/Indice|Índice das extensions]].
 - **Quero usar um componente React** → [[SeedGrid/SeedGrid-components/Indice|Índice dos componentes]].
 - **Quero saber o que depende do quê** → [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]].

package/seedgridKB/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "contentVersion": "0.3.2",
+  "contentVersion": "0.3.3",
   "toolkitBase": "SeedGrid/Toolkit",
   "components": [
     {
@@ -63,7 +63,7 @@
       "name": "sg-code-review",
       "files": [
         "SKILL.md",
-        "references/checklist.md"
+        "references/code-review-checklist.md"
       ]
     },
     {
@@ -92,9 +92,9 @@
       "name": "sg-crud-front",
       "files": [
         "SKILL.md",
-        "references/patterns.md",
-        "references/routing.md",
-        "references/checklist.md",
+        "references/crud-front-patterns.md",
+        "references/crud-front-routing.md",
+        "references/crud-front-checklist.md",
         "agents/openai.yaml"
       ]
     },
@@ -104,8 +104,8 @@
       "name": "sg-new-screen",
       "files": [
         "SKILL.md",
-        "references/steps.md",
-        "references/checklist.md",
+        "references/new-screen-steps.md",
+        "references/new-screen-checklist.md",
         "agents/openai.yaml"
       ]
     },