Skip to content

Repository files navigation

Polic Framework

Infraestrutura Epistêmica para Tomada de Decisão

image

"A gestão que as pequenas empresas precisam mas não podem contratar."


O Problema

Todo tomador de decisão — fundador, executivo, profissional — enfrenta o mesmo problema:

Têm dados. Não têm interpretação.

Olham para o financeiro e veem números. Não o que os números estão dizendo. Não qual pergunta fazer. Não qual decisão está disponível agora.

Hoje, esse problema é resolvido de duas maneiras:

  1. Você contrata alguém — um CFO, um chief of staff, um conselheiro de confiança — que lê os dados e diz o que significam.
  2. Você não tem essa pessoa — e decide sem interpretação, ou não decide.

O gap entre esses dois mundos é enorme. O Polic Framework existe para fechá-lo.


Por Que Isso Existe

Por anos trabalhei dentro de organizações construindo inteligência financeira — dashboards, modelos, sistemas de diagnóstico — para fundadores que não conseguiam ler seus próprios dados. Sentava com pessoas que tinham todos os números que precisavam e ainda não conseguiam decidir. Não porque fossem incapazes. Porque o número e a decisão viviam em mundos diferentes, e ninguém havia construído a ponte.

Eu era essa ponte. Lia os dados, entendia o contexto, sustentava múltiplas interpretações simultaneamente, e devolvia uma decisão que fazia sentido. Em algum momento percebi que estava resolvendo um problema estrutural sendo uma pessoa. Isso não escala. E deixa todos que não podem contratar essa pessoa completamente sem a camada de interpretação.

Quando os LLMs chegaram, entendi que o problema de tradução era solucionável em escala — mas só se o sistema que faz a tradução tivesse conhecimento documentado, raciocínio rastreável e responsabilidade epistêmica genuína. Não apenas um modelo que gera. Um framework que delibera. Este é esse framework.


O Que É Isso

Polic é uma infraestrutura epistêmica — uma metodologia para construir sistemas que:

  1. Organizam conhecimento com proveniência e rastreabilidade
  2. Deliberam através de múltiplas perspectivas antes de responder
  3. Executam decisões com raciocínio documentado
  4. Aprendem ao longo do tempo através de um sistema estruturado de emendas

O framework tem três camadas:

Camada 1 — Dados
  Dados brutos → dados tratados → visão gerencial
  (Arquitetura Bronze → Prata → Ouro)

Camada 2 — Interpretação
  Dados lidos por múltiplas perspectivas
  Diagnóstico entregue em linguagem de decisão
  Humano no loop para outputs de alto impacto

Camada 3 — Deliberação
  Conselho incorporado de perspectivas curadas
  Cada uma com DNA documentado, vieses, pontos cegos
  Raciocínio rastreável — não caixa-preta

O Insight Central

LLMs são a nova biblioteca.

Bibliotecas resolveram o problema de acesso ao conhecimento em escala. LLMs estão resolvendo o mesmo problema para interpretação. Mas bibliotecas precisavam de sistemas de classificação para serem confiáveis. LLMs precisam do mesmo — um substrato epistêmico que torna os outputs rastreáveis, auditáveis e confiáveis.

Este framework é esse substrato.


Conceitos-Chave

Deliberação Multi-Perspectiva

Em vez de pedir a uma única IA que responda, o framework roteia problemas por um conselho curado de perspectivas — cada uma com conhecimento documentado, vieses, amplificações e pontos cegos. A resposta emerge da deliberação, não da geração.

Arquitetura de Classificação

Inspirada no CDD (Classificação Decimal de Dewey) e CDU (Classificação Decimal Universal), adaptada para organização de conhecimento em sistemas nativos de LLM. Cada perspectiva tem:

  • Notação primária (posição no mapa de conhecimento)
  • Notação secundária (relações cross-domain)
  • Natureza epistêmica (perspectiva / processo / campo / função)
  • Nível de abstração (fundacional / teórico / aplicado / operacional)
  • Histórico de mudanças (revisão vs. ruptura paradigmática)

Proveniência Epistêmica

Cada decisão de classificação é rastreável:

  • uri_permanente — identificador persistente entre substratos
  • historico_notacao — histórico de mudanças com tipo (revisão vs. ruptura paradigmática)
  • episteme_contexto — declaração explícita de escolhas não-óbvias
  • skos_mapping — vocabulário W3C SKOS para exportação RDF e interoperabilidade

Biblioteca Agentizada

O framework evolui em direção a uma biblioteca que não apenas armazena conhecimento — ela executa. Perspectivas são ligadas a procedimentos. Procedimentos têm gatilhos de human-in-the-loop declarados. O sistema age, com humanos governando as transições críticas.


Os Três Papéis Sociais

À medida que essa infraestrutura amadurece, ela habilita três novos papéis profissionais:

Administradores de Conhecimento
  Constroem e governam a biblioteca epistêmica
  Curam perspectivas, validam classificações,
  aprovam emendas

Executores de Conhecimento
  Agentes que operam a partir da biblioteca
  Executam procedimentos com escopo declarado
  e gatilhos explícitos de escalada humana

Comunicadores de Conhecimento
  Interface entre a biblioteca e os usuários finais
  Traduzem outputs em linguagem acionável
  Mantêm a confiança entre sistema e humano

Implementação Comercial

A metodologia aberta neste repositório é aplicada comercialmente através do Polic — um serviço que entrega:

  • Dashboard — visão gerencial dos dados do seu negócio
  • Relatório mensal — dados interpretados em linguagem de decisão
  • Conselho incorporado — deliberação sobre o que fazer a seguir

A metodologia é gratuita. A implementação não é.

Se você quer o Polic aplicado ao seu negócio: → [contato]


Estrutura do Repositório

/
├── LICENSE             Elastic License 2.0 — livre para uso pessoal
├── NOTICE              Copyright 2026 Lucas Santos
├── README.pt.md        Este arquivo — visão e panorama geral
├── METHODOLOGY.pt.md   Como o sistema deliberativo funciona
├── ARCHITECTURE.pt.md  Arquitetura técnica
└── ROADMAP.pt.md       Para onde isso está indo


O Que "Implementação" Significa — e o Que Não Significa

A implementação comercial desta metodologia consiste em entregar diagnósticos, análise de dados e suporte à decisão apoiado por IA com base nos dados da sua organização.

Não significa — e não existe hipótese em que significaria — acesso ao sistema de conselho deliberativo:

Não disponível em nenhuma circunstância:
  → Acesso a banco de dados de qualquer tipo
  → Perfis, DNA ou configuração dos membros do conselho
  → Prompts de sistema ou arquitetura do conselho
  → Conteúdo de membros ou documentação de perspectivas
  → Infraestrutura interna do conselho

O que uma implementação comercial entrega:

✓ Dashboards gerenciais construídos sobre os seus dados
✓ Diagnósticos financeiros e operacionais
✓ Análise e interpretação apoiadas por IA
✓ Suporte à decisão ancorado no seu contexto específico
✓ Relatórios mensais ou periódicos em linguagem de decisão

O conselho é o instrumento usado para construir e validar a metodologia. Não é o produto. Não é compartilhado. Não é replicado.

Licença

Elastic License 2.0. Livre para uso pessoal. Uso comercial e treinamento de IA requerem permissão explícita.

Veja LICENSE para os termos completos.


Polic Framework — Lucas Santos — 2026

Releases

Packages

Contributors