pmc: LLM 프롬프트 구성을 위한 초경량 코드 컨텍스트 패키징 도구

섹션별 상세

pmc는 LuaInstaller로 패키징된 독립 실행형 바이너리 도구로 설치와 사용이 간편하다. 장치에 Git 환경이 구성되어 있다면 기본적으로 .gitignore 파일을 추적하여 불필요한 빌드 파일이나 로그가 패키징에 포함되는 것을 방지한다. 설치 후 pmc -v 명령어로 정상 작동 여부를 확인할 수 있으며, 현재 디렉토리 전체를 패키징할 때는 pmc . 명령어를 사용한다.

사용자는 -x(Exclude)와 -m(Include Only) 옵션을 사용하여 패키징 대상을 정교하게 제어한다. -x 옵션은 특정 확장자나 디렉토리를 제외하며, -m 옵션은 지정된 패턴과 일치하는 파일만 포함시킨다. 이때 -x 옵션이 -m 옵션보다 우선순위가 높아 두 조건에 모두 해당하면 제외 처리된다. Git 저장소가 아니거나 Git이 없는 환경에서는 -r 옵션을 사용하여 직접 파일 시스템을 스캔할 수 있다.

bash

pmc . -m "src/,*.lua" -s

src 디렉토리 내의 .lua 파일만 패키징하고 마지막에 통계 정보를 출력하는 예시

bash

pmc . -x "*.png,*.jpg,*.log" -o context.md

이미지와 로그 파일을 제외한 결과를 context.md 파일로 저장하는 예시

다양한 출력 포맷과 구조화 옵션을 제공한다. 기본값은 Markdown 코드 블록 형식이지만, -y 옵션을 사용하면 전체 프로젝트를 계층적 YAML 구조로 출력한다. YAML 모드에서는 파일 트리와 내용이 자체적인 계층 구조로 조직화되므로 별도의 트리 출력 옵션이 필요하지 않다. 또한 -t 옵션으로 서두에 트리 구조를 추가하거나 -s 옵션으로 마지막에 통계 정보를 덧붙일 수 있다.

bash

pmc . -y -o context.yaml

전체 프로젝트 구조와 내용을 YAML 형식으로 변환하여 저장하는 예시

안정적인 컨텍스트 생성을 위해 자동 필터링 기능을 내장하고 있다. 1MB를 초과하는 대용량 파일은 자동으로 건너뛰며, 바이너리 포맷이나 널(null) 바이트가 포함된 파일도 제외 대상이다. 모든 파일은 UTF-8 호환 텍스트로 간주하며, 출력 결과는 터미널에 직접 출력하거나 -o 옵션을 통해 특정 파일로 리다이렉션할 수 있다.

용어 해설

컨텍스트 윈도우(Context Window): — LLM이 한 번의 추론 과정에서 동시에 처리하고 기억할 수 있는 텍스트 데이터의 최대 범위이다. 코드 베이스 전체를 입력할 때 이 제한을 넘지 않도록 필요한 파일만 선택하여 패키징하는 것이 중요하다.
마크다운 코드 블록(Markdown Code Block): — 텍스트 문서 내에서 프로그래밍 코드를 별도의 영역으로 구분하기 위해 사용하는 문법이다. LLM이 일반 텍스트와 코드를 명확히 구분하여 인식할 수 있도록 돕는 역할을 한다.
YAML 모드(YAML Mode): — 데이터를 계층적인 트리 구조로 표현하는 직렬화 형식이다. pmc에서 이 모드를 사용하면 코드의 파일 구조와 내용을 구조화된 데이터 형태로 변환하여 LLM이 프로젝트의 계층 관계를 더 쉽게 파악하게 한다.
깃 이그노어(.gitignore): — Git 버전 관리 시스템에서 추적하지 않을 파일이나 디렉토리 목록을 지정하는 설정 파일이다. pmc는 이를 참조하여 빌드 결과물이나 로그 등 불필요한 파일이 LLM 프롬프트에 포함되지 않도록 자동으로 필터링한다.

기술

pmc
LuaInstaller
Git
Markdown
YAML

활용 사례

LLM 프롬프트용 코드 컨텍스트 생성
코드 베이스 문서화
프로젝트 구조 요약 추출

섹션별 상세

bash

pmc . -m "src/,*.lua" -s

src 디렉토리 내의 .lua 파일만 패키징하고 마지막에 통계 정보를 출력하는 예시

bash

pmc . -x "*.png,*.jpg,*.log" -o context.md

이미지와 로그 파일을 제외한 결과를 context.md 파일로 저장하는 예시

bash

pmc . -y -o context.yaml

전체 프로젝트 구조와 내용을 YAML 형식으로 변환하여 저장하는 예시

용어 해설

컨텍스트 윈도우(Context Window): — LLM이 한 번의 추론 과정에서 동시에 처리하고 기억할 수 있는 텍스트 데이터의 최대 범위이다. 코드 베이스 전체를 입력할 때 이 제한을 넘지 않도록 필요한 파일만 선택하여 패키징하는 것이 중요하다.
마크다운 코드 블록(Markdown Code Block): — 텍스트 문서 내에서 프로그래밍 코드를 별도의 영역으로 구분하기 위해 사용하는 문법이다. LLM이 일반 텍스트와 코드를 명확히 구분하여 인식할 수 있도록 돕는 역할을 한다.
YAML 모드(YAML Mode): — 데이터를 계층적인 트리 구조로 표현하는 직렬화 형식이다. pmc에서 이 모드를 사용하면 코드의 파일 구조와 내용을 구조화된 데이터 형태로 변환하여 LLM이 프로젝트의 계층 관계를 더 쉽게 파악하게 한다.
깃 이그노어(.gitignore): — Git 버전 관리 시스템에서 추적하지 않을 파일이나 디렉토리 목록을 지정하는 설정 파일이다. pmc는 이를 참조하여 빌드 결과물이나 로그 등 불필요한 파일이 LLM 프롬프트에 포함되지 않도록 자동으로 필터링한다.

기술

pmc
LuaInstaller
Git
Markdown
YAML

활용 사례

LLM 프롬프트용 코드 컨텍스트 생성
코드 베이스 문서화
프로젝트 구조 요약 추출

pmc: LLM 프롬프트 구성을 위한 초경량 코드 컨텍스트 패키징 도구

섹션별 상세

용어 해설

기술

활용 사례

pmc: LLM 프롬프트 구성을 위한 초경량 코드 컨텍스트 패키징 도구

섹션별 상세

용어 해설

기술

활용 사례

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드