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