한지

종이처럼 가벼운 문서 도구

에이전트는 이미 Git에서 일합니다이제 지식도 그곳에서

마크다운을 쓰고 검색하세요. 에이전트의 수정을 검토하세요. 파일은 내 Git 저장소에 그대로.

  • 오픈소스
  • 셀프 호스팅
  • MCP 연결
핸드북 읽기
작동하는 모습 보기

읽고, 검토하고, 반영하기

handbook / how-we-work.md

우리가 일하는 방식

Ada · 오늘 수정

제품 결정, 프로젝트 노트, 팀 가이드를 모아 둔 핸드북입니다.

핸드북마크다운Git 기반

결정 기록하기

  • 문제와 검토한 선택지를 적습니다.
  • 담당자와 다음 단계를 정합니다.

찾기 쉽게 정리하기

새 가이드를 핸드북에 연결합니다.

작동 예시 · 제안을 반영해 보세요⑂ main · handbook/how-we-work.md

마크다운 편집기

마크다운을 편집하고
변경만 Git에 기록하세요

단어 하나를 고치면 diff도 한 줄. 나머지는 그대로.

내가 고친 곳decisions.md

다음 필요한 문서를
쉽게 찾을 수 있게 합니다.

단어 하나를 바꾸고 저장.

GIT에 남는 것+1 −1
− 다음 문서를 쉽게 찾을 수 있게 합니다.
+ 필요한 문서를 쉽게 찾을 수 있게 합니다.

Ada · decisions.md 수정

고쳐도 바이트는 그대로인 이유

에이전트의 수정 제안

변경 내용을 검토하고
반영할지 정하세요

에이전트는 무엇을 왜 고칠지 적어 제안합니다. 내용을 확인한 뒤 페이지에 반영하세요.

claude리뷰 담당자 명확히 하기+2 −0

사고 리뷰마다 담당자가 분명해지도록 한 줄 넣었습니다.

+ ## 리뷰 담당자+ 사고 대응 담당자가 리뷰를 작성하고 팀에 공유합니다.

넣지 않은 의존성

미터기는 돌지 않습니다
0

에이전트를 위해 만들고
에이전트 없이도 돌아갑니다

에이전트는 반가운 손님이지, 한지가 돌아가기 위한 조건이 아닙니다. 설치할 때 API 키를 묻지 않습니다. 설정에 모델 고르는 칸도 없습니다. 토큰이 떨어졌다고 멈추는 일도 없습니다.

애초에 토큰이 없으니까요.

0 내장 모델0 AI 크레딧100% 내 마크다운
이 페이지를 읽는 에이전트에게텍스트가 편하다면, 여기에도 준비해 두었습니다.llms.txt

접근 권한

사람과 에이전트의
접근 범위를 정하세요

사람에게도 에이전트에게도, 비공개는 비공개로.

독자를 바꿔 보세요. 보이는 것도 달라집니다.

작업 노트 / 페이지4개 표시
우리가 일하는 방식handbook / how-we-work.md모두
아키텍처engineering / architecture.md팀 + 에이전트
다음 이야기planning / next-chapter.mdAda + Remy
아직 다듬는 중private / rough-thoughts.mdAda만

소유자인 Ada에게는 페이지 네 개가 모두 보입니다.

한지 안에서만 적용되는 권한입니다. 저장소 접근 권한이 있으면 원본 파일은 읽을 수 있습니다.

댓글과 변경 이력

변경을 논의하고
누가 고쳤는지 보세요

여백에는 대화를. 기록에는 이름을.

핸드북에서

여백의 메모를 열어 보세요.

대화는 여백에.
기록에는 글만.

댓글은 git에 섞이지 않습니다. 에이전트는 허용했을 때만 읽습니다.

대화가 머무를 작은 자리
남아 있는 기록

위에는 사람. 아래에는 에이전트. 8주치 기록.

사람 에이전트
8주 전오늘

조용한 날에는 아무것도 쓰지 않습니다.

도구 비교

지식을 관리하는 방식에
맞는 도구를 고르세요

