A spec aberta para conhecimento que publica.
Um diretório de arquivos markdown. YAML frontmatter. Três regras. Esse é o formato inteiro. Seus agentes IA parseiam sem adaptadores, seu time revisa no git, e seus docs nunca mais apodrecem fora do contexto.
Baseada na spec Markdown do Google Cloud · Licença MIT
├── index.md
├── what-is-okf.md
└── validation-rules.md
---
type: concept
title: What is OKF
---
# What is OKF
The Open Knowledge Format is a spec for
representing knowledge as markdown files.Por que isso existe
A maioria dos formatos de conhecimento pede que você aprenda um schema, instale um SDK, e migre seu conteúdo para um store proprietário. OKF pede que você continue escrevendo markdown. A spec existe para garantir três coisas:
- Um índice, uma verdade.
- Todo bundle tem um index.md que lista o que está dentro. Agentes não adivinham estrutura — eles leem.
- Frontmatter tipado.
- Cada arquivo declara seu tipo (concept, howto, reference, decision, metric). Agentes roteiam para o handler certo sem heurísticas.
- Histórico nativo do Git.
- Diff, branch, review conhecimento como código. Nenhum formato proprietário mantém seu conteúdo refém. Semver protege seu investimento.
Um bundle é assim
# index.md — the entry point
---
title: My Knowledge Bundle
version: 0.1.0
entries:
- what-is-okf.md
- validation-rules.md
---
# My Knowledge Bundle
Everything an AI agent needs to know about…Valide antes de publicar
Cole ou faça upload de um bundle. Verifique conformidade contra três regras — no navegador. Zero backend, zero instalação. Saiba que seu bundle está correto antes do seu agente lê-lo.
Abrir Validador →Ensine a spec ao seu agente
Instale uma skill que faz Claude, Codex ou Cursor produzir bundles conformantes. Sem system prompts, sem instruções frágeis. O agente produz output correto porque conhece o formato.
Instalar Skill →Publique seu primeiro bundle em dois minutos.
Três arquivos. Um comando para validar. Zero dependências.