98 lines
3.7 KiB
Markdown
98 lines
3.7 KiB
Markdown
---
|
|
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 | |