문서 첫걸음

이미 가지고 있는 문서를 바로 여세요.

설치부터 첫 활용까지, 짧고 명확한 안내.

이 가이드는 실질적인 첫 단계를 안내하며, 더 깊은 정보는 GitHub 저장소 문서로 연결됩니다.

01

웹 사이트 퀵 가이드

02

실제 저장소 문서 연결

03

독자 중심 온보딩

첫 번째 세션

폴더를 열고 리뷰어 관점에서 읽어보세요

KatanA는 기존 문서 환경이 있을 때 가치를 발휘합니다. 새로운 관리 체계를 강요하지 않습니다.

첫 5분

첫 5분 체크리스트

  • 실제 워크스페이스에서 README를 연다.
  • 아키텍처 스펙 파일 하나를 연다.
  • 다이어그램 많은 markdown 파일 하나를 연다.
  • TOC와 split preview 동작을 확인한다.
  • 업데이트 설정을 한 번 확인한다.

SDD 및 AI

SDD / AI 워크플로 노트

AI 에이전트에게 수정 지시 전, KatanA로 스펙을 먼저 읽고 검증하세요.

3분 만에 시작하기

  • Homebrew 또는 DMG를 통해 KatanA를 설치합니다.
  • 마크다운 문서가 포함된 폴더를 워크스페이스로 엽니다.
  • 수정하기 전, 문서를 읽고 다이어그램을 검토하는 데 KatanA를 사용하세요.

첫 워크스페이스 열기

문서를 열기 전 첫 실행 시의 탐색 흐름입니다.

빈 상태

비어 있는 워크스페이스 화면

아무것도 열리지 않았을 때도 명확한 '워크스페이스 열기' 버튼을 제공합니다.

메뉴 사용

메뉴 바를 통해 폴더 열기

네이티브 메뉴 시스템에서 파일 -> 워크스페이스 열기를 선택할 수 있습니다.

추천 초기 설정

가장 먼저 확인하면 좋은 테마, 레이아웃, 업데이트 관련 옵션입니다.

테마

다크 테마 & 실시간 미리보기

여러 테마 프리셋을 제공하며, 변경 사항을 즉시 앱에서 확인할 수 있습니다.

레이아웃

목차(TOC) 및 분할 방향

목차 노출 여부, 병렬 보기 방향(가로/세로), 창 순서를 구성합니다.

업데이트

스마트 업데이트 설정

자동 업데이트 확인 주기와 수동 확인 기능을 앱 내에서 관리하세요.

Shortcuts

키보드 단축키 설정

워크플로에 맞게 키보드 단축키를 자유롭게 사용자 지정할 수 있습니다.

무엇을 먼저 읽을까요?

  • README 파일을 통해 전체 프로젝트 맥락 파악.
  • 코드를 보기 전 ADR이나 명세서를 통해 설계 의도 이해.
  • 릴리스 노트를 통해 최근 변경 및 동작 사항 확인.

Support

KatanA 개발 지원

이 설치 명령이 도움이 되었다면 GitHub Star 또는 후원을 부탁드립니다.

How to star on GitHub