garden-md

garden-md란?

garden-md는 회의록(및 관련 노트)을 구조화된 연결된 회사 지식 베이스로 변환하는 명령줄 도구입니다. 로컬에 저장된 마크다운 파일에서 Wikipedia 스타일의 HTML 위키를 생성하여 조직의 사람, 회사, 제품/도구 및 문서 전반에 걸친 언급 사항을 탐색할 수 있습니다.

핵심 목적은 산재된 회의록 자료를 탐색 가능한 형식으로 정리하는 데 도움을 주면서 원본 회의록을 그대로 유지(재작성 또는 요약하지 않음)하는 것입니다. 지원 서비스에서 데이터를 동기화하고, 엔티티를 추출하며, 언급 사항을 연결하고, 결과 위키를 브라우저에서 열 수 있습니다.

주요 기능

• 다중 소스에서 회의록 동기화 (로컬 스테이징 + 로컬 위키): garden sync를 실행하여 Grain, Granola, Fireflies.ai 또는 API 기반 “Other” 커넥터에서 새로운 회의록을 로컬 스테이징 영역으로 가져옵니다.
• 문서 전반 엔티티 추출: garden tend 중에 사람, 회사, 제품/도구 등의 엔티티를 추출하여 위키 페이지를 구성합니다.
• 마크다운으로 연결된 탐색 가능 위키 페이지: 출력은 기존 또는 새로운 엔티티를 참조하는 문서가 늘어날수록 성장하는 연결된 .md 파일로 구성됩니다.
• Wikipedia 스타일 HTML 렌더링: garden open으로 탐색, 검색, 백링크가 포함된 HTML 위키를 생성하고 제공합니다.
• 로컬 우선 작동: 위키는 클라우드 데이터베이스가 아닌 로컬 마크다운 파일 폴더로 저장됩니다.
• 선택적 git 통합 / 자동 커밋: garden init으로 git을 활성화할 수 있으며, 위키를 설정에 따라 자동 커밋으로 업데이트할 수 있습니다.
• 커스텀 서비스를 위한 커넥터 접근 + 검토: 내장 커넥터는 사전 구축 및 테스트됨; “Other”의 경우 실행 전에 검토할 수 있는 커넥터 스크립트를 AI가 생성합니다.
• 명확한 비목표 (회의록 보존): 콘텐츠를 재작성하거나 요약하지 않습니다; 소스 문서에서 회의록이 그대로 유지됩니다.

garden-md 사용 방법

1. 설치 및 필수 조건: npm install -g garden-md로 설치하세요. **Node.js 18+**와 지원 AI 제공자의 API 키가 필요합니다.
2. 위키 초기화: garden init을 실행하여 AI 제공자를 선택하고, 위키 위치를 설정하며, 선택적으로 git을 활성화하세요.
3. 데이터 소스 연결: garden connect를 실행하고 서비스—Grain, Granola, Fireflies.ai, 또는 Other—를 선택하여 동기화를 설정하세요. “Other”의 경우 서비스 이름과 API 문서 URL을 제공하세요.
4. 새 회의록 동기화: garden sync를 실행하여 스테이징 영역(데모 출력에서 “wildland”으로 표시)으로 새 회의록을 가져옵니다.
5. 위키로 처리: garden tend를 실행하여 엔티티를 추출하고 스텁 페이지를 생성하며 연결된 마크다운/위키 구조를 만듭니다; 그 후 garden open으로 생성된 HTML 위키를 탐색하세요.

일반 명령어: garden connect --repair (손상된 커넥터 수리), garden sync --schedule (cron 기반 자동 동기화), garden tend / garden open (처리 및 탐색).

사용 사례

• 회의록을 검색 가능한 내부 위키로 변환: 회의 노트/회의록 소스에서 동기화 후 garden tend를 실행하여 엔티티 페이지와 백링크를 생성하면 팀원이 사람, 회사 또는 제품/도구별로 회사 지식을 탐색할 수 있습니다.
• 원본 자료로 뒷받침되는 “회사 두뇌” 유지: garden-md가 재작성/요약을 피하므로 팀은 원본 회의록 콘텐츠에 의존하면서도 구조화된 위키 레이어를 활용할 수 있습니다.
• 새 회의 도착 시 위키 페이지 지속 업데이트: garden sync(선택적으로 --schedule 사용)로 새 회의록을 가져온 후 garden tend를 다시 실행하여 위키가 성장하고 연결이 확장되도록 합니다.
• 공통 탐색 레이어로 팀 또는 이해관계자 온보딩: garden open으로 사이드바 탐색과 검색이 포함된 HTML 위키를 탐색하여 여러 회의록에서 관련 언급을 쉽게 찾을 수 있습니다.
• API를 통한 커스텀 회의록 소스 통합: garden connect에서 “Other”를 선택하고 API 문서를 제공하세요; 도구가 실행 전에 검토할 수 있는 커넥터 스크립트를 생성합니다.

자주 묻는 질문

• garden-md가 회의록을 재작성하거나 요약하나요? 아니요. garden-md는 회의록을 그대로 유지합니다(콘텐츠를 재작성하거나 요약하지 않습니다).

• 위키는 어디에 저장되나요? 로컬 마크다운 파일(.md 파일 폴더)로 기기에 저장됩니다; 데이터베이스나 클라우드 스토리지가 필요 없습니다.

• 어떤 서비스가 기본 지원되나요? 저장소에 Grain, Granola, Fireflies.ai에 대한 내장 테스트 커넥터가 나열됩니다. 다른 서비스는 API 문서와 함께 “Other”를 사용할 수 있습니다.

• garden tend와 garden open은 무엇을 하나요? garden tend는 스테이징 영역에서 읽고, AI 제공자로 콘텐츠를 보내 엔티티를 추출하며 연결된 마크다운 위키를 업데이트합니다. garden open은 HTML 위키를 렌더링하고 탐색을 위해 제공합니다.

• 필수 조건은 무엇인가요? README에 Node.js **18+**가 필요하며, 지원 AI 제공자의 API 키가 필요하다고 명시되어 있습니다.

대안

• 마크다운 + 스크립트로 위키 수동 구축: 기본적인 정리만 필요하다면 AI 기반 엔티티 추출과 HTML 렌더링 워크플로 없이 직접 마크다운 페이지를 생성하고 링크할 수 있습니다.
• 임포트 파이프라인을 가진 문서/위키 플랫폼 사용: 범용 지식 베이스는 문서를 저장하고 검색할 수 있지만, garden-md는 회의록에서 위키피디아 스타일의 상호 링크된 엔티티 페이지를 생성하므로 워크플로가 다릅니다.
• 지식 베이스가 있는 회의록 요약 도구: 일부 도구는 회의록을 요약하고 요약본을 인덱싱하는 데 초점을 맞춥니다. garden-md는 원본 텍스트를 보존하고 구조화된 엔티티 링크를 구축하므로 콘텐츠를 요약으로 대체하지 않습니다.
• 커스텀 ETL 파이프라인 (동기화 → 파싱 → 인덱싱): 엔지니어링 지원이 이미 있는 팀이라면 자체 도구와 스토리지를 사용해 “동기화 + 엔티티 추출 + 링킹” 패턴을 재현할 수 있으며, garden-md의 명령 세트와 위키 렌더러 대신 사용할 수 있습니다.