markdown 파일이 새로운 dot 파일이 되고 있나요?

Source: Dev.to

배경

Symfony, Astro, Ollama와 같은 프로젝트는 종종 .gitignore, .env와 같은 점 파일을 저장소 최상위에 배치합니다.

AI 도구가 급증하면서 CLAUDE.md, AGENTS.md와 같은 새로운 마크다운 파일들이 루트 디렉터리에 나타나고 있습니다.

마크다운 설정 파일의 문제점

• 맥락 부족 – 다른 비점 파일과 마찬가지로, 이러한 마크다운 파일은 추가 문서 없이는 찾기 어렵고 이해하기 힘듭니다.
• 루트 디렉터리 혼잡 – 저장소 루트에 파일이 더 많이 추가되면 프로젝트 구조를 탐색하기가 어려워집니다.

가능한 해결책

1. 전용 폴더 만들기
   모든 설정 관련 마크다운 파일을 .tools(또는 유사) 디렉터리에 넣습니다.

   # Example directory structure
   .
   ├── src/
   ├── .tools/
   │   ├── CLAUDE.md
   │   └── AGENTS.md
   └── Makefile

2. Makefile(또는 유사 도구)로 도구 별칭 지정
   전용 폴더 안의 설정 파일을 참조하는 타깃을 정의합니다.

   # Makefile example
   claude:
   	@echo "Running Claude with config .tools/CLAUDE.md"
   	# command that uses the config file
   
   agents:
   	@echo "Running Agents with config .tools/AGENTS.md"
   	# command that uses the config file

3. 마크다운 파일 내부에 범위 지정
   일부 개발자는 별도 디렉터리가 필요 없도록 CLAUDE.md와 같은 파일 안에 범위 지정 메커니즘을 추가하는 방식을 제안합니다.

토론

AI 관련 마크다운 파일을 전용 디렉터리로 이동하고 별칭을 사용하는 것이 애플리케이션 루트 폴더를 정리할 시점일까요? 이 접근 방식은 조직화를 개선하고, 혼잡을 줄이며, 각 파일의 목적을 보다 명확히 할 수 있습니다.