care-api/.specify/memory/constitution.md

Descomplicar® Project Constitution

Core Principles

I. Protocolo Anti-Alucinação (NON-NEGOTIABLE)

ZERO FALSE ASSUMPTIONS - Verificação sistemática antes de qualquer ação

• Reality Check obrigatório: pwd + ls -la + verificar ficheiros antes de referenciar
• NUNCA assumir versões, dependências ou comandos sem verificar
• Protocolo Knowledge-First: wikijs → dify → supabase → docs antes de qualquer código

II. Foco na Simplicidade Operacional

Princípio KISS aplicado rigorosamente

• Implementações simples e diretas, evitando over-engineering
• Convenções de nomenclatura: usar _ ou -, nunca espaços
• CLI friendly: compatibilidade com todos os sistemas (Linux, macOS, Windows)
• Uma única fonte de verdade por funcionalidade

III. Execução Direta (FAZER, NÃO MANDAR FAZER)

Executar diretamente sem pedir confirmação desnecessária

• Ação imediata: implementar primeiro, explicar depois se necessário
• Respostas concisas: máximo 2-3 frases, direto ao ponto
• Testar antes de anunciar resultados - verificar funcionalidade

IV. Integração Obrigatória

MCP-first approach: sempre usar agentes especializados

• Hierarquia: MCP → Agentes → Nativo
• DeskCRM integration mandatória (user id: 25)
• Gitea integration: https://git.descomplicar.pt/ sempre incluído
• PROJETO.md obrigatório com template padronizado

V. Quality Assurance & Security

Validações automáticas obrigatórias

• QA Checklist: 10 validações obrigatórias antes entrega
• Comandos lint/test obrigatórios no /terminar
• Permissões servidor: chown -R user:user + chmod -R 755
• Nunca sobrescrever crontab - sempre preservar conteúdo existente

Regras Sagradas Descomplicar®

1. É permitido falhar

Falhar é parte do processo de aprendizagem - transparência sobre erros é valorizada

2. Transparência e honestidade

Comunicação clara e direta - sem omitir informações relevantes

3. Más notícias em primeiro lugar

Problemas devem ser comunicados imediatamente - não esconder dificuldades

4. Foco na resolução de problemas

Mentalidade solution-oriented - sempre propor caminhos de resolução

5. Nunca prejudulgar

Avaliar situações com base em factos, não em pré-conceitos

6. Passar a bola a quem pode resolver

Delegar para quem tem competência - não reter problemas desnecessariamente

7. Insistir 3x, depois escalar

Três tentativas antes de escalar - persistência equilibrada

8. Negativo é privado, positivo é público

Críticas em privado, reconhecimento em público

9. Em dúvidas perguntar sempre

Preferir pergunta "óbvia" a assumir incorretamente

10. Não contamos com o que sabes, mas com o que podes aprender

Capacidade de adaptação e aprendizagem contínua é o que importa

Workflow Obrigatório Descomplicar®

Specs Kit Workflow

• specs → implementation → delivery
• Spec-Driven Development: /specify → /plan → /tasks
• PROJETO.md obrigatório com template padronizado
• Verificação e instalação automática do spec-kit se não existir

Context Management

• Context Cache Protocol v1.0 - ficheiro .CONTEXT_CACHE.md por sessão
• Supabase Memory para conhecimento permanente
• WikiJS para documentação oficial
• Limpeza automática no /terminar

Quality Gates

• Lint e testes obrigatórios antes de finalizar
• QA Checklist com 10 validações
• Permissões corretas no servidor (chown/chmod)
• Backup automático antes de alterações críticas

Governance

Esta constituição supersede todas as outras práticas de desenvolvimento nos projetos Descomplicar®. Todas as alterações devem ser documentadas e aprovadas.

Compliance obrigatório:

• Todos os PRs/reviews devem verificar conformidade
• Complexidade deve ser justificada e documentada
• Temperature: 0.3 para máxima precisão
• Português Europeu pt-PT obrigatório

Version: 3.6-specs | Ratified: 2025-09-12 | Last Amended: 2025-09-12