Guia do Operador — Mentari Dev Chat

    O que e este guia: Manual de operacoes do workspace Mentari Dev Chat. Cobre COMO operar — repositorio, stack, protocolos, guardrails, pipelines. Para O QUE esta a acontecer (estado dos projectos), ver o Mapa Multi-Dominio (GUIA_MAPA_MULTIDOMINIO_DEVCHAT.html).
  

Repositorio

11 pastas numeradas + code folders + _inbox + _archive. 300+ ficheiros. Estrutura por tier (canonicos → projectos → logs → governance).

Stack Tecnico

MCP bridge (35 tools), 15 skills, memoria persistente, git, sub-agentes, WebSearch. Opus 4.6 1M como mothership.

Protocolos

Abertura de sessao (5+1 etapas), MAILBOX bridge, checkpoints, 5W2H reporting, pre-flight gate, reconciliacao.

Guardrails

Autonomia (o que e auto vs confirmar), confidencialidade, anti-patterns, compliance OAB, regras duraveis.

Code vs Cowork

Quando usar cada um, comparativo de capacidades, decisao rapida por tipo de trabalho, barras visuais.

Pipelines

Dia-a-dia (abrir → trabalhar → checkpoint → fechar). Extraordinarios (audit, onboarding workspace, reconciliacao, pre-flight).

Numeros do workspace

300+ ficheiros .md

Organizados em 11 pastas numeradas (00-10) + code folders

15 skills

council, autoreason, superpowers-planning, wiki-update, simplify, slides, cross-audit, reconcile, pre-flight, deep-dd, long-form, citation-audit, war-room, visual-law, claude-api

35 tools RFI Gateway

OSINT (11), Analise (4), Research (4), Judicial (11), MEI (2), Jurisprudencia (2), Sherlocker (10)

35 MCP tools

35 tools: OSINT (11), Analise (4), Research (4), Judicial (11), MEI (2), Jurisprudencia (2), Sherlocker (10 — OSINT avancado)

Arquitectura de camadas

O workspace esta organizado em 4 camadas concentricas, da mais estavel a mais volatil.

Camada Nuclear — Canonicos (00_canonicos/)

SSoTs, definicoes de produto, decisoes, protocolos. Mudam raramente. Quando mudam, propagar. 15+ docs. Ler SEMPRE na abertura de sessao.

Camada de Projecto — RFI, Mentari, It'Singular (01-04/)

Documentos de trabalho activo por projecto. Comercial, pesquisa, frameworks, personas, specs. Mudam com frequencia. ~180 docs.

Camada Operacional — Logs, Briefings, Governance (05-08/)

Morning briefs, handoffs, gateway invocations, vault health, backlog. Registos que crescem. Governance que mantem coerencia.

Camada de Codigo — Mentari/, golden_ai/, pipes/ (raiz)

Codebase Python, pipes Open WebUI, bots, demos HTML. Intactas na reestruturacao. Mentari UTV em hibernacao (190 testes). Novos: Agent SDK prototypes + Visual Law engine em Mentari/tools/.

Mapa de pastas

Mentari Dev Chat/ ├── 00_canonicos/ — SSoTs: PRODUCT_DEFINITION, DECISIONS_OPEN, MENTARI_MASTER, protocolos ├── 01_rfi/ — RF Intelligence: comercial, canonicos, pesquisa, frameworks (~59 docs) │ ├── canonicos/ — PARECER_ESTRATEGICO, handoffs (alguns superseded) │ ├── comercial/ — pitches, propostas, FAQ, NDA, contratos, onboarding │ ├── pesquisa_mercado/ — concorrentes, benchmarks, APIs, OSINT │ └── frameworks/ — oceano azul, ecosystem, financeiro, governance ├── 02_mentari/ — Mentari produto: aria, canonicos, produto, strategy, consult (~58 docs) │ ├── aria/ — FILOSOFIA_BASE, system prompts, pesquisas, indices │ ├── canonicos/ — ROADMAP_v2, BRAND_IDENTITY, TECH_SPEC │ └── produto/ — beta plan, pitch, competidores, monetizacao ├── 03_itssingular_sergio/ — It'Singular + Sergio: itssingular/, sergio/, promenade/ (~21 docs) ├── 04_pessoal/ — RCF infra, opsec, calibragens, pesquisa geral (~38 docs) ├── 05_logs/ — morning briefs, handoffs, overnight, dev logs, sync, gateway invocations ├── 06_briefings_pipelines/ — Cowork briefs, war room, agenda ├── 07_demos_html/ — demos interactivos, guias visuais, este guia ├── 08_governance/ — vault health, index auto, blueprints, output protocol, dashboards ├── 09_pe90057_golden_historico/ — contexto Golden historico (nao operar) ├── _inbox/ — drop zone para docs externos ├── _archive/ — orfaos, snapshots, superseded │ ├── Mentari/ — codebase UTV Python (hibernacao activa, 190 testes) │ ├── tools/agent_sdk/ — prototipos Agent SDK (orquestracao multi-agente) │ └── tools/visual_law/— engine Visual Law (docs juridicos com comunicacao visual) ├── golden_ai/ — ativo de reaproveitamento (RAG, DLP, token engine) ├── pipes/ — 23 pipes + MCP server com 35 tools ├── .claude/ — commands/ (15 skills), settings.local.json │ ├── CLAUDE.md — sistema nervoso (ler primeiro, sempre) ├── MAILBOX.md — bridge Code↔Cowork └── README.md

