disler/fixing-smartass-opus-5

해결하는 문제

Opus 5는 사용 가능한 가장 똑똑한 모델 중 하나이지만, 기본 통신 스타일은 토큰과 시간을 낭비합니다. 답변을 여러 헤더 아래에 숨기고, “load-bearing”이나 “worth stating plainly”와 같은 반복적인 문구를 사용하며, 아첨을 추가하고, 심지어 커밋에 공동 저자 크레딧을 찍기도 합니다. 엔지니어들은 개별 사용자 프롬프트를 조정하여 이를 해결하려고 하지만, 이는 한 번에 하나의 작업에만 도움이 됩니다. 진정한 레버리지는 세션의 모든 턴에 적용되는 시스템 프롬프트에 있습니다. 이 프로젝트는 장황하고 범위가 확장되기 쉬운 어시스턴트를 간결하고 정확한 엔지니어링 파트너로 바꿔주는 신중하게 작성된 시스템 프롬프트를 제공합니다.

작동 방식

전체 제품은 단일 markdown 파일인 sr_opus_5_system_prompt.md이며, --append-system-prompt-file 플래그를 사용하여 코딩 에이전트의 시스템 프롬프트에 추가합니다. 프롬프트는 4개의 지침 섹션과 구체적인 예시로 구성되어 있습니다:

• 긍정 및 부정 패턴: “이것을 하라/절대 하지 마라” 목록입니다. “load-bearing” 및 대시 체인과 같은 문구를 금지하고, 모든 응답에서 간결하고 직접적인 의사소통 습관을 강화합니다.
• 참조 포인트: 모델은 출력을 짧은 코드로 레이블링합니다 — F1은 발견, D1은 결정, O1은 옵션, R1은 위험, Q1은 질문, A1은 행동을 의미합니다. 후속 조치는 keep D1, reject O2, answer Q1과 같은 거의 제로 토큰 명령이 됩니다.
• 엄격한 운영 경계: 요청되지 않은 리팩토링, 부수적인 정리, 증거 없는 완료 주장, 커밋 내 공동 저자 크레딧을 차단하는 범위 제어입니다.
• 별칭: 전체 지침으로 확장되는 2~3글자 명령입니다. 예: scr (단순화, 압축, 반복), eli (18세 수준으로 설명), foc (한 가지에 집중), ref (참조 포인트와 함께 다시 쓰기).

실제 모델 출력에서 구축된 “To do” 및 “Not to do” 예시도 있습니다. 모델은 규칙보다 예시를 더 강력하게 패턴 매칭하기 때문입니다.

저장소에는 비교 루프가 포함되어 있습니다. just 명령과 herdr을 사용하여 두 개의 Claude Code 창을 나란히 실행할 수 있습니다. 하나는 기본 모델, 다른 하나는 시스템 프롬프트가 추가된 모델입니다. 둘 다 동일한 사용자 프롬프트(긴 블로그 게시물 요약)를 받으며, 응답 길이, 출력 토큰, 실행 시간이 실시간으로 차이 나는 것을 관찰할 수 있습니다. 동일한 시스템 프롬프트는 Pi 코딩 에이전트에서도 작동하여 하네스 간의 이식성을 증명합니다.

대상 사용자

최첨단 코딩 에이전트(Claude Code, Pi 또는 시스템 프롬프트 추가가 가능한 모든 하네스)를 실행하며, 출력 품질을 희생하지 않고 비용을 절감하고 반복 속도를 높이려는 중급 이상의 엔지니어. 작업별로 사용자 프롬프트를 조정하는 데 지쳤고 시스템 수준에서 통신 채널을 수정할 준비가 된 모든 사람을 위한 것입니다.

주요 특징

• 단일 파일, 빌드나 종속성 없음 — 순수 markdown과 --append-system-prompt-file 플래그만 사용.
• 간결하고 군더더기 없는 응답을 강화하기 위한 명시적인 금지 문구 목록 및 긍정적 행동 패턴.
• 참조 코드를 통해 후속 조치를 거의 제로 토큰 명령으로 전환.
• 엄격한 경계로 범위 확장, 요청되지 않은 정리, 공동 저자 크레딧 차단.
• scr, eli, foc, ref와 같은 별칭이 대화의 bash 별칭으로 작동.
• 컨텍스트 내 예시가 규칙보다 톤을 더 잘 추출함.
• 내장된 비교 루프 (just compare <name>)를 통해 기본 모델과의 차이를 나란히 확인 가능.
• 동일한 시스템 프롬프트가 Claude Code와 Pi 모두에서 작동하여 이식성 증명.