# Descomplicar® Project Constitution
<!-- Constituição padrão para todos os projetos Descomplicar® -->

## 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