Regras de routing

Tipo de output	Destino
Definicao de produto, decisao canonica, protocolo	`00_canonicos/`
RFI comercial, pitch, proposta, FAQ	`01_rfi/comercial/`
RFI pesquisa, benchmark, concorrente	`01_rfi/pesquisa_mercado/`
Mentari filosofia, Aria, system prompt	`02_mentari/aria/`
Sergio, It'Singular	`03_itssingular_sergio/`
Infra pessoal, calibragens, opsec	`04_pessoal/`
Logs, briefs, gateway invocations	`05_logs/`
Demo HTML, guia visual	`07_demos_html/`
Vault health, blueprints, governance	`08_governance/`
Doc nao classificado / externo	`_inbox/` → triagem

Arquitectura mothership + esquadrao

MOTHERSHIP (Claude Code, Opus 4.6 1M) │ ├── SKILLS (15 workflows pre-definidos, .claude/commands/) │ ├── /council — 5 advisors + peer review + chairman │ ├── /autoreason — debate agonico drafter→critic→rewriter │ ├── /superpowers — pipeline 7 fases para builds │ ├── /wiki-update — vault health + index │ ├── /simplify — review de qualidade pos-mudanca │ ├── /slides — Marp deck generator │ ├── /cross-audit — auditoria 8 criterios + MCP │ ├── /reconcile — reconciliacao semanal │ ├── /pre-flight — gate bloqueante Tier 2+ │ ├── /deep-dd — investigacao multi-camada autonoma │ ├── /long-form — producao de docs longos multi-sessao │ ├── /citation-audit — curadoria de citacoes juridicas │ ├── /war-room — sessao intensiva com checkpoint auto │ ├── /visual-law — docs juridicos com comunicacao visual │ └── /claude-api — build/debug apps Claude API/SDK │ ├── TOOLS NATIVAS (built-in Claude Code) │ ├── Read/Write/Edit — filesystem directo │ ├── Glob/Grep — busca por nome / conteudo │ ├── Bash — qualquer comando sistema │ ├── Git — version control + audit trail │ ├── WebSearch/Fetch — pesquisa web em tempo real │ ├── Agent — sub-agentes paralelos │ └── TodoWrite — tracking de tarefas │ ├── ESQUADRAO GATEWAY (MCP bridge → RFI Gateway, 35 tools) │ ├── OSINT (11) — CNPJ, CEP, WHOIS, web, transparencia, JuDit (6) │ ├── Analise (4) — lex_juridico, coliseu, adversarial, hallucination_check │ ├── Research (4) — deep_research, grounded_analysis, multi_research, news_monitor │ ├── Judicial (11) — DataJud (4) + JuDit (7): processos, classes, textual, monitoramento │ ├── MEI (2) — mei_fiscal, mei_score │ ├── Jurisprudencia (2) — jurisprudencia, jurisprudencia_tribunais (25 TJs) │ ├── Sherlocker (10) — pessoa, empresa, processos, imoveis, veiculos, dividas, beneficios, rural, perfil, busca_reversa │ └── rfi_hello — smoke test do bridge │ ├── MEMORIA PERSISTENTE (~/.claude/projects/.../memory/) │ ├── MEMORY.md — indice de 30+ memorias │ ├── feedback_*.md — calibracoes, preferencias │ ├── project_*.md — contexto de projectos │ └── reference_*.md — ponteiros externos │ └── BRIDGE CODE↔COWORK └── MAILBOX.md — comunicacao assincrona

15 Skills — quando usar cada um

