{"id":44858357,"url":"https://github.com/yeominux/md-feedback","last_synced_at":"2026-03-07T09:16:02.249Z","repository":{"id":338969889,"uuid":"1158330630","full_name":"yeominux/md-feedback","owner":"yeominux","description":"Plan review for AI coding — annotate markdown, let agents act via MCP. VS Code extension + MCP server.","archived":false,"fork":false,"pushed_at":"2026-02-20T10:09:37.000Z","size":11106,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-20T13:32:40.804Z","etag":null,"topics":["ai-agent","ai-coding","claude-code","copilot","cursor-ai","developer-tools","markdown-annotation","mcp-server","plan-review","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yeominux.png","metadata":{"files":{"readme":"README.ko.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-15T07:10:07.000Z","updated_at":"2026-02-20T08:49:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"68d8e798-e00e-4c60-aecf-618e05577fed","html_url":"https://github.com/yeominux/md-feedback","commit_stats":null,"previous_names":["yeominux/md-feedback"],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/yeominux/md-feedback","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeominux%2Fmd-feedback","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeominux%2Fmd-feedback/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeominux%2Fmd-feedback/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeominux%2Fmd-feedback/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yeominux","download_url":"https://codeload.github.com/yeominux/md-feedback/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeominux%2Fmd-feedback/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29680147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T11:29:27.227Z","status":"ssl_error","status_checked_at":"2026-02-21T11:29:20.292Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","ai-coding","claude-code","copilot","cursor-ai","developer-tools","markdown-annotation","mcp-server","plan-review","vscode-extension"],"created_at":"2026-02-17T08:03:24.681Z","updated_at":"2026-03-07T09:16:02.240Z","avatar_url":"https://github.com/yeominux.png","language":"TypeScript","funding_links":["https://buymeacoffee.com/ymnseon8"],"categories":[],"sub_categories":[],"readme":"# MD Feedback\n\n\u003e 계획을 리뷰하세요. AI 에이전트를 가이드하세요. 자신 있게 배포하세요.\n\n[English](README.md) | [한국어](README.ko.md)\n\n[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/yeominux.md-feedback-vscode?label=VS%20Code\u0026logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode)\n[![npm](https://img.shields.io/npm/v/md-feedback?logo=npm)](https://www.npmjs.com/package/md-feedback)\n[![License: SUL-1.0](https://img.shields.io/badge/License-SUL--1.0-blue.svg)](./LICENSE)\n[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?logo=buy-me-a-coffee\u0026logoColor=white)](https://buymeacoffee.com/ymnseon8)\n\n**MD Feedback**은 AI 에이전트가 구현하기 전에 마크다운 계획서를 리뷰하기 위한 VS Code 확장 + MCP 서버입니다. Fix, Question, Highlight로 어노테이션을 남기면, AI 에이전트가 MCP를 통해 구조화된 피드백을 직접 읽습니다. 복사-붙여넣기 없이, 내보내기 없이, 세션 간 컨텍스트 손실 없이.\n\n[VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode)에서 설치 후 `.md` 계획서에서 텍스트를 선택하고 `1/2/3` 키로 리뷰하면 바로 사용할 수 있습니다.\n\n**리뷰하세요. 에이전트가 구현합니다. 게이트가 완료를 추적합니다. 핸드오프가 컨텍스트를 보존합니다.**\n\n![MD Feedback 데모: VS Code 사이드바에서 Fix, Question, Highlight로 마크다운 계획서에 어노테이션을 추가하고 AI 적용 결과를 리뷰하는 과정](https://raw.githubusercontent.com/yeominux/md-feedback/main/assets/demo.gif)\n\n\u003e 최신(v1.5.4): Windows에서 드라이브 문자 대소문자 차이(`D:` vs `d:`)로 인한 FILE_SAFETY 오탐이 수정되었습니다.\n\n## 작동 방식\n\n계획서에서 구현까지, 전체 AI 코딩 루프:\n\n```plaintext\nStep 1  YOU        마크다운으로 계획서 작성\n          │\nStep 2  YOU        MD Feedback 사이드바에서 열기 → 하이라이트, 수정, 질문\n          │         (1, 2, 3 누르기)\n          │\nStep 3  AGENT      MCP로 어노테이션 읽기 — 내보내기 불필요\n          │\nStep 4  AGENT      수정 구현, 질문 답변\n          │\nStep 5  YOU        AI 작업 검토 → 승인, 수정 요청, 또는 거부\n          │\nStep 6  AGENT      게이트 자동 평가\n          │         \"수정 3개 남음\" → \"모두 완료, 머지 가능\"\n          │\nStep 7  AGENT      핸드오프 생성 → 다음 세션이 이어서 작업\n```\n\n1–2, 5단계만 하면 됩니다. 나머지는 에이전트가 합니다.\n\nMCP 우선 방식입니다. 내보내기 기반 워크플로우를 사용하면 2단계 후에 내보내기를 실행하세요.\n\n## 주요 기능\n\n- **3가지 어노테이션 타입**: Highlight (읽기 표시), Fix (수정 필요), Question (설명 필요)\n- **27개 MCP 도구**로 에이전트 직접 연동\n- **11개 AI 도구로 내보내기**: Claude Code, Cursor, Copilot, Codex, Cline, Windsurf, Roo Code, Gemini, Antigravity, Generic, Handoff\n- **품질 게이트**: 어노테이션 해결 상태에 따른 자동 평가\n- **세션 핸드오프**: AI 에이전트 세션 간 컨텍스트 보존\n- **체크포인트**: 스냅샷으로 리뷰 진행 상황 추적\n- **플랜 커서**: 문서 내 현재 위치 추적\n- **키보드 단축키**: 1, 2, 3 누르면 즉시 어노테이션\n- **AI가 수정 적용**: MCP를 통해 에이전트가 구현을 보고하면 인라인 before/after diff로 확인\n- **7가지 상태 뱃지**: Open, Working, Review, Answered, Done, Failed, Won't Fix\n- **롤백**: 에이전트가 실수하면 마지막 변경을 되돌릴 수 있음\n- **일괄 작업**: 여러 수정을 하나의 트랜잭션으로 적용\n- **안전한 텍스트 교체**: 같은 텍스트가 여러 곳에 있을 때 에이전트가 어느 것을 변경할지 지정해야 함 (잘못된 줄 수정 방지)\n- **파일 안전**: .env, credentials, node_modules 등 민감한 파일 쓰기 차단\n- **승인 / 거부 버튼** — 리뷰 필요 시 항상 표시, 한 클릭으로 수락 또는 거부\n- **에디터 CodeLens** — 마크다운 파일에서 직접 승인/거부, 사이드바 불필요\n- **Activity Bar 배지** — 리뷰 대기 중인 어노테이션 수를 한눈에 확인\n- **상태바 + 토스트 알림** — AI가 작업을 전달하면 즉시 알림\n- **키보드 단축키** — Ctrl+Shift+A로 승인, Ctrl+Shift+X로 거부\n- **게이트 오버라이드** — 자동 평가가 부족할 때 수동으로 게이트 상태 제어\n- **외부 파일 diff 인라인** — AI가 변경할 내용을 적용 전에 정확히 확인\n- **게이트 전환 알림** — 게이트가 해제되거나 완료될 때 알림\n- **동시 작업 보호** — 여러 AI 작업이 동시에 실행될 때 데이터 손상 방지\n- **자동 새로고침**: AI가 MCP로 변경하면 문서가 실시간 업데이트\n- **이식 가능한 포맷**: HTML 코멘트로 저장 — 모든 마크다운 렌더러에서 작동, git에서도 보존\n- **풍부한 렌더링**: Mermaid 다이어그램, 콜아웃 블록, 구문 강조 코드\n\n## 빠른 시작 (2분 이내)\n\n1. **설치** — [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode)에서\n2. **먼저 어노테이션** — 마크다운에서 텍스트를 선택하고 `1`(하이라이트), `2`(수정), `3`(질문)\n3. **선택: MCP 연결** — 첫 어노테이션 후 사이드바 `Connect AI`를 눌러 MCP 설정 추가:\n\n```json\n{ \"mcpServers\": { \"md-feedback\": { \"command\": \"npx\", \"args\": [\"-y\", \"md-feedback\"] } } }\n```\n\n4. **완료** — MCP 지원 에이전트는 직접 읽고, export-only 에이전트(예: 현재 Copilot 흐름)는 Export를 사용합니다.\n\n\u003e **MCP는 Node.js 18+ 필요** (`npx` 사용).\n\u003e Claude 경로: `.claude/mcp.json`  \n\u003e Cursor 경로: `.cursor/mcp.json`\n\n\u003e **지금 바로 해보세요:** [Marketplace](https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode)에서 설치 후 아무 `.md` 파일을 열고 `2`를 눌러 첫 Fix 어노테이션을 추가해보세요.\n\n## 사용 사례\n\n### 바이브 코딩 워크플로우\n마크다운으로 계획서를 작성합니다. MD Feedback으로 리뷰합니다. AI 에이전트가 리뷰한 그대로 구현합니다. 계획서가 계약서 — 어노테이션이 지시사항입니다.\n\n### AI 계획서 리뷰\nAI 에이전트가 구현 계획을 생성합니다. 에이전트가 코드를 작성하기 전에 하이라이트, 수정, 질문으로 리뷰합니다. 구현 후가 아닌 설계 단계에서 오류를 잡습니다.\n\n### 세션 연속성\n여러 세션에 걸쳐 AI와 작업하시나요? 핸드오프가 모든 결정, 미해결 질문, 핵심 컨텍스트를 보존합니다. 다음 세션은 이전 세션이 끝난 곳에서 시작합니다.\n\n### 팀 계획서 리뷰\n어노테이션은 마크다운 파일 안의 HTML 코멘트입니다. git 커밋, PR, 브랜치 머지를 통과해도 보존됩니다. 일반적인 버전 관리 워크플로우를 통해 리뷰된 계획서를 팀과 공유하세요.\n\n### 품질 게이트 적용\n에이전트가 진행하기 전에 충족해야 할 조건을 설정합니다. 게이트는 어노테이션 해결 상태에 따라 자동으로 평가됩니다 — blocked, proceed, done.\n\n## 설계 철학\n\n- **인간은 뭐가 문제인지만 말합니다.** 어떻게 고칠지는 AI가 결정합니다.\n- **3가지 어노테이션 타입이면 충분합니다.** AI가 컨텍스트에서 의도를 추론합니다 — 수정이 문서 편집인지 코드 변경인지.\n- **마크다운이 유일한 진실의 원천입니다.** 모든 상태가 파일 자체에 존재합니다.\n- **인지 부하 제로.** 상태 바가 진행 상황을 패시브하게 표시합니다. 추가 결정이 필요 없습니다.\n- **이식 가능하고 git 친화적입니다.** 어노테이션은 HTML 코멘트 — 모든 마크다운 렌더러와 버전 관리에서 보존됩니다.\n\n## VS Code 설정\n\nVS Code 설정에서 `md-feedback.*` 항목으로 동작을 조정할 수 있습니다.\n대규모 워크스페이스를 위한 고급 타이밍/성능 옵션도 제공합니다.\n\n## MCP 서버\n\nMD Feedback에는 27개의 도구를 갖춘 MCP 서버가 포함되어 있어 AI 에이전트가 수동 내보내기 없이 어노테이션을 읽을 수 있습니다. 에이전트가 메모를 조회하고, 작업 완료를 표시하고, 수정을 적용하고, 게이트 상태를 확인하고, 핸드오프를 생성합니다 — 모두 Model Context Protocol을 통해.\n\n**설정:**\n\n```bash\nnpx md-feedback\n```\n\n**워크스페이스 지정** — MCP 클라이언트가 `cwd`를 프로젝트 폴더로 설정하지 않는 경우 (예: Antigravity) 명시적으로 지정:\n\n```json\n{ \"command\": \"npx\", \"args\": [\"-y\", \"md-feedback\", \"--workspace=/path/to/project\"] }\n```\n\nWindows 예시: `{ \"command\": \"npx\", \"args\": [\"-y\", \"md-feedback\", \"--workspace=C:\\\\\\\\work\\\\\\\\my-project\"] }`  \n또는 환경변수: `MD_FEEDBACK_WORKSPACE=/path/to/project`\n\n자세한 내용은 [MCP 서버 문서](./apps/mcp-server/README.md)를 참조하세요.\n\n## 링크\n\n- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=yeominux.md-feedback-vscode)\n- [npm (MCP 서버)](https://www.npmjs.com/package/md-feedback)\n- [이슈 리포트](https://github.com/yeominux/md-feedback/issues)\n- [기여하기](./CONTRIBUTING.md)\n- [후원하기](https://buymeacoffee.com/ymnseon8)\n\n## 라이선스\n\n[SUL-1.0](./LICENSE) — 개인 및 비상업적 사용 무료.\n\n---\n\n## FAQ\n\n**MD Feedback이 뭔가요?**\nAI 에이전트가 구현하기 전에 마크다운 계획서를 리뷰하기 위한 VS Code 확장 + MCP 서버입니다. 텍스트를 선택하고 1(하이라이트), 2(수정), 3(질문)을 누르면 어노테이션이 마크다운 파일 안에 이식 가능한 HTML 코멘트로 저장됩니다. 11개 AI 도구로 내보내거나, MCP로 에이전트가 직접 읽습니다.\n\n**Claude Code / Cursor / Copilot에서 쓸 수 있나요?**\n네. Claude Code(`CLAUDE.md`), Cursor(`.cursor/rules/`), GitHub Copilot(`.github/copilot-instructions.md`) 등 11개 도구를 지원합니다. MCP를 사용하면 내보내기 없이 에이전트가 직접 읽습니다.\n\n**MCP가 뭐고 왜 중요한가요?**\nMCP(Model Context Protocol)는 AI 에이전트가 외부 도구와 상호작용할 수 있게 하는 프로토콜입니다. MD Feedback의 MCP 서버는 에이전트에게 어노테이션에 대한 직접 접근을 제공하여, 피드백을 읽고, 작업을 완료 표시하고, 게이트를 평가하고, 핸드오프를 자동으로 생성할 수 있습니다.\n\n**여러 사람이 같은 계획서를 리뷰할 수 있나요?**\n네. 어노테이션은 마크다운 파일에 내장된 HTML 코멘트입니다. 커밋, 브랜치, PR, 머지를 통해 git으로 이동해도 어노테이션이 온전히 보존됩니다.\n\n**무료인가요?**\n네. [SUL-1.0](./LICENSE) 라이선스 하에 개인 및 비상업적 사용은 무료입니다.\n\n**누구를 위한 도구인가요?**\nAI 코딩 어시스턴트를 사용하면서, 구현 전에 계획을 리뷰하고, 세션 간 컨텍스트를 보존하고, 비정형 채팅 대신 구조화된 피드백을 에이전트에게 전달하고 싶은 개발자를 위한 도구입니다.\n\n추가 질문과 고급 가이드: [MCP 서버 문서](./apps/mcp-server/README.md), [GitHub Issues](https://github.com/yeominux/md-feedback/issues)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyeominux%2Fmd-feedback","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyeominux%2Fmd-feedback","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyeominux%2Fmd-feedback/lists"}