Pular para conteúdo

DATA-CLASSIFICATION.md - Classificação e Roteamento de Dados

Documento de Governança APEX Define onde cada tipo de informação deve ser armazenada. Última atualização: 2026-01-11


Princípio Fundamental

┌─────────────────────────────────────────────────────────────┐
│  INFORMAÇÕES SENSÍVEIS  ≠  PROCESSOS OPERACIONAIS           │
│                                                             │
│  Cada tipo de dado tem seu lugar correto.                   │
│  Errar o destino compromete segurança ou acessibilidade.    │
└─────────────────────────────────────────────────────────────┘

Sistemas de Armazenamento Disponíveis

Sistema Propósito Acesso Persistência
APEX Local Memória estratégica Diretoria + Agentes Git + Supabase
BookStack Processos operacionais Time operacional Wiki externa
Supabase SSoT de métricas Agentes APEX Banco PostgreSQL
Monday Gestão operacional Time completo SaaS externo

Classificação de Dados

1. SENSÍVEL (APEX Local)

Definição: Informações estratégicas, confidenciais ou que requerem controle de acesso restrito.

Onde armazenar: - Repositório APEX: /apex/{tenant}/DOCS/ - Supabase: Tabelas apex_* (via MCP tools) - Memory System: Episodic + Semantic

Exemplos:

Tipo Exemplo Caminho
Estrutura organizacional Organograma, salários, cotistas DOCS/operations/
Rotinas de diretoria Cadência, rituais, gaps DOCS/operations/
Decisões pendentes Estratégias não finalizadas DOCS/strategy/
Planos estratégicos Roadmap confidencial DOCS/strategy/
Análises de risco Vulnerabilidades internas DOCS/operations/
Negociações Clientes, investidores, M&A DOCS/finance/
Feedback confidencial Avaliações, 1:1s DOCS/operations/
Métricas internas Unit economics, runway Supabase (apex_metrics)
Hipóteses de negócio Testes, validações Supabase (apex_hypotheses)

Regra de ouro:

SE a informação não deve ser vista pelo time operacional
   → APEX Local


2. PROCESSOS OPERACIONAIS (BookStack)

Definição: Documentação de procedimentos, runbooks e guias para execução do time operacional.

Onde armazenar: - BookStack: book.arcosscale.com.br - Organizado por área/departamento

Exemplos:

Tipo Exemplo Livro BookStack
Runbooks Como fazer onboarding de cliente SDR/BDR - PROSPECÇÃO
Procedimentos Passo a passo de criação de campanha GROWTH & TECH
Checklists Checklist de fechamento de venda CLOSER
Guias de sistema Como usar o Monday MANUAIS DE USO
Scripts Script de cold call SDR/BDR - PROSPECÇÃO
FAQs Dúvidas frequentes do cliente SUPORTE
SLAs Tempos de resposta OPERAÇÕES
Troubleshooting Como resolver erro X MANUAIS DE USO

Regra de ouro:

SE a informação é "como fazer" para o time operacional
   → BookStack


3. CONHECIMENTO ESTRATÉGICO CONSOLIDADO (DOCS/)

Definição: Decisões finalizadas, análises aprovadas e conhecimento que pode ser compartilhado internamente.

Onde armazenar: - Repositório APEX: /apex/{tenant}/DOCS/ - Estruturado por pilar (strategy, product, finance, etc.)

Exemplos:

Tipo Exemplo Caminho
Decisões finalizadas Pricing aprovado DOCS/strategy/
Análises de mercado TAM/SAM/SOM DOCS/strategy/
Roadmaps públicos Roadmap do trimestre DOCS/product/
Case studies Casos de sucesso DOCS/operations/
Playbooks Playbook de vendas DOCS/operations/
Métricas públicas KPIs do time DOCS/operations/

Regra de ouro:

SE a informação é decisão finalizada OU análise aprovada
   → DOCS/ (repositório APEX)


Fluxo de Promoção

┌─────────────────────────────────────────────────────────────┐
│                    CICLO DE VIDA DO DADO                    │
│                                                             │
│   SENSÍVEL (APEX)                                           │
│       │                                                     │
│       │ Decisão aprovada pelo founder                       │
│       ▼                                                     │
│   ESTRATÉGICO (DOCS/)                                       │
│       │                                                     │
│       │ Operacionalizado em procedimento                    │
│       ▼                                                     │
│   PROCESSO (BookStack)                                      │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Exemplos de Promoção