Skill	Tipo de trabalho	Tempo
/council	Decisoes estrategicas, pricing, naming, posicionamento, cap table	~4 min
/autoreason	Pareceres, pitches, propostas, copy, comunicacoes formais	~3-5 min
/superpowers-planning	Builds multi-file, features complexas, refactors	~15-30 min
/wiki-update	Vault health, INDEX_AUTO, orphans, freshness	~2 min
/simplify	Review pos-edit: reuse, qualidade, eficiencia	~2 min
/slides	Marp deck de qualquer topico	~5 min
/cross-audit	Auditoria 8 criterios + MCP cross-check de output	~5-10 min
/reconcile	Reconciliacao semanal MAILBOX vs vault vs decisoes	~3-5 min
/pre-flight	Gate bloqueante para doc que vai para terceiros	~1-4 min
/deep-dd	Investigacao multi-camada autonoma (OSINT + Sherlocker + analise)	~10-20 min
/long-form	Producao de docs longos com checkpoints multi-sessao	~20-60 min
/citation-audit	Curadoria e validacao de citacoes juridicas	~5-10 min
/war-room	Sessao intensiva com checkpoint automatico	variavel
/visual-law	Docs juridicos com comunicacao visual (Visual Law engine)	~10-20 min
/claude-api	Build, debug e optimizacao de apps Claude API/Anthropic SDK	variavel

MCP Gateway — 35 tools do esquadrao externo

OSINT (11 tools)

CNPJ, CEP, WHOIS, web search, Portal da Transparencia, JuDit (existe, rapida, cadastral, agrupada, monitorar, monitoramentos). APIs publicas gratuitas.

Analise (4 tools)

lex_juridico (Sonnet, ~$0.05-0.10), coliseu (3 modelos + arbitro, ~$0.20-0.60), adversarial (debate/devils_advocate, ~$0.10-0.30), hallucination_check (Gemini+Sonnet, ~$0.05-0.15).

Research (4 tools)

deep_research (pesquisa profunda web), grounded_analysis (analise com fontes), multi_research (multi-modelo com cross-check), news_monitor (monitoramento de noticias).

Judicial (11 tools)

DataJud (processo, classe, textual, multi) + JuDit (existe, rapida, cadastral, agrupada, monitorar, monitoramentos, osint_judit). Acesso a processos judiciais em tempo real.

Sherlocker (10 tools)

OSINT investigativo avancado: pessoa, empresa, processos, imoveis, veiculos, dividas, beneficios, rural, perfil completo, busca reversa. Requer autorizacao por chamada.

MEI + Jurisprudencia (4 tools)

mei_fiscal (classificacao ISS), mei_score (score de credito). jurisprudencia + jurisprudencia_tribunais (25 TJs via juscraper).

    Regra de invocacao: MCP tools sao invocadas proactivamente (sem pedir) quando acrescentam valor. Cada invocacao gera bloco 5W2H + SELF-ASSESSMENT no chat + entrada em 05_logs/gateway_invocations.md. Guardrail: cadeias >$3 USD pedem go previo.
  

Memoria persistente

Ficheiros em ~/.claude/projects/.../memory/ que sobrevivem entre sessoes. O Code le automaticamente ao iniciar. 30+ memorias activas cobrindo: calibracoes, frameworks, preferencias, contexto de projectos, esquadrao config.

Protocolo de abertura de sessao (v1.3)

Passo zero obrigatorio. 5 etapas + MAILBOX. Definido em 00_canonicos/PROTOCOLO_ABERTURA_SESSAO.md.

As 5+1 etapas

Trilha de leitura — 10 docs: CLAUDE.md, INDEX_VAULT, PRODUCT_DEFINITION, DECISIONS_OPEN, MENTARI_UTV_INVENTORY, PROJETO_OPERADOR, morning brief, BACKLOG, gateway_invocations, MAILBOX

Verificacao de estado — git status, git log, untracked na raiz, _inbox, tail gateway log, rfi_hello pre-flight

Memoria persistente — confirmar que MEMORY.md tem categorias completas

Reconstrucao de contexto — fase do projecto? decisoes bloqueantes? quem espera entrega? Cowork deixou algo no MAILBOX?

Confirmacao calibrada — "Protocolo concluido. Li N canonicos. Branch: X. Ultimo commit: Y. N decisoes. MAILBOX: [vazio/N msgs]. Pronto."

MAILBOX — bridge Code↔Cowork

O que e

MAILBOX.md na raiz. Caixa de mensagens assincrona. 5 tipos: DECISAO, CONTEXTO, TAREFA, PERGUNTA, CHECKPOINT. Tags de projecto: RFI/MENTARI/ITSING/INFRA/CROSS.

4 regras

