publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

.

Browse source
This commit is contained in:
Luiz Silva 2026-06-18 16:50:03 -03:00
parent 1adf19b92d
commit 1388a121bc
65 changed files with 157 additions and 5166 deletions
Download patch file Download diff file Expand all files Collapse all files

26
global/workflows/aprimorar-IA.md
View file

@ -20,12 +20,12 @@ Este workflow é **obrigatório** e deve ser executado sempre que houver qualque
O conhecimento do agente está organizado em **três tipos de artefatos**, cada um com responsabilidade distinta:
| Artefato | Diretório | Responsabilidade |
|----------|-----------|------------------|
| **Rules** | `.agent/rules/` | Restrições e convenções que o agente **deve respeitar sempre** |
| **Workflows** | `.agent/workflows/` | Processos sequenciais com passos numerados para tarefas bem definidas |
| **Skills** | `.agent/skills/` | Guias operacionais completos e reutilizáveis para tarefas complexas recorrentes |
| **Memória** | `.agent/memoria/` | Registros históricos, contexto do projeto, fatos e decisões importantes |
| Artefato | Diretório (herdado) | Diretório (local) | Responsabilidade |
|----------|---------------------|-------------------|------------------|
| **Rules** | `.agent/base/global/rules/` | `.agent/local/rules/` | Restrições e convenções que o agente **deve respeitar sempre** |
| **Workflows** | `.agent/base/global/workflows/` | `.agent/local/workflows/` | Processos sequenciais com passos numerados para tarefas bem definidas |
| **Skills** | `.agent/base/global/skills/` | `.agent/local/skills/` | Guias operacionais completos e reutilizáveis para tarefas complexas recorrentes |
| **Memória** | — | `.agent/memoria/` | Registros históricos, contexto do projeto, fatos e decisões importantes |
### Diferenças entre os artefatos
@ -113,7 +113,7 @@ Problema que evita.
Sempre que houver processo repetível identificado:
* Criar ou atualizar workflow em `.agent/workflows/`.
* Criar ou atualizar workflow em `.agent/local/workflows/`.
### Obrigatório:
@ -129,7 +129,7 @@ Sempre que houver processo repetível identificado:
Sempre que um padrão operacional complexo for definido, refinado ou corrigido:
* Criar ou atualizar skill em `.agent/skills/<nome-da-skill>/SKILL.md`.
* Criar ou atualizar skill em `.agent/local/skills/<nome-da-skill>/SKILL.md`.
### Quando atualizar uma skill:
@ -158,20 +158,20 @@ Instruções com código, regras e padrões.
- [ ] Item de verificação
## Referências
- Regras: `.agent/rules/xxx.md`
- Workflow: `.agent/workflows/xxx.md`
- Regras: `.agent/local/rules/xxx.md`
- Workflow: `.agent/local/workflows/xxx.md`
```
### Regras de organização:
- Uma skill por diretório: `.agent/skills/<nome>/SKILL.md`
- Uma skill por diretório: `.agent/local/skills/<nome>/SKILL.md`
- Skills globais são identificadas pelo campo `scope: global` no frontmatter
- Nome do diretório em `kebab-case`
- A skill **não deve duplicar** conteúdo de rules — referencia-as via seção `Referências`
- A skill **pode consolidar** conhecimento de múltiplas rules e workflows em um guia unificado
- Templates de código devem estar na própria skill (não em arquivos separados, a menos que sejam muito grandes)
### Skills globais (distribuídas via `atualizar-agente.global.sh`):
### Skills globais (herdadas de `.agent/base/`):
| Skill | Escopo |
|-------|--------|
@ -181,7 +181,7 @@ Instruções com código, regras e padrões.
### Skills de projeto (criadas localmente em cada monorepo):
Cada projeto pode criar skills adicionais específicas em `.agent/skills/<nome>/SKILL.md`.
Cada projeto pode criar skills adicionais específicas em `.agent/local/skills/<nome>/SKILL.md`.
Essas skills focam nos padrões e domínios exclusivos daquele projeto.
Exemplos de skills de projeto: