서론

Claude 5 세대 모델의 등장으로 컨텍스트 엔지니어링 (Context Engineering)의 사고방식이 크게 변하고 있습니다.

실제로 Claude Code에서는 시스템 프롬프트 (System Prompt)의 80% 이상을 삭제해도 성능 저하가 관찰되지 않았다고 합니다. 지금까지처럼 세세한 규칙이나 방대한 지시를 처음부터 채워 넣는 것이 아니라, 모델 자체의 판단력을 활용하여 필요한 정보를 필요한 타이밍에 전달하는 것이 더욱 중요해지고 있습니다.

이 기사에서는 Claude 5 세대 모델에 의해 무엇이 변했는지, 프롬프트 (Prompt)나 툴 (Tool) 설계 등 실제로 발생할 법한 사례를 곁들여 수작업으로 알기 쉽게 정리합니다.

대상 독자

• Claude Code와 같은 AI 코딩 툴을 사용하고 있는 분
• CLAUDE.md나 시스템 프롬프트가 길어져서 지시 사항 정리에 고민하고 있는 분
• AI 에이전트(AI Agent)를 위한 프롬프트, 툴, 스킬 설계를 재검토하고 싶은 분
• Claude 5 세대 모델의 변화나, 다른 모델에도 응용할 수 있는 컨텍스트 엔지니어링 (Context Engineering)의 사고방식을 알고 싶은 분

변화된 점 요약

세세하게 규칙화하는 것이 아니라, AI의 판단에 맡기기

지금까지

"주석은 반드시 1줄 이내로", "문서는 반드시 ○○ 방식으로 기재"

⇨ 규칙을 세세하게 정해서 AI에게 학습시키고 있었다

앞으로

"주변 코드의 분위기에 맞춰서 적절하게 작성해줘"

모델 자체의 성능 판단력이 향상되었기 때문에,

상황에 따른 유연한 대응이 가능해졌으며,

규칙 간의 모순으로 인해 AI가 패닉에 빠지는 것을 방지할 수 있습니다.

툴의 사용법을 세세하게 예시하는 것이 아니라, 툴의 IF 설계를 세련되게 만들기

지금까지

"○○와 같은 상황일 때는 이 툴을 사용해 주세요"

⇨ 구체적인 이용 사례를 프롬프트 등에 기재하여 학습시키고 있었다

앞으로

툴 측의 설정(파라미터 (Parameter) 선택지나 이름 등) 자체를,
AI가 읽고 단번에 이해할 수 있을 정도로 심플하고 명확하게 설계한다

첫 프롬프트에 모든 것을 채워 넣는 것이 아니라, AI가 물어볼 때 공개하기

지금까지

초기 장문 프롬프트 던지기

⇨ 코드 리뷰 방법이나 검증 절차 등, 나중에 사용할지도 모르는 지시 사항도 모두 첫 프롬프트에 포함하고 있었다

앞으로

처음에는 최소한의 지시만 전달하고, 특정 타이밍(검증이나 리뷰 등)에 필요한 지시는

독립된 파일이나 스킬 (Skill)로 분리해 두어,

AI가 필요할 때마다 그때그때 읽어들일 수 있도록 한다

단순한 사양서를 전달하는 것이 아니라, 풍부한 참조 자료(HTML 등)를 전달하기

지금까지

Markdown 파일을 그대로 전달

⇨ AI를 위한 지시서로서 텍스트만 있는 심플한 Markdown 파일을 전달하여 작업을 의뢰했다

앞으로

완성 이미지를 시각적으로 알 수 있는 HTML 목업 (Mockup) 등을 그대로 참조 자료로 전달한다

⇨ AI가 인간의 "고집"이나 "요구하는 퀄리티"를 더 높은 정밀도로 재현할 수 있게 되었다

재검토 포인트

CLAUDE.md는 무조건 심플하게 만들기

폴더 구조를 보면 알 수 있는 당연한 내용은 쓰지 말고, 프로젝트 특유의 함정이나 주의점만을 응축해서 작성한다.

/checkup (/doctor) 실시

Claude Code에서는 /doctor를 사용함으로써 설치 상태나 설정 파일, MCP 서버, 플러그인/스킬, 권한 설정 등을 횡단적으로 진단할 수 있습니다.

현재의 /doctor는 진단할 뿐만 아니라, 사용되지 않는 스킬이나 MCP, 플러그인의 정리, 중복되거나 비대해진 CLAUDE.md의 재검토 등 환경의 퍼포먼스와 컨텍스트 효율을 높이기 위한 수정도 제안해 줍니다.

/checkup은 /doctor의 에일리어스 (Alias)입니다. 변경 사항이 멋대로 적용되지 않고 실행 전에 확인을 요청하므로, 내용을 확인한 후 조정할 수 있습니다.

다음 기사가 매우 이해하기 쉬웠습니다...!!!

요약

우선은 새로운 세션에서 /checkup (/doctor)을 실행합시다!

참고

Discussion