클로드 코드와 옵시디언을 활용한 개인 프로젝트 관리 시스템: 아키텍처와 질문

시스템 아키텍처 개요

한 개발자가 Claude Code와 Obsidian을 사용하여 전문적인 프로젝트 관리 방식을 개인 생활에 적용하는 개인 프로젝트 관리 시스템을 설계하고 있습니다. 이 시스템은 세 가지 계층으로 구성됩니다:

• 파일 시스템 (OneDrive): 기록용 파일만 저장합니다—PDF, 첨부 파일, 영수증. 실행 가능한 파일은 여기에 저장되지 않습니다.
• Obsidian 볼트: 지식 및 추적 계층 역할을 합니다. 모든 프로젝트 로그, 계획, 대시보드, 일일 노트가 여기에 저장됩니다.
• Claude Code: 콘텐츠를 읽고, 라우팅하고, 작성하는 수집 엔진 역할을 합니다. 이 계층의 대부분은 수동 개입 없이 작동합니다.

두 Claude 설정 및 작업 전환

개발자는 빌딩용으로 노트북에서 Claude Code를, 계획, 초안 작성, 모바일 캡처용으로 휴대폰에서 Claude.ai를 사용합니다. 컨텍스트 격차를 해소하기 위해 볼트 내 단일 마크다운 파일인 작업 전환 문서가 전체 아키텍처를 설명하며, 여기에는 폴더 구조, 라우팅 규칙, 명명 규칙, 활성 프로젝트 상태, 빌드 단계 진행 상황이 포함됩니다. Claude.ai는 모든 세션 시작 시 이 문서를 로드하여 일관성을 유지하며, 문서화된 규칙 외부의 폴더 경로나 파일 이름을 제안하지 않도록 합니다. Claude.ai는 설계사무실 역할을 하고, Claude Code는 시공팀 역할을 합니다.

일일 로그 및 명령어 구조

모든 입력은 평문으로 작성된 단일 일일 로그 파일을 통해 흐릅니다. Claude Code는 이 로그를 처리하고 항목을 적절한 위치로 라우팅합니다: 위험은 위험 등록부로, 결정은 결정 로그로, 작업은 실행 중인 작업 목록으로, 차단 요소는 플래그가 지정됩니다. 두 개의 슬래시 명령어가 시스템을 구동합니다:

• /daily: 당일 로그를 처리하고, 항목을 라우팅하며, 프로젝트 파일을 업데이트하고, 작업 목록을 업데이트합니다. 슬라이드나 이메일 없이—라우팅만 수행합니다.
• /pm-sync: 더 무거운 작업을 수행합니다—모든 프로젝트 파일을 읽고, 업데이트를 작성하며, 상태 이메일 초안을 작성하고, 주간 슬라이드 콘텐츠를 생성하며, 마스터 대시보드를 업데이트합니다.

프로젝트 구조 및 거버넌스

각 프로젝트에는 복잡성에 따라 세 가지 계층으로 구성된 파일 세트가 포함됩니다: 경량 (index.md 및 milestones.md), 중간 (risks.md 및 decisions.md 추가), 중량 (전체 세트). Claude는 새 프로젝트가 로깅될 때 인테이크 질문을 통해 계층을 결정합니다. 주요 파일은 다음과 같습니다:

• index.md: 건강 상태, 단계, 종료 기준, 이해관계자가 포함된 현재 상태 스냅샷.
• log.md: 일별 추적을 위한 연대기적 저널로, 컨텍스트 복구를 위한 ADHD 적응 수단 역할을 합니다.
• 구조화된 로그: milestones.md, risks.md, decisions.md, issues.md, assumptions.md, lessons-learned.md.

거버넌스 기능은 다음과 같습니다: Claude는 마일스톤을 자동으로 종료하지 않습니다—플래그를 지정하고 "I Approve [ID]"를 통한 명시적 승인을 기다립니다. 범위 확대는 작업이 프로젝트의 종료 기준을 넘어 확장되면 자동으로 플래그가 지정되며, 별도의 프로젝트로 분리하도록 제안합니다. 일일 로그에 캡처된 새 프로젝트 아이디어는 빌딩 시작 전 5개 질문 인테이크 프로세스를 트리거합니다.

도메인 대 프로젝트 구분

시스템은 프로젝트와 지속적인 도메인(예: 예산 책정, 피트니스 추적, 가정 유지 관리)을 구분합니다. 도메인은 프로젝트 로그 대신 추적기 파일과 노트를 받아, 에스프레소 머신 탈스케일링 일정과 같은 일상 작업에 대해 위험 등록부가 생성되지 않도록 합니다.

피드백을 위한 개발자 질문

개발자는 다음에 대한 의견을 구합니다:

1. 두 명령어 구조(/daily 및 /pm-sync)가 합리적인지, 아니면 라우팅을 과도하게 복잡하게 만드는지.
2. log.md를 구조화된 로그와 별도의 연대기적 저널로 사용하는 것—시간이 지나도 유지되는지, 아니면 노이즈가 되는지.
3. 마일스톤 종료를 위해 명시적 승인을 요구하는 제어 게이트 패턴—유용한 마찰인지, 아니면 단순한 마찰인지.
4. 모바일/데스크톱 컨텍스트를 위한 브리지 역할을 하는 공유 작업 전환 문서를 사용한 두 Claude 설정—다른 사람들도 이 격차를 비슷하게 해결하고 있는지.
5. Obsidian + Claude Code를 함께 실행한 경험—무엇이 고장났는지.