Hanji
시스템English한국어Deutsch日本語Français

Write · 클로즈드 베타

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

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

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

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

handbook / how-we-work.md

우리가 일하는 방식

Ada · 오늘 수정

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

핸드북마크다운Git 기반

결정 기록하기

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

찾기 쉽게 정리하기

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

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

이용 문의

Hanji를 함께 사용해 보세요

Write는 클로즈드 베타 단계로, 요청을 통해 이용할 수 있습니다. 어떻게 사용하고 싶은지 알려 주세요. 핸드북은 누구나 읽을 수 있습니다.

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

공개 핸드북 둘러보기
이미 이용 중이신가요? 설정 안내

  1. 준비 사항

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

  2. 로컬 설정

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

    pnpm install
pnpm dev:web

  3. 첫 작업

    공간 이름, 소유자 비밀번호, Markdown 폴더를 정하세요. 페이지 하나를 수정하고 Update를 누르면 첫 변경이 Git에 저장됩니다.

  4. 에이전트 연결

    필요할 때 범위가 지정된 토큰으로 코딩 에이전트를 연결하세요. 에이전트 계정이나 구독은 별도로 관리됩니다. 연결 방법은 아래 배포 옵션에서 확인할 수 있습니다.

자세한 설정 보기

마크다운 편집기

마크다운을 편집하고
변경만 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 Write 안에서만 적용되는 권한입니다. 저장소 접근 권한이 있으면 원본 파일은 읽을 수 있습니다.

댓글과 변경 이력

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

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

핸드북에서

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

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

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

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

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

사람 에이전트
8주 전오늘

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

도구 비교

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

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

토대부터 다릅니다.

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

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

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

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

배포

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

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

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

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

Write는 클로즈드 베타 단계로, 요청을 통해 이용할 수 있습니다. 어떻게 사용하고 싶은지 알려 주세요. 핸드북은 누구나 읽을 수 있습니다.

# 기존 소스 체크아웃에서 실행
pnpm install && pnpm dev:web
Write 설치 안내
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
선택한 콘텐츠 게시

출시 소식

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

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

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

Write 핸드북 읽기