Igor Fernandes

GUIDELINES.md — Convenções do vault

Regras para criação, nomenclatura e organização de notas. Tanto humanos quanto agentes IA devem seguir estas convenções.

Nomenclatura de arquivos

Frontmatter YAML

Campos obrigatórios (toda nota)

---
title: "Título legível em português"
source: "Nome da fonte (InfoMoney, Hacker News, etc.)"
source_type: "rss|youtube|twitter|manual|book"
url: "https://..."
date: 2026-03-30
ingested: 2026-03-30T14:30:00
domain: "FIN|ENG|FLAG|EDU|VIT"
tags:
  - tag1
  - tag2
status: "inbox|reviewed|archived|starred"
summary: "Resumo de 2-3 linhas"
related:
  - "[[Nota relacionada 1]]"
  - "[[Nota relacionada 2]]"
---

Campos específicos por domínio

FIN (Finanças):

ticker: "PETR4"
asset_class: "renda-variavel|renda-fixa|fii|cripto|commodity|macro"
market: "BR|US|global"

ENG (Engenharia):

language: "go|python|rust|typescript|..."
area: "sistemas-distribuidos|ia-llms|devops|arquitetura|fundamentos|ferramentas"
repo_url: "https://github.com/..."

FLAG (Flag Theory):

flag_number: 1-7
jurisdiction: "Portugal|Paraguai|Dubai|..."
program_type: "cbi|residencia|offshore-corp|banking|..."

EDU (Educação clássica):

art: "gramatica|logica|retorica|aritmetica|geometria|musica|astronomia"
author: "Carpeaux|Hugo de São Vítor|Miriam Joseph|..."
work: "Nome da obra"
chapter: "Capítulo ou seção"

VIT (Hobbies):

subdomain: "carnes|vinhos|metais-preciosos|terras-produtivas"
type: "receita|analise|cotacao|nota-pessoal|degustacao"

Campos para blog (06-blog/)

publish: true|false
draft: true|false
slug: "url-amigavel-do-post"
hugo_section: "posts|notes|guides"
categories:
  - categoria1

Tags

Regras gerais

Tags reservadas (significado especial)

Tag Significado
urgente Requer atenção imediata (ex: mudança regulatória)
acao-necessaria Precisa de alguma ação concreta do dono
referencia Material de referência permanente (não temporal)
series Parte de uma série de notas sobre o mesmo tema
contradiz:[[nota]] Contradiz ou atualiza informação de outra nota

Status das notas

Status Significado Localização
inbox Recém-chegada, não revisada 00-inbox/
reviewed Revisada e aprovada pelo dono Pasta do domínio
archived Não mais relevante mas preservada Pasta do domínio
starred Importante, destacada Pasta do domínio
draft Artigo em rascunho 06-blog/drafts/
review Artigo em revisão 06-blog/review/
published Artigo publicado no blog 06-blog/published/

Maps of Content (MOCs)

MOCs são notas-índice que agregam e contextualizam notas de um ou mais domínios.

Estrutura de um MOC:

---
title: "Reserva de valor"
domain: "CROSS"
tags: [moc, ouro, terras, cripto, hedge]
status: "reviewed"
---

# Reserva de valor

Notas sobre ativos que preservam poder de compra no longo prazo.

## Metais preciosos
- [[analise-ouro-2026]]
- [[prata-como-hedge]]

## Terras produtivas
- [[terras-ms-precificacao]]

## Cripto como reserva
- [[bitcoin-tese-store-of-value]]

## Flag Theory — Ativos físicos
- [[flag-5-ativos-fisicos]]
- [[jurisdicoes-ouro-fisico]]

Regras para MOCs:

Templates

Templates ficam em vault/templates/ e são usados pelo Templater plugin.

Templates disponíveis:

Imagens e anexos