Origem Destino Gatilho
Rotina de diretoria (APEX) Cadência oficial (DOCS) Aprovação do CEO
Decisão de pricing (APEX) Pricing oficial (DOCS) Validação CFO
Estratégia de vendas (DOCS) Script de vendas (BookStack) Operacionalização
Análise de churn (DOCS) Runbook de retenção (BookStack) Procedimento definido

Checklist para Claude

ANTES de salvar qualquer informação, Claude DEVE verificar:

CHECKLIST_CLASSIFICACAO:

  1. Tipo de informação:
     - [ ] É sobre estrutura interna, salários, cotistas? → APEX
     - [ ] É sobre rotinas de diretoria? → APEX
     - [ ] É decisão ainda não finalizada? → APEX
     - [ ] É negociação ou análise de risco? → APEX
     - [ ] É procedimento "como fazer"? → BookStack
     - [ ] É decisão finalizada e aprovada? → DOCS/

  2. Quem precisa acessar:
     - [ ] Apenas diretoria/founder? → APEX
     - [ ] Time operacional precisa executar? → BookStack
     - [ ] Time precisa consultar decisão? → DOCS/

  3. Nível de confidencialidade:
     - [ ] Confidencial/sensível? → APEX
     - [ ] Interno mas não sensível? → DOCS/
     - [ ] Operacional/público interno? → BookStack

Integração com Memory System

Este documento complementa o MEMORY-SYSTEM.md:

Memory Type Storage Location Classification
Episodic APEX Local SENSÍVEL
Semantic APEX Local + DOCS/ SENSÍVEL → ESTRATÉGICO
Procedural DOCS/ + BookStack ESTRATÉGICO → PROCESSO

Mapeamento

MEMORY_TO_STORAGE:

  EPISODIC_MEMORY:
    Storage: /apex/{tenant}/DOCS/operations/memory/episodic/
    Classification: SENSÍVEL
    Never: BookStack

  SEMANTIC_MEMORY:
    Storage:
      - Supabase (apex_metrics, apex_decisions)
      - /apex/{tenant}/DOCS/ (por pilar)
    Classification: SENSÍVEL ou ESTRATÉGICO
    Never: BookStack (exceto se virar processo)

  PROCEDURAL_MEMORY:
    Storage:
      - /apex/{tenant}/DOCS/ (playbooks, templates)
      - BookStack (runbooks, procedimentos)
    Classification: ESTRATÉGICO ou PROCESSO
    Promoted To: BookStack quando operacionalizado

Erros Comuns a Evitar

1. Salvar informação sensível no BookStack

❌ ERRADO:
   - Estrutura organizacional no BookStack
   - Rotinas de diretoria no BookStack
   - Salários ou cotistas no BookStack

✅ CORRETO:
   - Estrutura organizacional em /apex/arcosscale/DOCS/operations/
   - Rotinas de diretoria em /apex/arcosscale/DOCS/operations/

2. Salvar processo operacional no APEX

❌ ERRADO:
   - Script de vendas em /apex/DOCS/
   - Checklist de onboarding em /apex/DOCS/

✅ CORRETO:
   - Script de vendas no BookStack (livro CLOSER)
   - Checklist de onboarding no BookStack (livro RH)

3. Não promover conhecimento

❌ ERRADO:
   - Decisão aprovada fica só na memória episódica
   - Procedimento validado não vai para BookStack

✅ CORRETO:
   - Decisão aprovada → DOCS/strategy/
   - Procedimento validado → BookStack

Governança

Responsáveis

Classificação Owner Aprovador
SENSÍVEL CEO Founder
ESTRATÉGICO Head da área CEO
PROCESSO Líder operacional Head da área

Auditoria

  • Frequência: Trimestral
  • Escopo: Verificar se dados estão no lugar correto
  • Ação: Mover dados mal classificados

Comandos para Claude

# Verificar onde salvar
/classify "descrição da informação"

# Validar antes de salvar
/validate-storage "tipo de dado" "destino proposto"

# Promover dado
/promote "dado" "origem" "destino"

Changelog

Data Mudança Autor
2026-01-11 Criação inicial após incidente de classificação Claude + CEO

Referências

  • MEMORY-SYSTEM.md - Sistema de memória tripla
  • GOVERNANCE.md - Governança geral de agentes
  • CROSS_BU_RULES.md - Regras cross-tenant

Este documento é obrigatório para todos os agentes APEX.