프롬프트 파이프라인은 메타 프로그래밍 특성을 보여줍니다.

한 개발자가 Electron 앱(Claude Code CLI, React, TypeScript, SQLite)을 구축하는 데 사용된 프롬프트 파이프라인을 문서화했습니다. 이 파이프라인은 타입화된 입출력, 제어 흐름, 루프, 상태 머신, 모듈 인터페이스를 포함한 메타 프로그래밍 언어의 구조적 특성을 보여줍니다.

파이프라인 아키텍처

이 시스템은 서로 타입화된 계약을 가진 네 가지 구별된 단계로 작동합니다.

1단계: 정적 분석

repo-eval.md 프롬프트는 전체 코드베이스 스캔을 수행합니다. 모든 소스 파일을 읽고, 의존성 그래프를 추적하며, IPC 흐름을 종단 간 매핑하고, 구조화된 발견 보고서를 issues.md로 출력합니다. 각 발견 항목은 다음을 포함합니다:

• 섹션 ID
• 제목
• 심각도(위험/높음/중간/낮음)
• 범주
• 파일 경로와 줄 범위
• 증거
• 영향 평가
• 권장 수정 사항

2단계: 컴파일

address-issues.md 프롬프트는 1단계의 출력을 파싱합니다. 발견 항목을 파일 친화도별로 그룹화하고, 프롬프트 번호(FIX-01, FIX-02, ...)를 할당하며, 프롬프트 간 의존성을 결정하고, 심각도별로 정렬합니다. 출력은 다음을 포함하는 디렉토리(prompts/arch/r{NNN}/)입니다:

• FIX-NN.md — 목표, 해결된 발견 항목, 수정할 파일, 구현 단계, 검증 기준을 명시하는 독립적인 수정 프롬프트.
• STATE.md — 프롬프트별 상태(대기/진행 중/완료/차단), 의존성 그래프, 완료 날짜, 인계 노트를 포함한 실행 상태 추적기.
• MASTER.md — 실행 루프 명세.

3단계: 실행

MASTER.md는 런타임 루프 역할을 합니다. 각 반복에서:

1. STATE.md 읽기
2. 의존성이 충족된 다음 대기 중인 프롬프트 선택
3. 프롬프트 읽기
4. 영향을 받는 모든 소스 파일 읽기
5. 구현 단계 실행
6. 검증 실행(tsc --noEmit, 제거된 패턴에 대한 grep, 줄 수 확인)
7. STATE.md 업데이트
8. 변경 로그 항목 추가, 아키텍처 문서 업데이트
9. 1단계로 루프

4단계: 패키징

release-notes.md 프롬프트는 변경 로그를 읽고, 마지막 태그에 대해 git log와 git diff --stat을 실행하며, 변경 사항을 분류하고, 버전 업데이트 권장 사항과 함께 형식화된 릴리스 노트를 출력합니다.

주요 특성

타입화된 계약: repo-eval의 출력 스키마는 address-issues의 입력 계약입니다. address-issues의 출력 스키마는 MASTER의 입력 계약입니다. FIX 프롬프트는 address-issues가 생성하는 정확한 형식을 소비합니다. STATE.md는 MASTER가 읽고 쓰는 정의된 스키마를 가집니다.

자동 문서화: 모든 Claude Code 컨텍스트 창에 첨부된 시스템 프롬프트(agents.md)는 실행 후 프로토콜을 포함합니다: 변경 로그 항목 추가, 영향 받는 아키텍처 문서 업데이트, 상태 추적 업데이트. 문서화는 프롬프트 실행의 부산물로 출력되어 컨텍스트 감소를 제거합니다.

ADR로서의 프롬프트: 각 FIX-NN.md는 설계 문서, 작업 지시서, 아키텍처 결정 기록으로 기능하며, 실행 전 문제, 근거, 구현 계획, 검증 기준을 포착합니다.

출력

이 파이프라인을 하루 동안 실행한 결과:

• 전체 저장소 평가 2회
• 2개 개정 라운드에서 17개의 버그 수정(경쟁 조건, 스트림 아키텍처, 동시 상태 관리)
• 서비스 분해: 1,218줄 → 403줄 + 5개 추출 서비스
• 추가 충돌 수정 3건
• 소스에 대해 검증된 README 재작성
• 6페이지 GitHub Pages 웹사이트
• 21개 변경 로그 항목