simon-md-reviewer

simon-md-reviewer

마크다운 파일을 에디터에서 열어 리뷰하고, 피드백을 Claude가 반영하는 리뷰 루프. 실행 환경에 따라 두 모드 중 하나로 동작한다:

• Orca 모드: Orca 터미널 세션 안에서 실행 중일 때. Orca 에디터에서 열고, 인라인 리뷰 노트("Send notes to an agent")로 피드백을 받는다. 문서가 코멘트 문법으로 오염되지 않고, 앱 전환이 없다.
• Obsidian 모드: 그 외. Obsidian에서 열고 %%코멘트%%로 피드백을 받는다.

두 에디터 모두 파일 시스템을 감시하므로, Claude가 MD를 수정하면 자동으로 다시 로드된다.

언제 사용하나

• MD 파일 경로를 직접 지정하며 "리뷰해줘", "열어줘"
• 세션에서 MD를 작성한 뒤 "이거 보면서 수정하자"
• 다른 스킬 밖에서 독립적으로 MD 리뷰가 필요할 때

다른 스킬(simon-study, simon-oncall, simon-report, simon)이 실행 중이고 해당 스킬 내부에 리뷰 Phase가 있다면, 그 스킬의 리뷰 루프를 따른다. 이 스킬은 독립 호출 전용이다.

모드 선택

if [ "$TERM_PROGRAM" = "Orca" ] && [ -n "$ORCA_WORKSPACE_ID" ]; then
  MODE=orca
else
  MODE=obsidian
fi

• 사용자가 "Obsidian으로 열어줘"라고 명시하면 Orca 안에서도 Obsidian 모드를 쓴다 (vault 백링크·그래프가 필요한 문서 등).
• Orca 모드는 Orca 터미널 세션 안에서만 성립한다. Orca 앱이 떠 있어도 이 세션이 Orca 밖이면 리뷰 노트가 이 에이전트에게 전송되지 않으므로 Obsidian 모드를 쓴다.

---

Phase 1: 대상 MD 파일 결정 (공통)

경우 A — 경로가 주어진 경우

사용자가 MD 파일 경로를 제공했으면 바로 Phase 2로 진행한다.

경우 B — 경로가 없는 경우

사용자에게 무엇을 MD로 작성할지 확인한다:

1. 세션 컨텍스트에서 생성: 대화 중 분석/정리한 내용을 MD로 구조화
2. 사용자가 내용 지시: "이 주제에 대해 정리해줘" → MD 작성

MD 작성 가이드라인:

• 한국어 작성, 기술 용어는 영어 병기
• Obsidian callout 활용 (아래 레퍼런스 참조)
• mermaid 다이어그램으로 복잡한 관계 시각화
• 섹션마다 핵심 메시지를 먼저, 상세 내용은 뒤에

작업 경로 (모드별)

모드	작업 경로	이유
Obsidian	~/claude-reports/{topic-slug}.md (vault)	Obsidian은 vault 내 파일만 연다
Orca	{워크스페이스 루트}/claude-reports/{topic-slug}.md	orca file open은 워크스페이스 상대경로만 허용 (절대경로 → invalid_relative_path 에러)

Orca 모드 세부:

• 리뷰 대상이 이미 워크스페이스 안에 있으면(레포 문서 등) 복사 없이 제자리에서 연다. 확정 후에도 제자리에 둔다.
• vault 파일이나 신규 보고서는 워크스페이스의 claude-reports/에 사본을 만들어 작업하고, 확정 시 vault로 이동한다 (Phase 4).
• claude-reports/ 생성 시 git 오염 방지를 위해 self-ignoring .gitignore를 함께 만든다:

WORKSPACE_ROOT=$(orca worktree current --json | python3 -c "import json,sys; print(json.load(sys.stdin)['result']['worktree']['path'])")
mkdir -p "$WORKSPACE_ROOT/claude-reports"
printf '*\n' > "$WORKSPACE_ROOT/claude-reports/.gitignore"