OpenWiki 0.2: 코드베이스 위키에 OKF 형식 지원 추가

https://www.langchain.com/blog/openwiki-0-2-adds-okf-support

OpenWiki는 코드베이스 문서를 생성하고 유지 관리해 주는 저희의 오픈소스 CLI입니다. 저장소의 위키를 만들고, 그 위키를 코딩 에이전트에 연결하며, 코드가 바뀌면 문서도 함께 최신 상태로 유지합니다. OpenWiki 0.2에서는 개발자가 코드베이스 위키를 분류하고 구조화하기가 더 쉬워집니다.

OpenWiki 첫 릴리스는 코드베이스를 바탕으로 Markdown 문서를 생성하고 정리했습니다. 예상할 수 있듯이 코드베이스가 크면 위키도 커지기 마련입니다. 위키 파일이 수백 개에 이르면 문서를 찾고, 갱신하고, 검색하고, 검토하는 데 구조가 중요해집니다.

OpenWiki 0.2는 Google Cloud가 지식 위키 구조화를 위해 제안한 표준인 OKF 지원을 추가합니다. 덕분에 생성된 위키에 더 나은 구조를 부여할 수 있고, 그 결과 코딩 에이전트가 위키를 탐색하기가 더 쉬워집니다. 문서가 좋아지면 에이전트가 검색에 들이는 시간이 줄어들어 소요 시간과 토큰을 아낄 수 있습니다.

OKF가 더해 주는 것

OpenWiki 0.2에서는 OpenWiki가 생성하거나 갱신하는 위키가 OKF 형식을 따릅니다. 이제 위키 파일에는 제목, 설명, 태그, 카테고리, 리소스 URL 같은 필드를 담은 YAML 프런트매터가 포함됩니다.

OKF는 두 가지 규약을 정의합니다.

index.md는 각 위키 디렉터리의 파일과 하위 디렉터리를 요약합니다.
logs.md는 체인지로그처럼 위키의 변경 이력을 시간순으로 기록합니다.

이 체인지로그는 갱신 작업에서 특히 유용합니다. 실행이 끝날 때마다 위키 전체를 읽는 대신 logs.md만 확인하면 무엇이 바뀌었는지, 어떤 파일이 수정됐는지, 더 자세한 내용은 어디를 봐야 하는지 알 수 있습니다.

OKF 예시

OKF 명세는 본질적으로 매우 단순해서 OpenWiki에 통합하기 쉽습니다. YAML 프런트매터에는 추가하기 쉬운 핵심 필드 몇 가지만 들어갑니다.

---
type: <Type name>                  # REQUIRED - identifying concept of the doc. E.g. "BigQuery Schema"
title: <Optional display name>
description: <Optional one-line summary>
resource: <Optional canonical URI for the underlying asset>
tags: [<tag>, <tag>, …]            # Optional
timestamp: <ISO 8601 datetime>     # Optional last-modified time
# … other producer-defined key/value pairs
---

각 위키 파일에 이런 YAML 프런트매터가 있으면, 프런트매터에서 description 필드를 추출해 위키의 index.md 파일을 결정론적으로 생성할 수 있습니다.

# Section / Group Heading

* Title 1 - description of item 1
* Title 2 - description of item 2

# Another Section

* Subdirectory - description of the subdirectory

마지막으로, OpenWiki는 실행이 끝날 때 자신이 변경한 내용을 기록하는 log.md를 생성할 수 있습니다. log.md 지원은 위키 갱신을 마치면 log.md 파일을 갱신하라고 지시하는 프롬프트 몇 줄을 OpenWiki에 추가하는 것으로 충분합니다.

# Directory Update Log

## 2026-05-22
* **Update**: Added new BigQuery table reference for [Customer Metrics](/tables/customer-metrics.md).
* **Creation**: Established the [Dataplex Playbook](/playbooks/dataplex.md).

## 2026-05-15
* **Initialization**: Created foundational directory structure.
* **Update**: Added progressive-disclosure guidelines to the root [index](/index.md).

에이전트를 위한 더 나은 검색

OpenWiki는 AGENTS.md, CLAUDE.md 같은 파일을 통해 저장소 위키를 코딩 에이전트에 노출하고, 에이전트가 위키에서 필요한 컨텍스트를 검색할 수 있게 합니다.

OKF는 모든 문서에 구조화된 메타데이터를 추가하므로, 앞으로 나올 OpenWiki 도구는 태그, 카테고리, 설명 같은 필드에 대한 결정론적 검색을 지원할 수 있습니다. 예를 들어 에이전트가 자유 탐색형 에이전트 검색에만 기대는 대신, BigQuery tables 카테고리에 속한 모든 문서나 billing 태그가 붙은 모든 문서만 걸러서 볼 수 있습니다.

에이전트 검색은 유용하지만, 단순한 조회에는 쓸데없이 느리고 비쌀 수 있습니다. 구조화된 메타데이터 덕분에 OpenWiki는 더 빠른 검색 도구로 나아갈 깔끔한 길을 확보하게 됩니다.

OKF 생태계와 함께 쓰기

OKF는 개방형 형식이므로, OpenWiki 위키는 일회성 통합에 기대는 대신 커뮤니티가 만든 뷰어, 렌더러, 린터 등 호환 도구와 함께 쓸 수 있습니다. 최근 등장한 이런 오픈 생태계 프로젝트 몇 가지를 정리한 글도 있습니다: https://www.owox.com/blog/articles/okf-ecosystem-tools

즉, OpenWiki 사용자는 지금 당장은 더 표준적인 위키 형식을 얻고, 저희가 다음에 만들 도구를 위한 더 탄탄한 기반까지 함께 얻게 됩니다.

Google은 위키를 들여다보고 문서 간 관계를 확인할 수 있는 오픈소스 OKF 위키 시각화 도구를 공개했습니다. OpenSWE 저장소를 시각화한 모습은 다음과 같습니다.

OpenWiki 0.2 사용해 보기

이미 OpenWiki를 쓰고 있다면 업그레이드만 해도 위키가 OKF 형식으로 생성되고 갱신됩니다. OpenWiki가 처음이라면 설치해서 몇 분 만에 저장소 위키를 만들 수 있습니다.

저장소는 여기에서 확인하세요: https://github.com/langchain-ai/openwiki

오늘 바로 로컬에서 사용해 보세요.