bi-descomplicar/AGENTS.md

type, title, description, timestamp, tags

type	title	description	timestamp	tags
Document	Agents	Este documento define o papel, limites e responsabilidades dos agentes de IA (Gemini CLI, Claude Code, Hermes) a operar …	2026-05-13 11:28:03.523803+00:00	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