Modelo-Organizacao-Proc-Dev — Fluxo de Trabalho

Workflow de projectos Descomplicar®: iniciação, sessão, registo e governança

F1: Iniciação de Projecto Novo Projecto Repositório desk.project + AGENTS.md docs/PLANS/ + docs/SPECS/ validate-structure scripts/ .sh CONFORME Exit 0 FALHA (exit 1) DONE F2: Sessão de Trabalho (Agente/Humano) 1. PLAN Contexto: AGENTS.md + MEMORY.md + CARL 2. DO Executar (MCP/SSH) Procurar dados reais 3. CHECK Validação estrutural Testes / QG validate-structure.sh FALHA — corrigir 4. ACT REGISTAR: MEMORY.md + Comentário CRM OK F3: Separação de Responsabilidades (PROTOCOLO-CRM.md) DESK CRM Contentor de Tempo e Custos • Task Master (poucas, por projecto) • Timer — registo de horas • Comentários — visibilidade gestor/cliente | | | GITEA / REPO Oficina Técnica • Código, branches, PRs • Issues — detalhe técnico • Milestones + CI/CD | | | HUB OBSIDIAN (06-Operacoes) Fonte de Verdade Centralizada • Procedimentos (PROC-*) • Quick References (QR-*) • Runbooks — troubleshooting F4: Ecossistema de Governança CARL — Regras Activas MODELO-ORGANIZACAO ESTRUTURA.md Hierarquia Standard AGENTS.md Directrizes de Agentes validate-structure.sh Validação automática Exit 0 = OK MEMORY.md Registo Final AGENTS.md referência o domínio CARL correspondente Legenda: Governance Execução Registo Validação / Segurança Correcção (feedback loop) Fluxo/Fase

F1: Iniciação

  • • Criar repositório e desk.project
  • • Scaffold docs/PLANS + docs/SPECS
  • • AGENTS.md com directrizes do projecto
  • • Validar com scripts/validate-structure.sh
  • • Só é "conforme" com exit 0

F2: Sessão PDCA

  • • PLAN: Carregar AGENTS.md + MEMORY.md + CARL
  • • DO: Executar MCP/SSH — nunca assumir
  • • CHECK: validate-structure.sh + testes
  • • ACT: REGISTAR em MEMORY.md + CRM
  • • Se FALHA: loop back ao DO

F3+F4: Governança

  • • CRM = tempo e custos (não granular)
  • • Gitea = código, issues, milestones
  • • Hub (06-Operacoes) = PROCs + Runbooks
  • • CARL regista decisões com recall keywords
  • • AGENTS.md aponta para CARL + MEMORY.md