Document · 클로즈드 베타

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

내 Git 저장소의 마크다운을 읽고 편집하세요. 에이전트의 접근 범위를 정하고 제안된 변경을 검토할 수 있습니다.

  • 오픈소스
  • 셀프 호스팅
  • MCP 연결
이용 문의
작동하는 모습 보기

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

handbook / how-we-work.md

우리가 일하는 방식

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

핸드북마크다운Git 기반

결정 기록하기

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

찾기 쉽게 정리하기

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

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

Document · 협업의 구체적인 예

초안은 맡기고, 결정은 사람이 검토하세요.

팀은 안내형 설정보다 실제로 쓸 수 있는 예시를 선택한 이유를 남기려 합니다. Ada는 노트를 Document에 가져와 짧은 결정 기록을 요청합니다.

나의 요청
이 노트로 결정 기록을 작성해 주세요. 두 대안과 판단의 이유, 아직 확인해야 할 내용을 남겨 주세요.

01 · 에이전트의 기여

제안 권한이 있는 에이전트는 브랜치에서 Markdown 변경을 제안할 수 있습니다. 초안은 근거와 다음 단계를 정리하며, 검토 없이 확정된 페이지가 되지 않습니다.

02 · 사람이 검토하고 결정

Ada는 차이를 읽고 선택이 여전히 실험으로 설명되는지 확인한 뒤, 결정을 잘 담았다면 제안을 병합합니다. 사람도 직접 편집을 이어 갈 수 있고, 파일 기록으로 변경을 검토할 수 있습니다.

남는 결과사람과 에이전트가 다시 참고할 수 있는, 근거와 열린 질문이 남은 결정 기록.

Document — 사람과 에이전트가 다시 참고할 수 있는, 근거와 열린 질문이 남은 결정 기록.
협업을 설명하는 예시 · 실제 화면과 샘플 콘텐츠
핸드북 읽기

이용 문의

Hanji를 함께 사용해 보세요

Mac 데스크톱 프리뷰는 초대로 제공됩니다. 공개 바이너리 다운로드는 아직 없습니다. AI는 선택 사항이며 제공업체 계정은 별도로 관리합니다.

입력한 정보는 문의에 답변하는 데 사용됩니다. 문의는 FormSubmit을 통해 처리됩니다.

공개 핸드북 둘러보기 데스크톱 설정 가이드 (영어)
이미 이용 중이신가요? 설정 안내
  1. 준비 사항

    기존 Document 소스, 최신 Node.js, pnpm, Git, C 빌드 도구와 Markdown 폴더가 필요합니다. 읽기와 편집에는 모델 계정이 필요하지 않습니다.

  2. 로컬 설정

    소스 폴더에서 의존성을 설치하고 웹 앱을 시작하세요. localhost:4100을 엽니다.

    pnpm install
    pnpm dev:web
  3. 첫 작업

    워크스페이스 이름과 제품을 정하고 새로 시작하면 Hanji가 폴더를 준비합니다. 기존 콘텐츠는 설정 중이나 나중에 연결할 수 있습니다.

  4. 에이전트 연결

    Conductor는 세 제품을 이어주는 지속적인 대화입니다. 페이지, 이슈 또는 선택한 캔버스 오브젝트를 맥락에 담고, 요청한 변경을 검토하며 지원되는 변경은 되돌릴 수 있습니다. 자신의 Claude 또는 Codex 환경을 연결하세요.

자세한 설정 보기

마크다운 편집기

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

문서의 나머지 부분을 다시 쓰지 않고 필요한 부분만 수정합니다.

내가 고친 곳decisions.md

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

단어 하나를 바꾸고 저장.

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

Ada · decisions.md 수정

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

에이전트의 수정 제안

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

에이전트는 브랜치에 수정안을 제안합니다. 브랜치의 변경 내용을 검토한 뒤 병합하세요. 병합하기 전에는 페이지에 반영되지 않습니다.

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

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

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

모델에 의존하지 않는 도구

자체 AI 사용량 과금 없음
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에게는 페이지 네 개가 모두 보입니다.

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

댓글과 변경 이력

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

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

핸드북에서

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

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

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

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

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

사람 에이전트
8주 전오늘

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

도구 비교

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

각 도구가 지원하도록 설계된 작업 방식을 비교하세요.

토대부터 다릅니다.

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

팀에 맞는 작업 방식을 선택하세요.

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

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

배포

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

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

클로즈드 베타
01혼자, 로컬에서

Hanji Document를 실행하고 작업 공간의 이름과 소유자 비밀번호를 설정한 다음, 마크다운 파일이 있는 폴더를 선택하세요.

Mac 데스크톱 프리뷰는 초대로 제공됩니다. 공개 바이너리 다운로드는 아직 없습니다. AI는 선택 사항이며 제공업체 계정은 별도로 관리합니다.

# 기존 소스 체크아웃에서 실행
pnpm install && pnpm dev:web
Document 설치 안내
02팀과 함께, 테일넷에서

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

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

MCP 또는 HTTP로 에이전트의 읽기 권한 범위를 지정하세요. 제안된 편집은 브랜치에 저장되며, 검토 후 병합할 수 있습니다.

pnpm hanji token my-claude notes=read+propose
# 발급된 토큰으로 에이전트를 연결하세요.
에이전트 접근 설정
04웹에 공개하기

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

pnpm hanji rule handbook everyone-read
pnpm hanji export ./site
선택한 콘텐츠 게시

출시 소식

개발 소식을 받아보세요.
새로운 출시 소식까지.

개발 진행 상황과 출시 소식을 비정기적으로 전해드립니다.

일 년에 몇 차례 발송하며, 언제든 구독을 해지할 수 있습니다.

Document 핸드북 읽기