Ler ao abrir — processar pendentes antes de trabalhar
Escrever ao fechar — CHECKPOINT obrigatorio
Decisoes em AMBOS — MAILBOX + canonicos
Delegacao cruzada — Code↔Cowork via TAREFA

5W2H Reporting (esquadrao Gateway)

Toda invocacao MCP substantiva produz bloco estruturado: WHAT, WHY, WHERE, WHEN, WHO, HOW, HOW MUCH + SELF-ASSESSMENT (Qualidade, Custo×Valor, Delta, Proxima vez). No chat + log persistente.

5 Camadas de redundancia

Check automatico MAILBOX

Sempre activo. Flag issues obvias ao processar msg do outro agente. ~0 custo.

/cross-audit

8 criterios + MCP + council opcional. Sob demanda ou proactivo. ~$0.10-0.30.

MAILBOX audit-request

Pedir ao outro agente que audite da perspectiva dele. Assincrono. ~0 custo.

Confidence tag

Automatico em outputs importantes. "CONFIDENCE: X%. AUMENTARIA COM: [lista]". Direcciona o cross-audit.

/pre-flight gate

BLOQUEANTE para docs que vao para terceiros. 5 blocos de checklist. Doc SO sai se PASS.

Handoff proactivo

Cada agente alerta Ricardo quando detecta que o trabalho seria melhor no outro. Formato: HANDOFF SUGERIDO → [COWORK/CODE] com razao + o que ja fez + sugestao.

Autonomia — o que e auto vs confirmar

Pre-aprovado (sem perguntar)

Criar/editar ficheiros em pastas existentes
Commits em branches de feature
Invocar skills (council, autoreason, etc.)
Invocar MCP tools (com reporte 5W2H)
Config writes locais (com diff + backup + reporte)
Push para branches de feature
Smoke tests, validacoes, grep

Requer confirmacao explicita

Push para master
Merge para master
Edits em CLAUDE.md da raiz
Envio de emails/mensagens a terceiros
Compromissos financeiros
Alteracoes em .gitignore que exponham secrets
Accoes irreversiveis (delete destrutivo, force push)
Cadeias MCP >$3 USD

Regras duraveis

Posicionamento de Ricardo▶

Correcto: Advogado com trajetoria em M&A, auditoria e estruturacao. Consultor de IA para mercado juridico.
NUNCA: "ex-GC de empresa de tecnologia", CTO, engenheiro, tech founder. Golden NUNCA como credencial tecnica.

Directriz de marca — "Atracao, nao promocao"▶

Sobrio mas criativo. Nunca inflar. Se MVP, diz MVP. Proibido: "revolucionario", "transforme", "a unica plataforma que". Tom: "Aqui esta o que faz. Aqui esta como funciona. Aqui esta o resultado real."

Prioridades — regra de conflito▶

Deadline rigido → PE 90057 | Tempo escasso → RFI | Energia residual → Mentari

RFI e prioridade #1 (gera caixa). Mentari e laboratorio paralelo. Trabalho regular (advocacia Golden) e fundacao.

Anti-bicicleta + escala de veiculo▶

Se detectar prompts repetitivos, copy-paste, ou escopo pequeno demais: sinalizar e propor upgrade. Escala: Bicicleta → Carro → Tanque → Aviao → Foguete → Mothership. Ricardo no nivel Aviao.

Modo de falha + autonomia▶

Errar por excesso de iniciativa, nao por omissao. Entregar 80% rapido, nao 100% tarde. Excepcao: comunicacoes externas, decisoes legais, compromissos financeiros — confirmar antes.

Autonomia total. Nunca perguntar "quer que eu avance?" — avancar e resumir. Sempre avaliar criticamente antes de executar (feedback 12/04).

Pasta de trabalho — NUNCA cloud sync▶

Pasta de trabalho NUNCA dentro de Google Drive Streaming, OneDrive, Dropbox. Paths locais directos: C:\Users\useradmin\[Pasta]. GDrive serve cache silencioso que faz parecer que o agente errou.

Regra de ouro

    Mesmo modelo (Opus 4.6, 1M context). Mesma inteligencia. O que muda sao as ferramentas. Code tem filesystem, git, MCP, skills, bash. Cowork tem pensamento longo sem interrupcao. Neste workspace, Code lidera (e o piloto tecnico). Cowork suplementa com profundidade estrategica.
  

Comparativo visual

Pesquisa juridica (MCP + Web)

Code 95%

Cowork 30%

Due diligence (OSINT)

Code 100%

Decisao multi-perspectiva

Code 95%

Cowork 40%

Vibe coding / builds

Code 100%

Versionamento / audit trail

Code 100%

Vault governance

Code 100%

