우리가 일하는 방식
제품 결정, 프로젝트 노트, 팀 가이드를 모아 둔 핸드북입니다.
결정 기록하기
- 문제와 검토한 선택지를 적습니다.
- 담당자와 다음 단계를 정합니다.
찾기 쉽게 정리하기
새 가이드를 핸드북에 연결합니다.
다음 사람이 시작할 자리를 남깁니다.
제품 결정, 프로젝트 노트, 팀 가이드를 모아 둔 핸드북입니다.
새 가이드를 핸드북에 연결합니다.
다음 사람이 시작할 자리를 남깁니다.
→ hanji_read handbook/how-we-work.md # 우리가 일하는 방식 제품 결정, 프로젝트 노트, 팀 가이드를 모아 둔 핸드북입니다. ## 결정 기록하기 - 문제와 검토한 선택지를 적습니다. - 담당자와 다음 단계를 정합니다. ## 찾기 쉽게 정리하기 새 가이드를 핸드북에 연결합니다. 다음 사람이 시작할 자리를 남깁니다.
일반 텍스트. 허용한 범위만.
Document · 협업의 구체적인 예
팀은 안내형 설정보다 실제로 쓸 수 있는 예시를 선택한 이유를 남기려 합니다. Ada는 노트를 Document에 가져와 짧은 결정 기록을 요청합니다.
이 노트로 결정 기록을 작성해 주세요. 두 대안과 판단의 이유, 아직 확인해야 할 내용을 남겨 주세요.
01 · 에이전트의 기여
제안 권한이 있는 에이전트는 브랜치에서 Markdown 변경을 제안할 수 있습니다. 초안은 근거와 다음 단계를 정리하며, 검토 없이 확정된 페이지가 되지 않습니다.
02 · 사람이 검토하고 결정
Ada는 차이를 읽고 선택이 여전히 실험으로 설명되는지 확인한 뒤, 결정을 잘 담았다면 제안을 병합합니다. 사람도 직접 편집을 이어 갈 수 있고, 파일 기록으로 변경을 검토할 수 있습니다.
남는 결과사람과 에이전트가 다시 참고할 수 있는, 근거와 열린 질문이 남은 결정 기록.

이용 문의
Mac 데스크톱 프리뷰는 초대로 제공됩니다. 공개 바이너리 다운로드는 아직 없습니다. AI는 선택 사항이며 제공업체 계정은 별도로 관리합니다.
공개 핸드북 둘러보기 데스크톱 설정 가이드 (영어)기존 Document 소스, 최신 Node.js, pnpm, Git, C 빌드 도구와 Markdown 폴더가 필요합니다. 읽기와 편집에는 모델 계정이 필요하지 않습니다.
소스 폴더에서 의존성을 설치하고 웹 앱을 시작하세요. localhost:4100을 엽니다.
pnpm install
pnpm dev:web워크스페이스 이름과 제품을 정하고 새로 시작하면 Hanji가 폴더를 준비합니다. 기존 콘텐츠는 설정 중이나 나중에 연결할 수 있습니다.
Conductor는 세 제품을 이어주는 지속적인 대화입니다. 페이지, 이슈 또는 선택한 캔버스 오브젝트를 맥락에 담고, 요청한 변경을 검토하며 지원되는 변경은 되돌릴 수 있습니다. 자신의 Claude 또는 Codex 환경을 연결하세요.
마크다운 편집기
문서의 나머지 부분을 다시 쓰지 않고 필요한 부분만 수정합니다.
다음 필요한 문서를
쉽게 찾을 수 있게 합니다.
단어 하나를 바꾸고 저장.
− 다음 문서를 쉽게 찾을 수 있게 합니다. + 필요한 문서를 쉽게 찾을 수 있게 합니다.
Ada · decisions.md 수정
에이전트의 수정 제안
에이전트는 브랜치에 수정안을 제안합니다. 브랜치의 변경 내용을 검토한 뒤 병합하세요. 병합하기 전에는 페이지에 반영되지 않습니다.
사고 리뷰마다 담당자가 분명해지도록 한 줄 넣었습니다.
모델에 의존하지 않는 도구
자체 AI 사용량 과금 없음문서를 읽고 편집하고 게시하는 데 모델 계정이나 API 키가 필요하지 않습니다. 필요할 때 내가 선택한 콘텐츠에만 접근할 수 있도록 에이전트를 연결하세요.
에이전트 구독이나 모델 사용 요금은 해당 제공업체에서 별도로 관리합니다.
댓글과 변경 이력
여백에는 대화를. 기록에는 이름을.
대화는 여백에.
기록에는 글만.
특히 그런 것들이요.
댓글은 git에 섞이지 않습니다. 에이전트는 허용했을 때만 읽습니다.
대화가 머무를 작은 자리위에는 사람. 아래에는 에이전트. 8주치 기록.
조용한 날에는 아무것도 쓰지 않습니다.
도구 비교
각 도구가 지원하도록 설계된 작업 방식을 비교하세요.
| 무엇이 중요한가요? | Obsidian개인 지식 보관함 | Notion하나로 모은 워크스페이스 | Confluence팀 위키 · 클라우드 | GitBook문서 사이트 | |
|---|---|---|---|---|---|
| 주된 용도 | 팀과 팀의 에이전트 | 개인 지식 관리 | 문서 + 프로젝트 + 데이터베이스 | Atlassian을 사용하는 팀 | 외부에 공개할 문서 |
| 콘텐츠 형태 | 마크다운 파일 | 마크다운 파일 | 페이지 + 데이터베이스 | 페이지 + 스페이스 | 문서 + 선택적 Git Sync |
| Git의 역할 | 원본이자 기준 | 직접 구성하는 작업 흐름 | 마크다운으로 내보내기 | 콘텐츠 내보내기 | 저장소와 양방향 동기화 |
| 에이전트 접근 | 범위를 정한 MCP편집은 git diff로 제안 | 로컬 파일도구 연결은 직접 구성 | Notion MCP외부 어시스턴트 연결 | Rovo MCP외부 어시스턴트 연결 | 공개 사이트 MCP에이전트가 읽는 문서 |
| 알아둘 점 | 초기 단계. 직접 운영.SSO와 호스팅은 아직 준비 중 | 공유 보관함, 같은 접근 권한.Sync에는 페이지별 권한 없음 | 작업 공간은 Notion.마크다운은 내보내기 형식 | 작업 공간은 Confluence.마크다운 저장소가 아님 | 게시가 중심.Hanji Document와는 초점이 다름 |
팀에 맞는 작업 방식을 선택하세요.
나에게 맞는지 살펴보기아래 공식 문서를 보고 어떤 도구가 어디에 맞는지 정리했습니다. Confluence는 Cloud 기준입니다. 기능과 접근 범위는 요금제와 설정에 따라 달라집니다. 확장 기능을 붙이면 다른 방식으로도 쓸 수 있습니다.
배포
로컬에서. 팀과 함께. 웹으로. 고르는 건 내 몫.
클로즈드 베타출시 소식
개발 진행 상황과 출시 소식을 비정기적으로 전해드립니다.
시도했지만 잘되지 않았던 것도요?