sniperunder123/okf-knowledge

Turn scattered docs into a 지식 graph 당신의 AI 대리인은 실제로 사용할 수 있습니다

** 휴대용 클로드 코드 기술 (/okf]) 생성, 읽기, 유지, 시각화 Open Knowledge Format 번들 - 일반 지식, git-versionable Markdown. SDK가 없습니다. 데이터베이스 없음. 잠금 해제 **

---

⚠️ ** 면책 조항 - 이것은 vibe ‐coded입니다.** AI 쌍 프로그래머를 가진 1명의 사람에 의하여, 재미를 위한 붙박이 빠른. 테스트하고 작동하지만 ** 비공식 인디 프로젝트 ** (Google 또는 Anthropic과 제휴하지 않음), 배송 ** 0 보증 ** - 자신의 위험에 사용. 버그를 Spot? 문제 및 PRs 환영. 

TL;DR - 지식은 위키, 노tion, 3,000 라인 READMEs, 그리고 사람들의 머리에서 갇혀 - AI 에이전트가 잘 사용할 수 없습니다. OKF는 작은 Markdown 파일의 디렉토리로서의 지식을 나타냅니다. 각 파일은 one Concept (테이블, 엔드포인트, 메트릭, runbook…)이며, wiki 페이지와 같은 다른 개념과 연결되어있는 작은 YAML 헤더가 있습니다. 결과는 **navigable 지식 그래프 ** 에이전트는 기본적으로 git에 버전이 아니라 공급 업체가 소유하지 않습니다. 이 재포는 /okf 명령어로, 그 번들을 구축하고 유지한다.

---

✔ 문제 OKF 해결

---

⚠️ Disclaimer — this is vibe‑coded. Built fast, for fun, by one person with an AI pair‑programmer. It’s tested and it works, but it’s an unofficial indie project (not affiliated with Google or Anthropic), shipped as‑is with zero guarantees — use at your own risk. Spot a bug? Issues and PRs welcome. 🌊

TL;DR — Knowledge ends up trapped in wikis, Notion, 3,000‑line READMEs, and people’s heads — where AI agents can’t use it well. OKF represents knowledge as a directory of small Markdown files: each file is one concept (a table, an endpoint, a metric, a runbook…), with a tiny YAML header, linked to other concepts like wiki pages. The result is a navigable knowledge graph that agents read natively, that you version in git, and that no vendor owns. This repo is a /okf command that builds and maintains those bundles for you.

---
type: BigQuery Table          # the only required field
title: Orders
description: One row per completed customer order.
resource: bigquery://acme/sales/orders
tags: [sales, orders]
generated: { by: human:maintainer, at: 2026-05-28T00:00:00Z }   # optional, OKF v0.2
---

# Orders

Part of the [sales dataset](/datasets/sales.md). Feeds [gross revenue](/metrics/gross-revenue.md).

---

🤔 The problem OKF solves

Your organization’s knowledge is real but unusable by machines:

• 📚 Scattered across Confluence, Notion, Google Docs, READMEs, Slack threads, and people’s memory.
• 🔒 Locked in proprietary tools that need accounts, APIs, and scraping to read.
• 🧱 Monolithic — the one big doc that’s either loaded whole (expensive, slow) or ignored.