---
description: docs/like_mcp.md 지도 필수 참조 · MD vs MCP/grep 역할 · 변경 시 MD stale 방지 (체크리스트 본문은 문서에만)
alwaysApply: true
---

# like_mcp 문서 지도 (중복 없는 포인터)

체크리스트·ERD·의존성 **본문은 여기에 복사하지 말고** 아래 파일만 연다.  
정합·DB adhoc·웹 재시작·Optuna 운영 세부는 기존 룰(`.cursorrules` CRITICAL, `live-backtest-optuna-parity`, `db-adhoc-query-safety` 등)을 따른다.

## 1. 필수 문서 (`docs/like_mcp.md/`)

| 문서 | 경로 | 언제 |
|------|------|------|
| 수정 가이드 | `docs/like_mcp.md/MODIFICATION_GUIDE.md` | **수정 전** — 유형별 필수 grep·사이드이펙트 |
| 아키텍처 맵 | `docs/like_mcp.md/code_architecture.md` | 구조·허브·import 영향 범위 |
| DB ERD | `docs/like_mcp.md/db_erd.md` | 테이블/컬럼 지도 (실행 전 스키마는 실DB `SHOW COLUMNS` — `db-adhoc-query-safety`) |

주석/docstring만 바꾸는 경우가 아니면, 수정 전 `MODIFICATION_GUIDE.md`의 해당 유형 grep을 **실제로 실행**해 파일 목록을 확정한다. MD는 “어디를 찾을지” 지도일 뿐.

## 2. MD vs MCP / 도구 (토큰)

1. **거시(Layer·Hub·영향 범위)** → `docs/like_mcp.md/` 목차·관련 섹션만.
2. **미시(현재 소스·API)** → MCP(`kis-code-assistant` 등) 또는 Grep/부분 Read. 거대 파일 통째 읽기 지양.
3. **수정 범위 확정** → 가이드의 grep 후 그 결과로만 패치.

## 3. 코드 변경 후 MD 갱신 (stale 방지)

| 변경 | 갱신 |
|------|------|
| 파일 추가·삭제·이동 / import 구조 | `code_architecture.md` |
| DB 테이블·컬럼 | `db_erd.md` |
| ENV·params 키 / 전략 추가·삭제 | `MODIFICATION_GUIDE.md` 체크리스트 (± architecture) |

재생성 스크립트는 `MODIFICATION_GUIDE.md` 하단 표를 따른다.  
완료 보고에 실매·웹백테·파람 영향 여부를 명시한다 (세부 절차는 `live-backtest-optuna-parity` 등 기존 룰).