md_manage

프로젝트 개요

코드 자체는 보안 문제로 AI(Claude)에게 공유할 수 없는 프로젝트에서, 프로젝트 구조 / 기능 명세 / 개발해야 할 목록 / 개발 이력과 같은 정보를 마크다운 문서로 정리하고 관리하는 데스크톱 앱.

Claude와 연동하여 현재 기능 현황을 파악하고, 신규 개발 또는 수정이 필요한 항목과 그 진행 상황을 마크다운 문서에 기록하는 것을 목표로 한다.

• 플랫폼: Windows 우선 개발, 추후 macOS 지원
• 형태: 데스크톱 앱 (Electron / Tauri 등 후보, 기술 스택 추후 확정)

주요 기능

• 프로젝트 등록
  • 폴더를 선택하여 프로젝트로 등록
  • 선택한 폴더에 README.md가 없으면 새로 생성, 있으면 해당 README를 기준으로 초기 프로젝트 문서 구조를 불러옴
• 프로젝트 문서 템플릿 관리 (기능 명세, 개발 목록, 파일 구조, 변경 이력 등 마크다운 문서)
• Claude 연동을 통한 문서 자동 작성/갱신
  • 현재 기능 구현 현황 기록
  • 신규 개발 / 수정 개발 목록 및 진행 상황 기록
• Claude 채팅
  • 프로젝트(폴더)별로 독립된 대화창과 채팅 이력을 가짐
  • API 키는 앱 전체에서 공통으로 사용하며, 사용자가 언제든지 등록/변경 가능
  • 모든 프로젝트가 동일한 키의 사용량/한도를 공유
• ToDo 관리
  • 개발/수정이 필요한 항목은 README가 아닌 별도의 ToDo 문서에 기록
  • 각 ToDo 항목은 관련 마크다운 문서 및 위치와 연결되어, 선택 시 해당 문서의 해당 부분으로 포커스 이동
  • 수정 사유 등 작업 이력은 ToDo 문서가 아닌 관련 문서 템플릿(변경 이력 등)에 기록하고, ToDo 화면에는 해당 내용을 표시만 함
  • "완료" 체크 시 관련 문서에 작업 이력 기록, 다시 체크 해제 시 해당 이력을 원복(제거)
• 사용량 관리
  • Anthropic API 키 등록이 필수이며, 등록한 계정의 크레딧/한도만큼 이용 가능
  • 앱 자체에서 제공하는 무료 사용량은 없음
• 로컬 파일 접근 제한
  • 프로젝트로 등록한 폴더 내부로만 접근 가능 (폴더 외부 접근 불가)
  • 폴더 내에서도 마크다운(.md) 파일만 읽기/쓰기 가능
  • 마크다운 문서에서 참조하는 이미지 등 첨부파일은 파일 목록에 표시되지만 수정은 불가 (읽기 전용)
  • 첨부파일은 더블클릭하거나 마크다운 내 링크를 클릭하면 열람 가능

파일 구조

개발이 진행되면서 실제 구조에 맞게 업데이트 예정

(아직 작성된 코드 없음)

화면 구성

개발이 진행되면서 실제 UI에 맞게 업데이트 예정

전체 레이아웃은 VSCode처럼 탭 기반이며, 사용자가 화면 배치를 자유롭게 조정할 수 있다. 단, "프로젝트 파일 구성 화면"은 좌측 또는 우측에 고정되는 Dock 형태로 제공된다.

• 프로젝트 파일 구성 화면 (Dock, 좌/우 고정): 마크다운 문서가 참조하는 .md 파일 및 첨부파일로 구성된 파일 트리, "프로젝트 등록" 버튼 (폴더 선택 → README.md 자동 생성/로드)
• 메인 화면: 프로젝트 문서 목록/탐색
• 마크다운 편집기 화면
• ToDo List 화면: 등록된 ToDo 항목을 체크박스로 확인, 항목 선택 시 관련 문서의 해당 위치로 포커스 이동
• Claude 채팅 화면: 프로젝트별 Claude 대화창 및 채팅 이력 표시 (API 키 미등록 시 초기 화면으로 등록 안내 표시, 이후에도 설정에서 키 변경 가능)
• 문서 자동 작성/갱신 실행 화면

업데이트 예정 기능

• 마크다운 편집/뷰어 기본 화면
• 프로젝트 문서 템플릿 생성 (기능 명세 / 개발 목록 / 파일 구조 / 변경 이력)
• 프로젝트 폴더 기반 파일 접근 샌드박스 (.md 파일 + 참조 첨부파일만 접근)
• 프로젝트 파일 구성 화면 (마크다운 참조 기반 파일 트리 + 프로젝트 등록 버튼)
• 첨부파일 읽기 전용 열람 기능 (더블클릭/마크다운 클릭 시 열기, 수정 불가)
• ToDo 관리 기능 (별도 문서 기록, 관련 문서 포커스 이동)
• ToDo List 체크박스 화면 구현 (완료 체크 시 관련 문서에 작업 이력 기록, 체크 해제 시 이력 원복)
• Claude 채팅 화면 (프로젝트별 대화/이력, API 키 등록·변경 화면 포함)
• Claude 연동 문서 자동 작성/갱신 기능
• 자유 배치 가능한 탭 기반 레이아웃 (프로젝트 파일 구성 화면은 Dock 좌/우 고정)
• macOS 빌드 지원

버전 수정 내역

(아직 배포된 버전 없음)