카테고리 Signals

기본 지시문과 페르소나 오버라이드를 같은 문자열에 이어 붙이면 어느 쪽이 이겼는지 나중에 알 수 없다. Jinja의 extends·block·super()로 두 레이어를 명시적으로 구조화하는 법을 정리한다.

재시도는 실패를 지우지 않는다. tenacity로 지수 백오프·지터·최대 시도 횟수·데드레터 큐를 구성해 실패 원인을 남기면서 안전하게 재시도하는 법을 정리한다.

도구가 20~50개를 넘으면 스키마만으로 컨텍스트가 잠식되고 도구 선택 정확도도 떨어진다. Tool Search와 defer_loading으로 필요한 도구만 불러오는 방법을 공식 문서 기준으로 정리한다.

외부 웹 페이지를 LLM 컨텍스트에 그대로 넣으면 숨김 텍스트·인젝션·토큰 낭비 문제가 생긴다. Anthropic web fetch 도구와 MCP fetch 서버가 실제로 어떤 보호장치를 두는지 정리한다.

Claude Agent Skills의 SKILL.md description 필드는 단순 설명이 아니라 언제 스킬을 골라야 하는지를 정하는 트리거 조건이다. 공식 문서 기준 작성 규칙과 안티패턴을 정리한다.

대화가 길어지면 context window가 한계에 부딪힌다. Anthropic API의 서버사이드 compaction 옵션과 요약 지점을 명시적으로 남기는 마커 설계를 정리한다.

로그와 데이터 파이프라인에서 event_time·ingest_time·processing_time을 분리해 남기지 않으면 재처리 시 기록이 조용히 왜곡된다. Apache Beam 워터마크 개념을 기준으로 실무 설계 원칙을 정리한다.

에이전트 도구가 받는 인자를 타입만 검사하면 값 자체의 오남용은 막지 못한다. JSON Schema enum과 Pydantic으로 도구 인자를 allowlist 방식으로 검증하는 방법을 정리했다.

AI 에이전트에 붙일 웹 검색 API를 고를 때 Tavily·Brave Search API·Exa·SerpAPI 중 무엇을 선택해야 할지, 가격·결과 형식·처리량 한도를 공식 문서 기준으로 비교한다.

system·developer·user 메시지가 충돌할 때 LLM은 무엇을 먼저 따를까. OpenAI Model Spec의 chain of command와 Anthropic의 시스템 프롬프트 설계 원칙을 기준으로 지시 계층 우선순위를 정리한다.