10%

Product definition / strategy

Code 70%

Cowork 80%

Pensamento estrategico longo

Code 55%

Cowork 90%

Brainstorm / ideacao

Code 40%

Cowork 85%

Individuacao / Aria / frameworks

Code 25%

Cowork 95%

Memoria entre sessoes

Code 85%

Cowork 20%

Decisao rapida por tipo de trabalho

Preciso de...	Usar
Pesquisa CNPJ / QSA / empresa	CODE rfi_osint_cnpj
Analise juridica independente	CODE rfi_lex_juridico
Multiplas perspectivas sobre decisao	CODE /council
Parecer formal com fundamentacao	CODE /parecer (se tiver) ou /autoreason
Build de feature / codigo	CODE /superpowers
Versionar docs com audit trail	CODE git
Vault maintenance	CODE /wiki-update
Doc para terceiros	CODE /pre-flight (obrigatorio)
Estrategia profunda com contexto acumulado	COWORK
Drafting narrativo longo	COWORK
Brainstorm exploratorio	COWORK
Sessao Aria / individuacao	COWORK
Dimensao psicologica / relacional	COWORK
Product definition (empresarial × tecnico)	AMBOS — Cowork pensa, Code formaliza + /council

Pipeline ordinario — dia-a-dia

Sessao tipica de trabalho

Abrir Code — "execute o protocolo de abertura" ou prompt especifico

Protocolo — 10 docs + git status + inbox + rfi_hello + MAILBOX

Trabalhar — executar pedido de Ricardo (pesquisa, build, analise, parecer, governance)

Skills — invocar council/autoreason/cross-audit conforme tipo de output

Commitar — git add + commit com mensagem descritiva

CHECKPOINT — escrever no MAILBOX: o que fez, decisoes, contexto, pendencias

Sessao com handoff Code → Cowork → Code

Code abre — protocolo + identifica trabalho

Code pesquisa — MCP, web, vault search. Prepara contexto

Code escreve CHECKPOINT + TAREFA para Cowork no MAILBOX

Ricardo abre Cowork. Cowork le MAILBOX

Cowork trabalha — estrategia, drafting, brainstorm com contexto do Code

Cowork escreve CHECKPOINT com destilacao de contexto

Ricardo abre Code. Code le MAILBOX

Code formaliza — /autoreason, commit, /pre-flight se for para terceiros

Pipelines extraordinarios

Reconciliacao semanal (/reconcile)▶

Quando: inicio de semana ou pos-pausa >2 dias.
1. Ler MAILBOX completo (pendentes + arquivo recente)
2. Reconciliar DECISOES vs DECISIONS_OPEN (stale? incomplete? lost?)
3. Verificar premissas vs dados reais (rfi_osint_cnpj se aplicavel)
4. /wiki-update (vault health)
5. Produzir RECONCILIATION REPORT

Cross-audit de output (/cross-audit)▶

Quando: output importante, doc recebido do Cowork, antes de decisao.
8 criterios: audiencia, SSoT, confidencialidade, fundamentacao legal, dados verificaveis, coerencia, completude, tom.
+ MCP cross-check (rfi_lex_juridico, rfi_osint_cnpj).
+ Council stress-test (opcional para decisoes de alto impacto).
→ AUDIT REPORT com PASS/FLAG/FAIL + confidence tag.

Pre-flight para documentos de saida (/pre-flight)▶

OBRIGATORIO antes de qualquer doc sair para terceiros.
5 blocos: classificacao, confidencialidade, qualidade, consistencia, formato.
Se algum item falhar: BLOQUEADO — doc nao sai ate resolver.
Este e o ultimo gate antes da entrega.

Onboarding de novo workspace▶

Padrao validado em 12/04 (Golden Societario):
1. Estrutura de pastas + git init
2. .claude/settings.local.json (MCP permissions)
3. Skills (copiar/adaptar do Mentari)
4. CLAUDE.md (14 seccoes adaptadas)
5. Protocolo de abertura + MAILBOX + canonicos
6. Governance (output protocol, index, vault health)
7. Suporte (inbox, gateway log, gitignore)
8. Git commit + verificacao + seed de memoria
~75-90 min para workspace completo.

Vault health maintenance (/wiki-update)▶

Quando: apos criar/mover/deletar docs, ou semanalmente.
1. Scan completo de .md/.html
2. Regenerar INDEX_AUTO.md
3. Update DASHBOARD.md
4. Health check: orphans, broken links, duplicatas, decisoes pendentes
5. VAULT_HEALTH_REPORT actualizado
~2 min. Proactivo (nao esperar Ricardo pedir).