비고: Claude 코드 워크플로우용 마크다운 주석 도구

Remark의 기능

Remark은 Claude Code를 사용할 때 발생하는 특정 마찰점을 해결합니다: 스펙이나 지시 파일을 검토하고 에이전트에 피드백을 남기는 작업입니다. 개발자는 채팅에 메모를 붙여넣는 것이 피드백을 파일에서 분리시키고, 마크다운에 직접 메모를 남기는 것은 에이전트가 이를 내용으로 읽거나 제거하기 때문에 지저분하다는 점을 발견했습니다.

주요 기능과 명령어

이 도구는 다음과 같은 특정 기능을 가진 네이티브 macOS 애플리케이션입니다:

• 섹션을 강조 표시하고 댓글을 추가하여 모든 Markdown 파일에 인라인 주석 달기
• remark export file.md로 주석 내보내기 - 이는 정확히 무엇이 표시되었는지, 파일 내 위치, 주변 컨텍스트를 포함하는 JSON 목록을 생성합니다
• remark resolve로 해결된 주석 지우기
• 로컬 전용 작동 - 어떤 것도 사용자의 기기를 떠나지 않습니다

Claude Code 통합

Claude Code 통합은 스킬 시스템을 통해 작동합니다:

• remark install-skill을 실행하여 .claude/skills/ 디렉토리에 스킬 설치
• 이 스킬은 주석 형식, 내보내기 읽는 방법, 주석을 해결된 것으로 표시하는 방법, 검토 후 파일이 변경되었을 때 부분 일치 처리 방법을 포함합니다

기술적 세부사항

이 도구는 Claude Code로 구축되었으며, 대부분의 Rust 백엔드와 재앵커링 알고리즘을 작성했습니다. macOS에서 7일 무료 평가판 후 $17 일회성 구매로 이용 가능합니다. 설치 옵션은 다음과 같습니다:

• getremark.app에서 직접 다운로드
• Homebrew: brew install mfreiwald/tap/remark

이러한 유형의 도구는 Claude Code 지시 파일을 정기적으로 검토하고 피드백을 제공하는 개발자에게 유용하며, 실제 검토 중인 파일 내에서 피드백 컨텍스트를 유지하는 구조화된 방법을 제공합니다.