makethlm: LLM 프롬프트를 태스크로 실행하는 차세대 태스크 러너

섹션별 상세

makethlm은 Promptfile 내에서 쉘 명령어(!)와 자연어 프롬프트를 교차 배치하여 실행하는 하이브리드 방식을 채택했다. 쉘 명령어가 실행된 후 그 출력값이 다음 프롬프트의 컨텍스트로 활용될 수 있어, LLM이 실제 시스템 상태를 확인하고 후속 작업을 결정하는 지능형 자동화가 가능하다.

text

project := "my-web-app"
llm claude [model=opus]

task build:
  !mkdir -p dist
  check if src/ has changed since the last build. if so, compile the TypeScript and bundle with esbuild.

task test: build
  !npm test
  if any tests failed, explain the root cause and suggest/apply a fix.

자연어 프롬프트와 쉘 명령어가 혼합된 Promptfile의 기본 구조 예시

태스크 간 의존성 관리 시스템은 위상 정렬을 통해 실행 순서를 자동으로 결정한다. 특정 태스크가 다른 태스크에 의존하도록 설정하면 선행 작업이 성공적으로 완료된 후 다음 단계가 진행되며, 순환 참조 발생 시 이를 감지하여 오류를 보고한다.

변수 선언(:=)과 텍스트 보간({{ }}) 기능을 통해 동적인 워크플로우를 구성한다. 특히 백틱(`` ` ``)을 사용해 쉘 명령어의 실행 결과를 변수에 즉시 할당하거나, CLI 인자를 통해 런타임에 변수 값을 덮어쓰는 기능을 지원하여 유연한 환경 대응이 가능하다.

text

docker api-server [tag=latest]:
  A Python 3.11 slim image. Install requirements.txt with pip, no cache.
  Copy the app/ directory to /app. Set the working directory to /app.
  Expose port 8080. Run with gunicorn, 4 workers, binding 0.0.0.0:8080.

자연어 설명을 바탕으로 LLM이 Dockerfile을 생성하고 빌드하도록 설정하는 예시

docker 블록 기능을 통해 인프라 구성을 자연어로 관리한다. 사용자가 이미지의 특징을 서술하면 LLM이 최적의 Dockerfile을 생성하고, makethlm이 이를 직접 빌드하여 태스크 의존성 체인에 통합시킨다.

text

fn security_review:
  Review the code for security vulnerabilities. Check specifically for:
  - SQL injection
  - XSS (cross-site scripting)
  Be concise and actionable.

task review:
  @use security_review
  Focus on the git diff for the current PR.

재사용 가능한 프롬프트 템플릿을 정의하고 태스크에 주입하는 방법

Ansible과 유사한 호스트 인벤토리 기능을 내장하여 SSH를 통한 원격 실행을 지원한다. [on=group] 옵션을 사용하면 쉘 명령어는 지정된 원격 서버들에서 실행되고, 프롬프트 추론은 로컬 LLM에서 수행되어 원격 서버의 상태를 로컬에서 지능적으로 제어할 수 있다.

Justfile과의 호환성을 고려하여 설계되었으며 if/else 조건문, OS 및 아키텍처 확인 함수, 다양한 문자열 처리 함수를 제공한다. 이를 통해 복잡한 로직을 LLM 호출 없이도 효율적으로 처리하며 필요한 부분에만 선택적으로 LLM을 활용할 수 있다.

용어 해설

태스크 러너(Task Runner): — 소프트웨어 빌드, 테스트, 배포와 같은 반복적인 작업을 자동화하기 위해 미리 정의된 명령어를 순차적으로 실행하는 도구이다. Make나 Just가 대표적이며, 개발 워크플로우의 효율성을 높이고 실행 환경의 일관성을 보장하는 역할을 한다.
위상 정렬(Topological Sort): — 방향 그래프에서 노드들 사이의 선후 관계를 유지하며 나열하는 알고리즘이다. 태스크 러너에서 특정 작업이 다른 작업에 의존할 때, 의존성이 있는 작업을 먼저 실행하도록 순서를 결정하는 핵심 메커니즘으로 사용된다.
호스트 인벤토리(Host Inventory): — 관리 대상이 되는 원격 서버들의 목록과 접속 정보를 구조화하여 관리하는 방식이다. Ansible과 같은 설정 관리 도구에서 주로 사용되며, 하나의 명령으로 여러 서버에 동시에 작업을 수행하거나 그룹별로 관리할 때 필수적이다.
드라이 런(Dry Run): — 실제 시스템에 변경을 가하지 않고 실행 과정만 시뮬레이션하여 결과를 미리 확인하는 테스트 방식이다. 복잡한 배포나 삭제 명령을 실행하기 전, 예상치 못한 오류나 의도하지 않은 동작을 방지하기 위해 수행한다.

기술

Python
Claude API
OpenAI API
Ollama
Docker
SSH

활용 사례

자연어 기반 코드 생성 및 빌드 자동화
CI/CD 파이프라인 내 지능형 보안 및 품질 리뷰
멀티 서버 환경의 원격 배포 및 상태 검증
자연어 설명을 통한 Docker 이미지 생성 및 관리

언급된 리소스

GitHubmakethlm GitHub Repository

project := "my-web-app" llm claude [model=opus] task build: !mkdir -p dist check if src/ has changed since the last build. if so, compile the TypeScript and bundle with esbuild. task test: build !npm test if any tests failed, explain the root cause and suggest/apply a fix.

docker api-server [tag=latest]: A Python 3.11 slim image. Install requirements.txt with pip, no cache. Copy the app/ directory to /app. Set the working directory to /app. Expose port 8080. Run with gunicorn, 4 workers, binding 0.0.0.0:8080.

fn security_review: Review the code for security vulnerabilities. Check specifically for: - SQL injection - XSS (cross-site scripting) Be concise and actionable. task review: @use security_review Focus on the git diff for the current PR.

makethlm: LLM 프롬프트를 태스크로 실행하는 차세대 태스크 러너

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

makethlm: LLM 프롬프트를 태스크로 실행하는 차세대 태스크 러너

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드