# Show GN: AKB - 사람과 AI가 함께 읽고 쓰는 팀 지식 인프라, 근데 권한 관리를 곁들인

> Clean Markdown view of GeekNews topic #30606. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=30606](https://news.hada.io/topic?id=30606)
- GeekNews Markdown: [https://news.hada.io/topic/30606.md](https://news.hada.io/topic/30606.md)
- Type: show
- Author: [jylkim](https://news.hada.io/@jylkim)
- Published: 2026-06-18T22:24:22+09:00
- Updated: 2026-06-18T22:24:22+09:00
- Original source: [github.com/dnotitia](https://github.com/dnotitia/akb)
- Points: 2
- Comments: 0

## Topic Body

안녕하세요. 제가 속한 디노티시아에서 AI 에이전트가 작업 중에 직접 읽고 쓰는 팀 지식베이스 [AKB(Agent Knowledge Base)](https://github.com/dnotitia/akb)를 만들고 있습니다.  
  
### 왜 만들었나요?  
  
사람이 쓰는 위키(Confluence·Notion)는 이미 많습니다. 에이전트 쪽에도 비슷한 도구가 있습니다. mem0는 대화에서 뽑은 내용을 개인 메모리로 쌓고, LLM Wiki는 에이전트가 읽고 쓸 개인 지식 베이스를 만듭니다. 다만 대체로 개인 단위에 머물러서 여러 사람이 함께 읽고 쓸 공통 기반으로 설계됐다고 보기는 어렵습니다.  
  
비슷한 문제의식을 구글의 [Open Knowledge Format(OKF)](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing)도 짚습니다. 지식이 위키·카탈로그·코드 곳곳에 흩어져 에이전트가 매번 맥락을 새로 끌어모아야 하니, 필요한 건 또 하나의 폐쇄적인 서비스가 아니라 여러 도구가 함께 읽고 쓸 수 있는 공통 포맷이라는 얘기입니다. OKF가 제안한 포맷은 단순합니다. 마크다운 파일을 폴더에 모으고, 각 파일 맨 위에 YAML 몇 줄을 붙이면 됩니다. 그리고 이 포맷을 누가 만들고 어떻게 읽고 확장할지는 각 구현의 몫으로 열어둡니다.  
  
### AKB는 무엇을 하나요?  
  
AKB는 그 포맷을 팀의 공통 지식 기반으로 구현한 인프라입니다. vault는 OKF와 호환되는 마크다운 묶음이지만, 검색해서 읽기만 하는 색인이 아니라 사람과 에이전트가 같은 원본을 **함께 읽고 쓰는** 공유 저장소입니다. 사람은 웹 UI로, 에이전트는 MCP로 접근합니다. 그래도 손대는 원본은 하나입니다. 에이전트가 쓰기 시작하면 "무엇이 어떻게 바뀌었나"도 중요합니다. vault가 Git 저장소라 모든 변경은 커밋과 diff로 남습니다.  
  
담는 것도 문서만이 아닙니다. OKF가 지식을 마크다운으로 적는 포맷이라면, AKB는 같은 vault에 쿼리 가능한 테이블과 파일 저장소를 더하고, 문서끼리는 지식 그래프로 잇습니다. 문서는 사람이 읽고 에이전트가 참조하는 지식으로 두고, 목록·상태·통계처럼 구조화해서 다룰 데이터는 별도의 테이블로 저장하고 쿼리할 수 있습니다. 그래서 사람용 위키나 검색만으로는 어려운 일, 이를테면 AKB를 데이터·변경 이력 레이어로 삼아 그 위에 업무 앱을 개발하고 운영하는 것도 가능합니다.  
  
다만 팀의 공통 지식 기반이 되려면 데이터와 이력만으로는 부족합니다. OKF 같은 포맷은 누가 무엇을 볼 수 있는지까지 정하지는 않습니다. **AKB에서 제일 공들인 부분이 그 권한입니다.** 에이전트는 자기 토큰을 발급한 사람으로 인증되고, 그 사람의 vault 권한을 그대로 물려받습니다. 사람에게 적용하던 접근 경계가 에이전트에게도 그대로 적용됩니다. 이 경계는 두 겹으로 강제합니다. 문서·파일·검색 같은 일반 접근은 앱 레이어에서 권한을 확인합니다. 테이블에 집계·분석 SQL을 돌리는 경로는 DB 레이어에서 한 번 더 막습니다. 쿼리가 그 사용자의 PostgreSQL 롤로 실행되는 PG ACL 방식이라, 권한 밖 vault를 참조하면 앱이 아니라 PostgreSQL이 직접 거부합니다.  
  
저희 팀은 AKB 인프라 위에 이슈 트래커 [reef](https://github.com/dnotitia/reef)를 올려서 쓰고 있습니다. 이슈 하나가 vault 안의 마크다운 문서이자 쿼리 가능한 테이블 행입니다. 개발자는 Claude Code·Codex 같은 코딩 에이전트로, PM은 reef의 전용 에이전트로 vault 안의 같은 문서 하나를 보고 일합니다. PM은 개발자용 스펙 문법을 몰라도 AKB에 쌓인 맥락을 근거로 이슈를 만들 수 있고, 개발자는 흩어진 배경 설명을 다시 캐지 않고 MCP로 가져가 개발합니다. 개발자와 PM 사이의 기술·언어 장벽이 에이전트를 거치며 줄어드는 걸 팀에서 직접 느끼고 있습니다.  
  
### 바로 둘러보기  
  
설치 없이 바로 둘러보려면 공개 데모([akb-demo.agent.seahorse.dnotitia.ai](https://akb-demo.agent.seahorse.dnotitia.ai))에 접속하시면 됩니다. (가입은 필요하지만 데모용이라 모든 데이터는 매주 초기화됩니다.)  
  
직접 돌려보고 싶으시면 아래처럼 Docker compose로 띄운 뒤 `localhost:3000`으로 접속하시면 됩니다. 임베딩 키가 없어도 키워드(BM25) 검색은 동작합니다.  
  
```bash  
git clone https://github.com/dnotitia/akb && cd akb  
cp config/app.yaml.example   config/app.yaml  
cp config/secret.yaml.example config/secret.yaml  
docker compose up -d  
```  
  
아직 부족한 점도 많습니다. 한 번 띄워보시고 버그나 이상한 점, 느낀 점은 댓글로 편하게 남겨주시면 감사하겠습니다.

## Comments



_No public comments on this page._