chore: ignora graphify-out gerado

2026-10-28 15:59:30 +00:00
parent 0ff519f554
commit 75041136d2
26 changed files with 3023 additions and 1 deletions
@@ -0,0 +1,98 @@
+---
+type: Document
+title: Agents
+description: Este documento define o papel, limites e responsabilidades dos agentes
+  de IA (Gemini CLI, Claude Code, Hermes) a operar …
+timestamp: 2026-05-13 11:28:03.523803+00:00
+tags:
+- dev
+- codigo
+- governance
+- 5w2h
+- roles
+- escalacao
+- relacionamentos
+---
+# AGENTS.md — Governance de Agentes IA
+
+## Definição
+Este documento define o papel, limites e responsabilidades dos agentes de IA (Gemini CLI, Claude Code, Hermes) a operar neste repositório.
+
+## Identidade do Projecto
+- **Repositório**: bi-descomplicar
+- **Localização**: `/media/ealmeida/Dados/Dev/bi-descomplicar/`
+- **CRM**: Ver `desk.project` para referência do projecto
+- **Domínio CARL**: `BI-DESCOMPLICAR` (ou conforme CRM)
+
+## Directrizes de Operação
+
+### 1. PT-PT e Precisão
+Toda a interacção, comentários, commits e documentação devem ser em português europeu, com acentos e cedilhas.
+
+### 2. MCP-first
+- **CRM (Desk Project Minimal)**: Consultar/actualizar task #2134 via MCP
+- **Gitea (MCP Gitea)**: Commits e gestão de versões via MCP
+- **CARL (MCP CARL)**: Consultar domínio `MODELO-ORGANIZACAO` para regras do modelo
+- **SSH (MCP SSH Unificado)**: Apenas se necessário para validação remota
+
+### 3. Ciclo de Trabalho Obrigatório
+1. **Validar contexto** — ler AGENTS.md + MEMORY.md + desk.project
+2. **Consultar CARL** — verificar regras do domínio `MODELO-ORGANIZACAO`
+3. **Executar** — seguir o standard ESTRUTURA.md
+4. **Validar** — correr `scripts/validate-structure.sh` se disponível
+5. **Registar** — actualizar MEMORY.md e CRM
+
+### 4. Validação Obrigatória
+Nunca dar uma tarefa como concluída sem validar o estado via shell ou MCP.
+Este projecto é o modelo canónico — qualquer alteração aqui propaga-se a todos os outros.
+
+### 5. CARL
+Respeitar o domínio `MODELO-ORGANIZACAO` no CARL. As regras lá definidas têm precedência sobre documentação local em caso de conflito.
+
+## O Que Este Projecto Contém
+
+| Ficheiro | Função |
+|---|---|
+| `ESTRUTURA.md` | Standard de hierarquia obrigatório para projectos |
+| `GOVERNANCA.md` | Manifesto de qualidade e conduta DEV |
+| `PROTOCOLO-CRM.md` | Integração Lean Gitea & Desk CRM |
+| `INSTRUCOES.md` | Visão geral e próximos passos |
+| `MEMORY.md` | Registo cronológico de sessões |
+| `AGENTS.md` | (Este ficheiro) Governance de agentes |
+| `desk.project` | Ancoragem CRM (task #2134) |
+| `scripts/validate-structure.sh` | Validação automática de conformidade |
+
+## Regra Anti-Pattern
+- **Não** criar pastas `docs/PROC` ou `docs/RUNBOOK` — vivem no Hub centralizado
+- **Não** duplicar procedimentos que existem em `06-Operacoes/Procedimentos/`
+- **Não** saltar a validação MEMORY.md no final da sessão
+
+## Relacionamentos Direccionais
+
+### Depende De
+- [[../../Hub/06-Operacoes]] - Hub operacional central com procedimentos
+- [[../../Hub/04-Stack]] - Decisões técnicas e stack Descomplicar
+
+### Suporta
+- [[../../Hub/05-Projectos/Modelo-Organizacao-Proc-Dev/ESTRUTURA.md]] - Modelo de projectos
+
+### Documenta
+- [[../../Hub/06-Operacoes/Procedimentos/]] - Procedimentos operacionais
+
+### Implementação
+- [[.]] - Código-fonte e implementação do projecto
+### Relacionado Com
+- [[../../Hub/04-Stack]] - Stack técnico partilhado
+
+### Procedimento
+- [[../../Hub/06-Operacoes/Procedimentos/D7-Tecnologia/Sistema/PROC-Desk-Subtarefas-Dependencias.md]] - Modelo de subtarefas
+
+### Herança
+- [[../../Hub/05-Projectos/Modelo-Organizacao-Proc-Dev/ESTRUTURA.md]] - Estrutura canónica
+
+## Histórico de Intervenções
+
+| Data | Agente | Acção |
+|---|---|---|
+| 2026-05-13 | Gemini CLI | Criação da estrutura base de governance |
+| 2026-05-13 | Izito (Hermes) | Correção estrutural, criação CARL, script de validação |