도구마다 맡은 일이 다릅니다. 우리 팀에 맞는 걸 고르세요.

토대부터 다릅니다.

도구 다섯 가지 / 서로 다른 역할
무엇이
중요한가요?		한지내 지식, 내 GitObsidian개인 지식 보관함Notion하나로 모은 워크스페이스Confluence팀 위키 · 클라우드GitBook문서 사이트
주된 용도팀과 팀의 에이전트개인 지식 관리문서 + 프로젝트 + 데이터베이스Atlassian을 사용하는 팀외부에 공개할 문서
콘텐츠 형태마크다운 파일마크다운 파일페이지 + 데이터베이스페이지 + 스페이스문서 + 선택적 Git Sync
Git의 역할원본이자 기준직접 구성하는 작업 흐름마크다운으로 내보내기콘텐츠 내보내기저장소와 양방향 동기화
에이전트 접근범위를 정한 MCP편집은 git diff로 제안로컬 파일도구 연결은 직접 구성Notion MCP외부 어시스턴트 연결Rovo MCP외부 어시스턴트 연결공개 사이트 MCP에이전트가 읽는 문서
알아둘 점초기 단계. 직접 운영.SSO와 호스팅은 아직 준비 중공유 보관함, 같은 접근 권한.Sync에는 페이지별 권한 없음작업 공간은 Notion.마크다운은 내보내기 형식작업 공간은 Confluence.마크다운 저장소가 아님게시가 중심.한지와는 초점이 다름

당신의 파일. 당신의 에이전트. 결정도 당신이.

나에게 맞는지 살펴보기
출처와 비교 범위 2026년 9월 9일 확인

아래 공식 문서를 보고 어떤 도구가 어디에 맞는지 정리했습니다. Confluence는 Cloud 기준입니다. 기능과 접근 범위는 요금제와 설정에 따라 달라집니다. 확장 기능을 붙이면 다른 방식으로도 쓸 수 있습니다.

배포

로컬에서 실행하고
필요한 만큼 공유하세요

로컬에서. 팀과 함께. 웹으로. 고르는 건 내 몫.

네 가지 모두 첫 버전에 들어갑니다.
01혼자, 로컬에서

한지를 열면 시작 화면이 안내합니다. 공간의 이름, 비밀번호, 마크다운 폴더만 정하면 됩니다.

# 출시와 함께 공개됩니다:
git clone https://github.com/gethanji/hanji
pnpm install && pnpm dev:web
5분 만에 시작하기
02팀과 함께, 테일넷에서

네트워크가 사용자를 알아보는 공유 인스턴스입니다. 아무도 비밀번호를 입력하지 않습니다. 정해 둔 권한은 그대로입니다.

export HANJI_TAILSCALE_OWNER=you@github
next start -H 127.0.0.1 -p 4100
tailscale serve --bg 4100
테일넷에서 운영하기
03코딩 에이전트와 함께

MCP나 일반 HTTP로 허용된 범위만 읽습니다. curl을 쓰는 bash 스크립트도 에이전트가 될 수 있습니다. 수정은 검토할 수 있는 제안 형태로 들어옵니다.

pnpm hanji token my-claude notes=read+propose
# 발급된 토큰으로 에이전트를 연결하세요.
에이전트에게 열쇠 건네기
04웹에 공개하기

모두에게 공개한 콘텐츠를 정적 웹사이트로 내보냅니다. 마크다운 사본과 llms.txt도 함께. 이 핸드북도 같은 방식으로 게시했습니다.

pnpm hanji rule handbook everyone-read
pnpm hanji export ./site
일부를 세상에 공개하기

출시 소식

출시 소식을 받고
나오는 날 시작하세요

만들어 가는 과정을 지켜봐 주세요. 코드를 직접 실행할 수 있는 날, 알려드리겠습니다.

일 년에 몇 통. 새로 만든 것, 배운 것, 한지가 준비되는 날의 소식. 언제든 구독을 해지할 수 있습니다.

그동안 읽을 이야기도 많습니다