마크다운은 문서가 아닌 소스 코드가 되어야 한다

핵심 요약

• AI 기반 코딩이 확산되면서 마크다운이 문서가 아닌 실제 소스 코드의 역할을 하고 있다.
• 현재 LLM 코드 생성은 대화형 프롬프트에서 나오므로 원본 의도를 추적할 수 없는 문제가 있다.
• 마크다운을 /src/md 디렉토리에 버전 관리하면서 소스 코드와 함께 둬야 개발자와 에이전트 모두 의도를 파악할 수 있다.
• 마크다운은 일반 텍스트라 diff와 검색이 가능하고, LLM도 자연스럽게 읽고 쓸 수 있으며, 휴먼리더블하다는 장점이 있다.
• 마크다운은 아키텍처·데이터 설계 같은 중간 수준의 결정을 담고, 테스트는 그 마크다운에 기반해 파생되어야 한다.
• 위키나 선형 같은 별도 도구는 고수준 설계나 프로세스 문서로 남고, 현재의 의도와 행동은 소스 디렉토리 안 마크다운에 집중시켜야 한다.