ajustes na tabela de consulta
This commit is contained in:
parent
aea3da6585
commit
1446d6225b
78 changed files with 17921 additions and 17580 deletions
|
|
@ -1,5 +1,9 @@
|
|||
---
|
||||
type: workflow
|
||||
name: aprimorar-IA
|
||||
description: Consolidar aprendizados da conversa atual e evoluir continuamente as regras, skills e fluxos da aplicação
|
||||
scope: global
|
||||
updatedAt: "2026-06-01"
|
||||
---
|
||||
|
||||
# Workflow: Aprimorar Conhecimento da Aplicação
|
||||
|
|
@ -74,7 +78,7 @@ Para cada item identificado, classificar obrigatoriamente:
|
|||
### Estrutura obrigatória:
|
||||
|
||||
- Um arquivo = um único assunto.
|
||||
- Nome claro em `snake_case`.
|
||||
- Nome claro em `kebab-case`.
|
||||
- Limite máximo: ~10.000 caracteres.
|
||||
|
||||
### É obrigatório:
|
||||
|
|
@ -196,105 +200,64 @@ Exemplos de skills de projeto:
|
|||
Sempre que decisões críticas sobre a arquitetura da aplicação ou o contexto do domínio precisarem ser arquivadas temporária ou permanentemente de maneira descritiva (e não diretamente injetável em código ou regra de lint):
|
||||
|
||||
* Registre o novo documento no formato adequado mantendo a pasta limpa em `.agent/memoria/`.
|
||||
* Exemplo: Manter diário de pendências (`diario_pendencias_modulo_x.md`) ou Arquivo de Registro de Decisão Arquitetural (`adr-001-migracao-nuxt-4.md`).
|
||||
* Atenção! Tudo que puder ser abstraído para um formato técnico estrito/guiado, deve virar **Skill** ou **Rule**. Use a Memória apenas como extensão de base factual.
|
||||
* Exemplo: Manter diário de pendências (`diario-pendencias-modulo-x.md`) ou ADR (`adr-001-migracao-nuxt-4.md`).
|
||||
* Atenção! Tudo que puder ser abstraído para formato técnico estrito deve virar **Skill** ou **Rule**. Use a Memória apenas como extensão de base factual.
|
||||
|
||||
---
|
||||
|
||||
## 6️⃣ Revisão Global de TODO o Sistema de Conhecimento (OBRIGATÓRIA E INEGOCIÁVEL)
|
||||
## 6️⃣ Revisão de Impacto (Dirigida por Grafo)
|
||||
|
||||
Esta é a etapa mais crítica.
|
||||
Quando um artefato é alterado, a revisão deve ser **dirigida**, não exaustiva.
|
||||
|
||||
Sempre que qualquer alteração ocorrer, é **OBRIGATÓRIO revisar TODO o sistema de conhecimento**, incluindo:
|
||||
### Processo:
|
||||
|
||||
* **TODOS os arquivos em `.agent/rules/`**
|
||||
* **TODOS os arquivos em `.agent/workflows/`**
|
||||
* **TODOS os arquivos em `.agent/skills/`**
|
||||
* **TODOS os arquivos em `.agent/memoria/`**
|
||||
1. Identificar o artefato alterado
|
||||
2. Consultar a seção `Referências` do artefato para encontrar dependentes diretos
|
||||
3. Verificar consistência APENAS entre o artefato alterado e seus dependentes
|
||||
4. Se uma inconsistência for encontrada, propagar para o próximo nível
|
||||
|
||||
### Regras de escopo:
|
||||
|
||||
| Se alterou... | Revisar... |
|
||||
|---|---|
|
||||
| Uma **Rule** | Workflows e skills que a **referenciam** |
|
||||
| Um **Workflow** | Skills que o **referenciam** |
|
||||
| Uma **Skill** | Rules e workflows na seção Referências |
|
||||
| **Memória/ADR** | Nada — memória é registro, não dependência |
|
||||
|
||||
### É PROIBIDO:
|
||||
|
||||
* Atualizar apenas um arquivo isolado.
|
||||
* Assumir que o impacto é local.
|
||||
* Ignorar arquivos existentes.
|
||||
* Criar artefatos sem validar o restante do sistema.
|
||||
* Revisar artefatos **sem relação** com a mudança
|
||||
* Afirmar que "tudo foi revisado" sem listar quais artefatos foram verificados
|
||||
* Criar artefatos sem verificar se já existe um com o mesmo escopo
|
||||
|
||||
### A revisão DEVE verificar:
|
||||
|
||||
* Não existem regras conflitantes entre o artefato alterado e seus dependentes
|
||||
* Referências cruzadas continuam válidas (arquivos existem, nomes corretos)
|
||||
* Skills refletem fielmente as rules que referenciam
|
||||
* Não há duplicação de conteúdo entre artefatos
|
||||
|
||||
---
|
||||
|
||||
### A revisão DEVE obrigatoriamente verificar:
|
||||
|
||||
#### Consistência
|
||||
|
||||
* Não existem regras conflitantes.
|
||||
* Não existem interpretações ambíguas.
|
||||
* Skills refletem fielmente as rules e workflows atuais.
|
||||
|
||||
#### Atualização
|
||||
|
||||
* Nenhuma rule está desatualizada.
|
||||
* Nenhum workflow usa regra antiga.
|
||||
* Nenhuma skill contém padrões obsoletos.
|
||||
|
||||
#### Não duplicação
|
||||
|
||||
* Não existem regras repetidas em arquivos diferentes.
|
||||
* Conteúdos redundantes foram consolidados.
|
||||
* Skills referenciam rules (não copiam o conteúdo).
|
||||
|
||||
#### Propagação de impacto
|
||||
|
||||
* Toda mudança foi refletida em:
|
||||
|
||||
* Rules relacionadas
|
||||
* Workflows relacionados
|
||||
* Skills relacionadas
|
||||
* Memória afetada pela mudança (ADRs, Diários)
|
||||
|
||||
#### Coerência estrutural
|
||||
|
||||
* Nomes de arquivos continuam válidos.
|
||||
* Assuntos estão bem separados.
|
||||
* Arquivos grandes foram divididos.
|
||||
* Skills estão organizadas em diretórios individuais.
|
||||
|
||||
---
|
||||
|
||||
### Regras obrigatórias desta etapa:
|
||||
|
||||
* **Toda alteração é considerada global até prova contrária.**
|
||||
* **Se uma rule muda, todos os workflows e skills relacionados DEVEM ser revisados.**
|
||||
* **Se um workflow muda, todas as rules e skills relacionadas DEVEM ser revisadas.**
|
||||
* **Se uma skill muda, as rules e workflows que ela referencia DEVEM ser verificados.**
|
||||
* **Atualizações de contexto devem garantir que toda a memória conflitante seja suprimida ou tagueada.**
|
||||
* **Nenhuma inconsistência pode permanecer.**
|
||||
* **Nenhuma duplicação é aceitável.**
|
||||
|
||||
---
|
||||
|
||||
## 7️⃣ Verificação Final (Checklist obrigatório)
|
||||
## 7⃣ Verificação Final (Checklist obrigatório)
|
||||
|
||||
Só é permitido encerrar se TODOS forem verdadeiros:
|
||||
|
||||
* [ ] Todas as rules foram revisadas
|
||||
* [ ] Todos os workflows foram revisados
|
||||
* [ ] Todas as skills foram revisadas
|
||||
* [ ] Não existe conflito entre artefatos
|
||||
* [ ] Artefatos dependentes do alterado foram revisados
|
||||
* [ ] Não existe conflito entre artefatos revisados
|
||||
* [ ] Não existe duplicação de conteúdo
|
||||
* [ ] Nenhuma regra ficou implícita
|
||||
* [ ] Todas as mudanças foram propagadas (rules ↔ workflows ↔ skills)
|
||||
* [ ] Referências cruzadas estão válidas
|
||||
* [ ] Estrutura está organizada por assunto
|
||||
* [ ] Nenhum arquivo excede ~10k caracteres
|
||||
* [ ] Workflows refletem fielmente as rules atuais
|
||||
* [ ] Skills referenciam (não duplicam) rules
|
||||
* [ ] O sistema está consistente como um todo
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Regra Suprema
|
||||
|
||||
> Se existir qualquer dúvida, conflito, duplicação ou inconsistência,
|
||||
> Se existir qualquer dúvida, conflito ou inconsistência
|
||||
> entre o artefato alterado e seus dependentes,
|
||||
> o trabalho é considerado **INCOMPLETO**.
|
||||
|
||||
Não existe atualização parcial.
|
||||
Não existe impacto local.
|
||||
Não existe exceção.
|
||||
A revisão é dirigida, não opcional.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue