Colliers × Costal — Interno

Guia — Uso do Obsidian para o projeto

Leitura de 5 min

Guia | Uso do Obsidian

guia obsidian onboarding

Como navegar, editar e contribuir no vault Colliers × Costal usando Obsidian. Para pessoas novas: ler até o fim. Para velhos: ler seção 4 (Bases) se ainda não domina.

1. Instalação e abertura

Instalação

  1. Baixar Obsidian de https://obsidian.md
  2. Versão mínima: v1.7+ (para suporte a Bases)
  3. Plataforma: Mac, Windows, Linux, iOS, Android

Abrir o vault

  1. Sincronizar a pasta Colliers_Projeto do Google Drive para o computador local (Google Drive desktop)
  2. Obsidian → Open folder as vault → selecionar Colliers_Projeto
  3. Confirmar trust author dos plugins na primeira abertura

Aviso: não commitar diretamente no repo wiki pelo Obsidian. O vault é a fonte; o repo é sincronizado via rclone (ver runbook-publicar-wiki).

2. Orientação inicial

Pontos de entrada

Quando abrir o vault:

  1. HOME — dashboard operacional do time
  2. README — visão narrativa do projeto
  3. TASKS — tarefas pendentes cross-frente
  4. MEETINGS — calendário e atas
  5. MEMORY-CONTRACT — regras do vault

Estrutura de pastas

Colliers_Projeto/
├── 00-projeto/         # governança: canônico, governanca, assessment, missões, board, reuniões
├── 01-colliers/        # frente Colliers
├── 02-costal/          # frente Costal + 26 agentes operacionais
├── 03-arquitetura/     # arquitetura técnica compartilhada
├── 04-referencia/      # PDFs e materiais originais
├── 05-arquitetura-empresarial/  # modelo global Blaschek
├── 06-directory/       # pessoas, times, aliases, matriz-decisao
├── 99-operacao/        # operação: prompts, scripts, publish, runbooks, guias
├── agentes-core/       # Axios (agente orquestrador)
├── _assets/            # imagens e logos
├── _bases/             # views dinâmicas (plugin Bases)
└── _templates/         # templates de novos arquivos

Cada pasta tem um folder note com o nome da pasta (ex: 02-costal.md ao lado de 02-costal/).

3. Plugins essenciais

Core (já habilitados)

  • Bases — views dinâmicas em tabela (ativado em core-plugins.json)
  • Templates — inserir conteúdo de _templates/
  • Graph view — visualizar relações entre arquivos
  • Backlinks — ver o que aponta para o arquivo atual

Opcionais recomendados

PluginPor quê
Folder NotesMelhora a navegação de folder notes (embora funcione sem ele)
DataviewQueries mais potentes que Bases (overlap com Bases; use Bases primeiro)
OutlinerEditar listas hierárquicas mais fluidamente

4. Bases (views dinâmicas)

Bases são tabelas que filtram e exibem arquivos do vault dinamicamente. Ficam em _bases/*.base.

Bases disponíveis

Bases ficam em _bases/*.base — só renderizam no Obsidian (não publicadas na wiki).

BaseO que mostra
tasks-abertasTarefas em aberto (TASKS.md + gaps + dependencias + arquivos tagueados)
proximas-reunioesCalendário e atas recentes por frente
definicoes-recentesDefinições operacionais + briefs recentes
meetingsTodas as reuniões
agentesCatálogo de agentes
stakeholdersPessoas mapeadas
camadas-canonicasDecisões, riscos, gaps, dependências

Como abrir uma base

Clique em um arquivo .base no painel — ele abre como tabela navegável. Cada view tem filtros distintos.

Como criar uma base nova

  1. Duplicar uma base existente
  2. Ajustar filters e views
  3. Salvar com nome descritivo
  4. Adicionar à listagem em _bases/_bases.md

Sintaxe do plugin: https://help.obsidian.md/bases

5. Convenções de escrita

Para detalhes práticos com exemplos, ver STYLE-GUIDE.

Resumo rápido:

  • Nomes de arquivo: YYYY-MM-DD_descricao.md para pontuais; nome-descritivo.md para perenes
  • Markdown obrigatório para conteúdo do projeto (Word pode ser usado e convertido via IA)
  • Frontmatter mínimo: title, updated, owner
  • Marcação epistêmica: [fato], [hipótese], [premissa], [gap]
  • Links internos: [[arquivo]] (Obsidian resolve por nome) ou [[caminho/arquivo]] (explícito)
  • Tags: #colliers, #costal, #meeting, #decisao, #risco, #gap, #dependencia, #todo, #sensivel

6. Usando templates

Em qualquer arquivo novo, usar Templates (Ctrl/Cmd + P → “Insert template”):

TemplatePara que
_templates/meeting.mdNova ata de reunião
_templates/spec.mdNova spec técnica
_templates/agente.mdDocumentar novo agente
_templates/mapeamento-processo.mdMapeamento de processo de negócio
_templates/mapeamento-sistema.mdMapeamento de sistema/ferramenta
_templates/discovery-session.mdDiscovery com stakeholder

7. Graph view (mapa de relações)

Ctrl/Cmd + G abre o Graph view.

Use para:

  • Ver hub nodes (arquivos muito linkados) — bons pontos de entrada
  • Detectar arquivos isolados (sem links entrada/saída) — podem ser órfãos
  • Entender clusters por frente (Costal vs Colliers)

Filtros úteis no painel direito:

  • Tags: destacar arquivos com #risco em vermelho, por exemplo
  • Groups: agrupar por pasta (auto-colore por pasta-raiz)
  • Filters: path:02-costal para ver só a frente Costal

8. Atalhos úteis

AtalhoAção
Ctrl/Cmd + OAbrir arquivo por nome
Ctrl/Cmd + PCommand palette (tudo)
Ctrl/Cmd + Shift + FBusca no vault inteiro
Ctrl/Cmd + EAlternar preview / edit
Ctrl/Cmd + [ / ]Voltar / avançar navegação
Ctrl/Cmd + GGraph view
Ctrl/Cmd + ,Configurações
Arrastar arquivo para textoCria wikilink automaticamente
[[Autocompletar wikilink
#Autocompletar tag

9. Fluxos comuns

Registrar uma reunião

Seguir runbook-rodar-reuniao.

Adicionar pessoa nova

Seguir runbook-onboard-pessoa.

Atualizar camada canônica

  1. Abrir o arquivo (ex: riscos)
  2. Adicionar linha na tabela com ID sequencial
  3. Commitar (salvar) — sync automático para o Drive

Buscar algo que já foi decidido

  1. Ctrl/Cmd + Shift + F → digite termo
  2. OU abrir base camadas-canonicas → ver “Decisões”
  3. OU perguntar ao Axios: ver runbook-acionar-agente

10. Problemas comuns

”Meu arquivo não aparece na wiki publicada”

Ver runbook-publicar-wiki — diagnóstico.

  • Arquivo referenciado não existe ainda → criar ou marcar [[futuro:X]]
  • Filename duplicado → usar caminho completo [[pasta/arquivo]]

”Bases não renderizam”

  • Verificar versão Obsidian (mínimo v1.7)
  • Confirmar plugin Bases ativo em Settings → Core plugins
  • Validar sintaxe do arquivo .base (YAML)

“Mudei e não sincronizou para o Drive”

  • Confirmar Google Drive desktop rodando
  • Evitar conflitos: fechar arquivos antes de mexer em outra máquina
  • Em último caso, puxar manualmente via Drive web

Ver também

Visão de gráfico

Backlinks