Compare commits
No commits in common. "7418bbaf30634b639553d7ed2146b656cab8a815" and "f91200ed529e0fd382daaa431305f6b9f16a28e5" have entirely different histories.
7418bbaf30
...
f91200ed52
6 changed files with 8 additions and 136 deletions
|
|
@ -42,7 +42,6 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
|
||||||
5. **Consistência Global First** — antes de criar algo local, verificar se já existe ou deveria existir em `global/`
|
5. **Consistência Global First** — antes de criar algo local, verificar se já existe ou deveria existir em `global/`
|
||||||
6. **Extensão sem extensão** — artefatos de conhecimento não possuem extensão de arquivo; scripts (`.sh`) e dados (`.json`) mantêm as suas
|
6. **Extensão sem extensão** — artefatos de conhecimento não possuem extensão de arquivo; scripts (`.sh`) e dados (`.json`) mantêm as suas
|
||||||
7. **Zod como validador padrão** — sempre que houver validação de variáveis, dados de entrada, parâmetros ou configurações, optar por Zod. Validação manual com `if/typeof` só é aceitável quando Zod não for viável (ver `global/rules/zod-validacao-padrao`)
|
7. **Zod como validador padrão** — sempre que houver validação de variáveis, dados de entrada, parâmetros ou configurações, optar por Zod. Validação manual com `if/typeof` só é aceitável quando Zod não for viável (ver `global/rules/zod-validacao-padrao`)
|
||||||
8. **Rigor Técnico e Usabilidade por Padrão** — Toda execução de prompt deve observar o que preconiza a literatura de tecnologia para a funcionalidade solicitada, alinhando engenharia de software e heurísticas de usabilidade (ver `global/rules/literatura-tecnica-e-usabilidade`)
|
|
||||||
|
|
||||||
## Escopo de Atuação
|
## Escopo de Atuação
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -88,17 +88,7 @@ Respostas devem ser estruturadas de forma que possam ser reutilizadas.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 6️⃣ Princípio de Embasamento na Literatura Técnica e Usabilidade
|
# 6️⃣ Princípio da Responsabilidade
|
||||||
|
|
||||||
Toda execução e implementação do agente deve observar rigorosamente o que preconiza a literatura de tecnologia para a funcionalidade solicitada, integrando:
|
|
||||||
|
|
||||||
- **Rigor e literatura técnica**: Adoção de padrões de projeto consagrados (GoF, Clean Architecture, DDD, RFCs, OWASP).
|
|
||||||
- **Boas práticas de desenvolvimento**: Princípios SOLID, Clean Code, tipagem estrita, modularidade e diagnóstico prévio.
|
|
||||||
- **Usabilidade e UX**: Heurísticas de Nielsen, acessibilidade (WCAG), visibilidade de estado, prevenção de erros e clareza cognitiva.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 7️⃣ Princípio da Responsabilidade
|
|
||||||
|
|
||||||
O agente deve evitar produzir conteúdos que possam causar:
|
O agente deve evitar produzir conteúdos que possam causar:
|
||||||
|
|
||||||
|
|
@ -111,7 +101,7 @@ A tecnologia deve ser utilizada como instrumento de construção e melhoria.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 8️⃣ Princípio da Evolução Contínua
|
# 7️⃣ Princípio da Evolução Contínua
|
||||||
|
|
||||||
O agente deve buscar aprimoramento constante por meio de:
|
O agente deve buscar aprimoramento constante por meio de:
|
||||||
|
|
||||||
|
|
@ -122,7 +112,7 @@ O agente deve buscar aprimoramento constante por meio de:
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 9️⃣ Regra Fundamental
|
# 8️⃣ Regra Fundamental
|
||||||
|
|
||||||
Sempre que houver dúvida entre diferentes caminhos de resposta, o agente deve priorizar:
|
Sempre que houver dúvida entre diferentes caminhos de resposta, o agente deve priorizar:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,53 +0,0 @@
|
||||||
---
|
|
||||||
type: rule
|
|
||||||
name: literatura-tecnica-e-usabilidade
|
|
||||||
description: Toda execução de prompt deve observar o que preconiza a literatura de tecnologia e as melhores práticas de desenvolvimento e usabilidade.
|
|
||||||
scope: global
|
|
||||||
trigger: always_on
|
|
||||||
priority: alta
|
|
||||||
updatedAt: "2026-08-11"
|
|
||||||
---
|
|
||||||
|
|
||||||
# Regra: Embasamento em Literatura Técnica, Boas Práticas e Usabilidade
|
|
||||||
|
|
||||||
## Contexto
|
|
||||||
|
|
||||||
Cada solicitação de funcionalidade, componente, API, fluxo ou refatoração deve ser planejada e executada com rigor técnico. O agente não deve criar soluções empíricas ou improvisadas sem consultar e aplicar os padrões consagrados da literatura de tecnologia, engenharia de software e usabilidade.
|
|
||||||
|
|
||||||
## Diretrizes Obrigatórias para Toda Execução de Prompt
|
|
||||||
|
|
||||||
Em **toda execução de prompt**, o agente DEVE observar rigorosamente os três pilares fundamentais:
|
|
||||||
|
|
||||||
### 1️⃣ Observância da Literatura de Tecnologia (Rigor Técnico)
|
|
||||||
- **Consenso da Indústria**: Identificar e aplicar padrões e especificações formais de referência para o domínio da funcionalidade (ex.: GoF Design Patterns, Clean Architecture, Domain-Driven Design, RESTful APIs RFCs, 12-Factor App, OWASP Guidelines).
|
|
||||||
- **Justificativa Baseada em Literatura**: Projetar arquiteturas, estruturas e funções fundamentadas nas melhores referências teóricas e científicas consolidadas.
|
|
||||||
- **Evitar Anti-patterns**: Evitar explicitamente os anti-padrões catalogados na literatura (ex.: God Object, Spaghetti Code, Anemic Domain Model, Circular Dependencies, Feature Envy).
|
|
||||||
|
|
||||||
### 2️⃣ Boas Práticas de Desenvolvimento (Engenharia de Software)
|
|
||||||
- **Princípios SOLID**: Aplicar S (Single Responsibility), O (Open/Closed), L (Liskov Substitution), I (Interface Segregation) e D (Dependency Inversion).
|
|
||||||
- **Clean Code & Manutenibilidade**: Escrever código autoexplicativo, modular, de responsabilidade única e desacoplado.
|
|
||||||
- **Tipagem Forte e Defensiva**: Utilizar TypeScript e validação de schemas Zod para garantir integridade em runtime e compilação.
|
|
||||||
- **Tratamento de Erros e Diagnóstico**: Seguir a regra de diagnosticar a causa raiz antes de corrigir, tratando exceções de forma graciosa sem engolir erros.
|
|
||||||
|
|
||||||
### 3️⃣ Boas Práticas de Usabilidade e UX/UI (Experiência do Usuário)
|
|
||||||
- **Heurísticas de Usabilidade (Nielsen)**:
|
|
||||||
1. Visibilidade do estado do sistema (loading, feedback imediato).
|
|
||||||
2. Correspondência entre o sistema e o mundo real (linguagem do domínio).
|
|
||||||
3. Controle e liberdade do usuário (cancelamento, desfazer, confirmações).
|
|
||||||
4. Consistência e padrões (componentes coesos do design system).
|
|
||||||
5. Prevenção de erros (validação preventiva via Zod/form).
|
|
||||||
6. Reconhecimento em vez de memorização (rótulos claros, contexto visível).
|
|
||||||
7. Flexibilidade e eficiência de uso (fluxos fluidos, ações diretas).
|
|
||||||
8. Estética e design minimalista (interface limpa, sem ruído).
|
|
||||||
9. Diagnóstico e recuperação de erros (mensagens claras e orientadoras).
|
|
||||||
- **Acessibilidade & Clareza Cognitiva**: Respeitar padrões de acessibilidade (WCAG) e garantir interface responsiva com feedbacks compreensíveis.
|
|
||||||
|
|
||||||
## Processo de Execução em 3 Etapas
|
|
||||||
|
|
||||||
1. **Análise Téorico-Funcional**: Mapear qual padrão ou especificação da literatura se aplica à funcionalidade solicitada.
|
|
||||||
2. **Construção Segura**: Codificar aplicando SOLID, tipagem estrita e diagnóstico prévio.
|
|
||||||
3. **Validação de Usabilidade**: Verificar se a interface e contratos atendem às heurísticas de UX e feedback visual.
|
|
||||||
|
|
||||||
## Impacto
|
|
||||||
|
|
||||||
Garante soluções robustas, sustentáveis no longo prazo, escaláveis e alinhadas aos mais altos padrões globais de tecnologia e experiência do usuário.
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"versao": "3.0.0",
|
"versao": "3.0.0",
|
||||||
"atualizadoEm": "2026-08-11",
|
"atualizadoEm": "2026-08-10",
|
||||||
"projeto": "e-licencie",
|
"projeto": "e-licencie",
|
||||||
"artefatos": {
|
"artefatos": {
|
||||||
"global": {
|
"global": {
|
||||||
|
|
@ -17,7 +17,6 @@
|
||||||
"global/rules/funcoes-anonimas-arrow.md",
|
"global/rules/funcoes-anonimas-arrow.md",
|
||||||
"global/rules/jsdoc-padrao.md",
|
"global/rules/jsdoc-padrao.md",
|
||||||
"global/rules/limite-linhas.md",
|
"global/rules/limite-linhas.md",
|
||||||
"global/rules/literatura-tecnica-e-usabilidade.md",
|
|
||||||
"global/rules/mensagens-usuario.md",
|
"global/rules/mensagens-usuario.md",
|
||||||
"global/rules/modal-dialog-padrao-betha.md",
|
"global/rules/modal-dialog-padrao-betha.md",
|
||||||
"global/rules/proibido-commit-ia.md",
|
"global/rules/proibido-commit-ia.md",
|
||||||
|
|
|
||||||
|
|
@ -6,7 +6,7 @@ description: Princípios morais e operacionais que orientam o comportamento de a
|
||||||
version: "1.0"
|
version: "1.0"
|
||||||
scope: global
|
scope: global
|
||||||
priority: alta
|
priority: alta
|
||||||
updatedAt: "2026-08-11"
|
updatedAt: "2026-06-01"
|
||||||
---
|
---
|
||||||
|
|
||||||
# Carta de Princípios do Agente de IA da Azteca
|
# Carta de Princípios do Agente de IA da Azteca
|
||||||
|
|
@ -88,17 +88,7 @@ Respostas devem ser estruturadas de forma que possam ser reutilizadas.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 6️⃣ Princípio de Embasamento na Literatura Técnica e Usabilidade
|
# 6️⃣ Princípio da Responsabilidade
|
||||||
|
|
||||||
Toda execução e implementação do agente deve observar rigorosamente o que preconiza a literatura de tecnologia para a funcionalidade solicitada, integrando:
|
|
||||||
|
|
||||||
- **Rigor e literatura técnica**: Adoção de padrões de projeto consagrados (GoF, Clean Architecture, DDD, RFCs, OWASP).
|
|
||||||
- **Boas práticas de desenvolvimento**: Princípios SOLID, Clean Code, tipagem estrita, modularidade e diagnóstico prévio.
|
|
||||||
- **Usabilidade e UX**: Heurísticas de Nielsen, acessibilidade (WCAG), visibilidade de estado, prevenção de erros e clareza cognitiva.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# 7️⃣ Princípio da Responsabilidade
|
|
||||||
|
|
||||||
O agente deve evitar produzir conteúdos que possam causar:
|
O agente deve evitar produzir conteúdos que possam causar:
|
||||||
|
|
||||||
|
|
@ -111,7 +101,7 @@ A tecnologia deve ser utilizada como instrumento de construção e melhoria.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 8️⃣ Princípio da Evolução Contínua
|
# 7️⃣ Princípio da Evolução Contínua
|
||||||
|
|
||||||
O agente deve buscar aprimoramento constante por meio de:
|
O agente deve buscar aprimoramento constante por meio de:
|
||||||
|
|
||||||
|
|
@ -122,7 +112,7 @@ O agente deve buscar aprimoramento constante por meio de:
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# 9️⃣ Regra Fundamental
|
# 8️⃣ Regra Fundamental
|
||||||
|
|
||||||
Sempre que houver dúvida entre diferentes caminhos de resposta, o agente deve priorizar:
|
Sempre que houver dúvida entre diferentes caminhos de resposta, o agente deve priorizar:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,53 +0,0 @@
|
||||||
---
|
|
||||||
type: rule
|
|
||||||
name: literatura-tecnica-e-usabilidade
|
|
||||||
description: Toda execução de prompt deve observar o que preconiza a literatura de tecnologia e as melhores práticas de desenvolvimento e usabilidade.
|
|
||||||
scope: global
|
|
||||||
trigger: always_on
|
|
||||||
priority: alta
|
|
||||||
updatedAt: "2026-08-11"
|
|
||||||
---
|
|
||||||
|
|
||||||
# Regra: Embasamento em Literatura Técnica, Boas Práticas e Usabilidade
|
|
||||||
|
|
||||||
## Contexto
|
|
||||||
|
|
||||||
Cada solicitação de funcionalidade, componente, API, fluxo ou refatoração deve ser planejada e executada com rigor técnico. O agente não deve criar soluções empíricas ou improvisadas sem consultar e aplicar os padrões consagrados da literatura de tecnologia, engenharia de software e usabilidade.
|
|
||||||
|
|
||||||
## Diretrizes Obrigatórias para Toda Execução de Prompt
|
|
||||||
|
|
||||||
Em **toda execução de prompt**, o agente DEVE observar rigorosamente os três pilares fundamentais:
|
|
||||||
|
|
||||||
### 1️⃣ Observância da Literatura de Tecnologia (Rigor Técnico)
|
|
||||||
- **Consenso da Indústria**: Identificar e aplicar padrões e especificações formais de referência para o domínio da funcionalidade (ex.: GoF Design Patterns, Clean Architecture, Domain-Driven Design, RESTful APIs RFCs, 12-Factor App, OWASP Guidelines).
|
|
||||||
- **Justificativa Baseada em Literatura**: Projetar arquiteturas, estruturas e funções fundamentadas nas melhores referências teóricas e científicas consolidadas.
|
|
||||||
- **Evitar Anti-patterns**: Evitar explicitamente os anti-padrões catalogados na literatura (ex.: God Object, Spaghetti Code, Anemic Domain Model, Circular Dependencies, Feature Envy).
|
|
||||||
|
|
||||||
### 2️⃣ Boas Práticas de Desenvolvimento (Engenharia de Software)
|
|
||||||
- **Princípios SOLID**: Aplicar S (Single Responsibility), O (Open/Closed), L (Liskov Substitution), I (Interface Segregation) e D (Dependency Inversion).
|
|
||||||
- **Clean Code & Manutenibilidade**: Escrever código autoexplicativo, modular, de responsabilidade única e desacoplado.
|
|
||||||
- **Tipagem Forte e Defensiva**: Utilizar TypeScript e validação de schemas Zod para garantir integridade em runtime e compilação.
|
|
||||||
- **Tratamento de Erros e Diagnóstico**: Seguir a regra de diagnosticar a causa raiz antes de corrigir, tratando exceções de forma graciosa sem engolir erros.
|
|
||||||
|
|
||||||
### 3️⃣ Boas Práticas de Usabilidade e UX/UI (Experiência do Usuário)
|
|
||||||
- **Heurísticas de Usabilidade (Nielsen)**:
|
|
||||||
1. Visibilidade do estado do sistema (loading, feedback imediato).
|
|
||||||
2. Correspondência entre o sistema e o mundo real (linguagem do domínio).
|
|
||||||
3. Controle e liberdade do usuário (cancelamento, desfazer, confirmações).
|
|
||||||
4. Consistência e padrões (componentes coesos do design system).
|
|
||||||
5. Prevenção de erros (validação preventiva via Zod/form).
|
|
||||||
6. Reconhecimento em vez de memorização (rótulos claros, contexto visível).
|
|
||||||
7. Flexibilidade e eficiência de uso (fluxos fluidos, ações diretas).
|
|
||||||
8. Estética e design minimalista (interface limpa, sem ruído).
|
|
||||||
9. Diagnóstico e recuperação de erros (mensagens claras e orientadoras).
|
|
||||||
- **Acessibilidade & Clareza Cognitiva**: Respeitar padrões de acessibilidade (WCAG) e garantir interface responsiva com feedbacks compreensíveis.
|
|
||||||
|
|
||||||
## Processo de Execução em 3 Etapas
|
|
||||||
|
|
||||||
1. **Análise Téorico-Funcional**: Mapear qual padrão ou especificação da literatura se aplica à funcionalidade solicitada.
|
|
||||||
2. **Construção Segura**: Codificar aplicando SOLID, tipagem estrita e diagnóstico prévio.
|
|
||||||
3. **Validação de Usabilidade**: Verificar se a interface e contratos atendem às heurísticas de UX e feedback visual.
|
|
||||||
|
|
||||||
## Impacto
|
|
||||||
|
|
||||||
Garante soluções robustas, sustentáveis no longo prazo, escaláveis e alinhadas aos mais altos padrões globais de tecnologia e experiência do usuário.
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue