# 지침 파일은 코드의 지도가 아닙니다.

Canonical source: https://maguyva.ai/ko/beyond-rules-files

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

CLAUDE.md와 AGENTS.md는 에이전트에게 어떻게 행동할지 알려줍니다. 코드베이스에 무엇이 있는지는 알려주지 않습니다. Maguyva는 MCP를 통해 그 역할을 하는 레이어입니다.

규칙 파일은 사람이 직접 씁니다. 모든 호출자, import, 정의를 나열할 수 없고, 코드가 바뀌면 금세 낡습니다. Maguyva는 저장소 자체를 인덱싱하고 그 지도를 항상 최신으로 유지합니다.

- [첫 저장소 인덱싱하기](https://app.maguyva.ai/auth/sign-up?plan=free)
- [문서 읽기](https://maguyva.ai/ko/docs)

무료 플랜: 저장소 3개, 인덱싱된 저장소 라인 최대 5만 줄, 카드 등록 불필요.

## 규칙 파일은 그대로 유지하세요

*// 행동*

CLAUDE.md와 AGENTS.md는 여전히 자기 역할을 합니다: 컨벤션, 명령어, 가드레일.

## 조회 가능한 인덱스를 추가하세요

*// 사실*

MCP를 통해 실제 코드 전반에서 시맨틱, 구조적, 그래프, 텍스트 검색을 제공합니다.

## 낡은 스냅샷이 아닙니다

*// 최신 상태*

재구축이 지난달 문서가 아니라 실제 코드와 지도를 동기화된 상태로 유지합니다.

## 행동에는 규칙을, 사실에는 Maguyva를.

이미 알고 있는 저장소 하나를 인덱싱하고, 검증할 수 있는 질문 하나를 던져보세요.

01. **규칙 파일은 그대로 유지하세요**: CLAUDE.md와 AGENTS.md는 지금 그대로 유지됩니다. 마이그레이션할 것도 없습니다.
02. **MCP를 통해 Maguyva 추가하기**: 아는 저장소를 인덱싱한 다음, Claude, Codex, Cursor, 또는 다른 MCP 클라이언트를 연결하세요.
03. **문서가 답할 수 없는 걸 물어보세요**: 이 함수는 무엇이 호출하나요? 이걸 바꾸면 무엇이 깨지나요? 마크다운 파일이 담을 수 없는 질문들입니다.

## 행동에는 규칙 파일을, 사실에는 Maguyva를 사용하세요.

무료로 시작하세요. 지침 파일만으로는 제공할 수 없는 코드베이스 컨텍스트 레이어를 추가하세요. 신용카드도, 영업 전화도 필요 없습니다.

- [첫 저장소 인덱싱하기](https://app.maguyva.ai/auth/sign-up?plan=free)
- [문서 읽기](https://maguyva.ai/ko/docs)