diff --git a/agents/agente/persona b/agents/agente/persona index c290b19..05c3a17 100644 --- a/agents/agente/persona +++ b/agents/agente/persona @@ -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/` 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`) -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 diff --git a/global/rules/carta-principios-agente-azteca.md b/global/rules/carta-principios-agente-azteca.md index 55cf6c8..4a9b20e 100644 --- a/global/rules/carta-principios-agente-azteca.md +++ b/global/rules/carta-principios-agente-azteca.md @@ -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 - -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 +# 6️⃣ Princípio da Responsabilidade 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: @@ -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: diff --git a/global/rules/literatura-tecnica-e-usabilidade.md b/global/rules/literatura-tecnica-e-usabilidade.md deleted file mode 100644 index ea4d7fe..0000000 --- a/global/rules/literatura-tecnica-e-usabilidade.md +++ /dev/null @@ -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. diff --git a/manifesto.json b/manifesto.json index 5f047f6..1e4b3de 100644 --- a/manifesto.json +++ b/manifesto.json @@ -1,6 +1,6 @@ { "versao": "3.0.0", - "atualizadoEm": "2026-08-11", + "atualizadoEm": "2026-08-10", "projeto": "e-licencie", "artefatos": { "global": { @@ -17,7 +17,6 @@ "global/rules/funcoes-anonimas-arrow.md", "global/rules/jsdoc-padrao.md", "global/rules/limite-linhas.md", - "global/rules/literatura-tecnica-e-usabilidade.md", "global/rules/mensagens-usuario.md", "global/rules/modal-dialog-padrao-betha.md", "global/rules/proibido-commit-ia.md", diff --git a/rules/carta-principios-agente-azteca.md b/rules/carta-principios-agente-azteca.md index 1f7c765..4a9b20e 100644 --- a/rules/carta-principios-agente-azteca.md +++ b/rules/carta-principios-agente-azteca.md @@ -6,7 +6,7 @@ description: Princípios morais e operacionais que orientam o comportamento de a version: "1.0" scope: global priority: alta -updatedAt: "2026-08-11" +updatedAt: "2026-06-01" --- # 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 - -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 +# 6️⃣ Princípio da Responsabilidade 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: @@ -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: diff --git a/rules/literatura-tecnica-e-usabilidade.md b/rules/literatura-tecnica-e-usabilidade.md deleted file mode 100644 index ea4d7fe..0000000 --- a/rules/literatura-tecnica-e-usabilidade.md +++ /dev/null @@ -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.