클로드 코드 + 이 단순 프롬프트 = 놀라운 코드 품질

채널 아이콘
Income stream surfers 구독자 130,000명

요약

이 영상은 Claude Code에서 빠르고 간단하게 ‘컨텍스트 엔지니어링’을 구현하는 방법을 공유합니다. 여러 개의 MD 파일(claw.md, implementation.md 등)을 생성하고 claude.md에서 참조해 주는 핵심 구조를 설명합니다. 특히 구현 파일 생성 시 심층 리서치를 통해 더 완성도 높은 코드 품질을 달성하는 비법을 소개합니다. 마지막으로 /memory 기능을 활용해 프로젝트 메모리를 유지하는 실전 팁을 전합니다.

주요 키워드

컨텍스트 엔지니어링 implementation.md claude.md 메모리 기능 스크래핑 프롬프트 Claude Code 심층 리서치 모델 버전 선택 커뮤니티

하이라이트

  • 🔑 핵심 구조: 하나의 MD 파일이 아니라 claw.md, implementation.md, feature.md 등 여러 파일로 나누어 컨텍스트를 관리해야 합니다.
  • ⚡️ 간단 참조: claude.md 안에 다른 MD 파일 경로를 명시하면 Claude가 프로젝트 전반을 기억하도록 할 수 있습니다.
  • 🌟 심층 리서치: 기본 스크래핑을 넘어 여러 페이지를 깊이 탐색해 구체적인 예시를 implementation.md에 담아야 합니다.
  • 📌 비교 실험: 기존 Context Engineering GitHub 레포의 표면적 결과보다 훨씬 풍부하고 정확한 리서치를 제공하는 방식을 제시합니다.
  • 🚀 메모리 활용: /memory로 implementation.md를 항상 참조하고 진행된 작업과 남은 작업을 관리해 코드 퀄리티를 유지합니다.
  • 📌 모델 버전 선택: 기본 Claude 3.5 Sonnet 대신 Claude 4 Force On 모델을 명시해 코드 생성 성능을 극대화할 수 있습니다.
  • 🌟 커뮤니티 참여: 영상에서 다루지 않은 추가 팁과 업데이트는 제작자 커뮤니티를 통해 가장 먼저 확인할 수 있습니다.

용어 설명

컨텍스트 엔지니어링(Context Engineering)

여러 파일과 프롬프트를 체계적으로 구성해 AI 모델이 프로젝트 전반을 이해하게 만드는 기법입니다.

claude.md

프로젝트 개요와 다른 MD 파일 참조 정보를 담는 핵심 파일로, Claude의 메모리 루트 역할을 합니다.

implementation.md

구체적인 기능 구현과 리서치 결과, 코드 예시를 기록해 Claude가 계속 참조하도록 하는 파일입니다.

/memory

Claude Code에서 프로젝트 상태와 참조할 파일을 지속적으로 저장해 두는 명령어 기능입니다.

스크래핑(Scraping)

웹 페이지의 문서를 자동으로 수집해 필요한 정보를 추출하는 과정을 의미합니다.

[00:00:00] 영상 소개 및 비밀 소스 예고

영상 초반에 앞으로 보여줄 비밀 소스와 Claude Code를 활용한 간단한 팁을 예고하며 시청자의 흥미를 유발합니다.

Claude Code와 함께 사용할 수 있는 비밀 소스와 컨텍스트 엔지니어링 방법을 소개합니다. 지난 3-4개월 동안 개발한 빠르고 쉬운 방법을 공개합니다.
[00:00:17] 컨텍스트 엔지니어링 개념 정리

‘컨텍스트 엔지니어링’이란 무엇인지, 지난 몇 개월간 자신이 실험해 온 방식을 간략히 정리합니다.

Claude Code 작업시 MD 파일들의 중요성을 설명합니다. 단일 MD 파일이 아닌 여러 개의 MD 파일이 필요하며, claude.md, implementation.md, design.md 등이 필요합니다.
[00:00:43] 다중 MD 파일 구조 소개

claw.md, implementation.md, design.md(또는 feature.md)처럼 프로젝트 문서를 분리해 구성해야 하는 이유와 각 역할을 설명합니다.

대부분의 사람들이 범하는 중요한 실수를 지적합니다. claude.md 안에서 다른 MD 파일들을 참조해야 하며, 그렇지 않으면 Claude가 implementation.md를 잊어버립니다.
[00:01:35] implementation.md 파일 생성 실습

Claude Code에서 새로운 폴더를 만들고 복잡한 프롬프트 없이 implementation.md를 생성해 구체 리서치를 수행하는 과정을 시연합니다.

스쿨 커뮤니티에서 지난 몇 주 동안 이 시스템을 개발해왔다고 소개하며, 기술적인 implementation.md 파일 생성의 중요성을 강조합니다.
구현 파일을 만드는 방법을 소개하며, 콜 메딘의 컨텍스트 엔지니어링 GitHub 리포지토리의 한계점을 지적합니다. 특히 리서치 단계에서의 문제점과 해결 방법을 제시합니다.
[00:02:39] 심층 리서치 비교

일반 Context Engineering 레포의 표면적 리서치와 자신이 제안하는 다단계 스크래핑 방식의 차이를 실제 화면으로 비교합니다.

화자가 자신만의 다른 버전을 사용한다고 설명하며, 이전에 시도했던 무거운 프롬프트를 보여준다. 그 프롬프트로 얻은 리서치 결과가 끔찍했다고 평가한다.
Claude Code에서 새로운 폴더를 만들고 implementation 파일을 생성하기 시작한다. 콜의 시스템으로 구축하려 했지만 좋은 경험을 하지 못했다고 언급한다.
자신의 방식을 설명하며, 기본 수준이 아닌 매우 상세한 리서치가 필요하다고 강조한다. 나머지 구현 작업은 간단한 할 일 목록으로 처리할 수 있다고 말한다.
시스템이 많은 세부사항을 포함하여 컨텍스트 엔지니어링 예제보다 훨씬 나은 작업을 할 것으로 예상한다고 말한다. 모든 내용을 implementation.md 파일에 저장하여 메모리에서 참조할 수 있게 한다.
콜의 시스템이 하지 못했던 중요한 차이점을 설명한다. 한 페이지만 스크래핑하는 대신 여러 페이지를 깊이 스크래핑한다는 점이다.
시스템이 엄청난 양의 리서치를 수행하며 implementation.md에 구체적인 예제들을 출력한다고 설명한다. 이 단계가 많은 도구들이 실패하는 부분이라고 지적한다.
화자가 보통 하는 방식으로 더 깊이 있는 연구를 진행하겠다고 설명하지만, 영상 시간상 구현 파일로 바로 진행하기로 결정
기존 시스템의 문제점을 지적 - 연구가 너무 피상적이고 Claude 3.5 소네트 사용 등 부족한 연구 수준 때문에 해당 시스템 사용을 중단
두 시스템으로 생성된 파일들을 비교 - 기존 시스템은 697줄, 새로운 방식은 약 2,000줄로 훨씬 포괄적이고 우수한 결과물 생성
[00:08:08] 생성된 구현 파일 평가

생성된 implementation.md의 라인 수, 내용 밀도, 예시 코드 등을 비교하며 새 방식이 더 포괄적이고 실용적임을 강조합니다.

실제 사용 방법 설명 - /memory 명령어로 프로젝트 메모리 설정, implementation.md 참조 및 작업 목록 유지하는 방법 안내
[00:09:10] /memory 기능 활용법

/memory project memory 명령어로 implementation.md를 항상 참조하도록 설정하고 작업 리스트를 기록해 두는 방법을 안내합니다.

화자의 철학과 마무리 - '엔지니어링'이라는 용어에 대한 거부감 표현, 자신을 '바이브 코더'라고 소개하며 영상 마무리
[00:10:01] 결론 및 커뮤니티 초대

프롬프트 및 컨텍스트 팁을 요약하고, 추가 노하우는 제작자 커뮤니티(스쿨 커뮤니티)를 통해 확인할 것을 권장하며 마무리 인사를 전합니다.

타임라인 정보가 없습니다.

이 영상에서 여러분께 비밀 소스를 공개하겠습니다.
특히 영상 후반부에서 Claude Code와 관련해
아직 다른 사람들이 이야기하지 않은
제가 본 적 없는 내용을 다룰 예정입니다.
Claude Code에 대한 이야기죠.
바로 시작해보겠습니다.
기본적으로 이제 모든 사람들이
컨텍스트 엔지니어링에 대해 이야기하고 있습니다.
제가 어떻게 컨텍스트 엔지니어링을 하는지
그리고 지난 3-4개월 동안
어떻게 컨텍스트 엔지니어링을 해왔는지
특히 지난 1-2개월 동안 클로드 코드와 함께
어떻게 해왔는지 알려드리겠습니다.
실제로 저는 컨텍스트 엔지니어링을
믿을 수 없을 정도로 빠르고
믿을 수 없을 정도로 쉽게
그리고 믿을 수 없을 정도로 간단하게 하는 방법을 찾았습니다.
복잡한 것들은 없습니다.
Claude Code로 작업할 때 주요한 것 중 하나는
MD 파일들입니다. 하지만 많은 사람들이
혼동하는 것은 단일 MD 파일 하나만
있으면 충분하다고 생각한다는 것입니다.
그렇지 않습니다. 여러 개의 MD 파일이 필요합니다.
첫 번째는 claude.md입니다.
이것은 명백히 가장 중요한 것입니다.
이것은 프로젝트의 개요를 포함합니다.
두 번째는 implementation.md입니다.
그리고 세 번째는 design.md 같은 것이거나
새로운 기능을 만드는 경우
feature.md를 가질 수 있습니다.
하지만 사람들이 혼동하는 것이 있고
이것이 많은 사람들이 잘못하는 부분입니다.
지금 바로 말씀드리겠습니다.
이것이 아마도 여러분이
여기서 잘못하고 있는 부분일 것입니다.
claude.md 안에서 다른 MD 파일들을
참조해야 합니다.
그게 무슨 뜻일까요? implementation.md 파일을
생성하면
제가 정확히 어떻게 하는지
이 영상에서 보여드리겠습니다.
영상 후반부에서요.
그러니까 끝까지 시청해주세요.
Claude의 메모리에 implementation.md 파일이 있다는 것을
사용해야 한다고 알려줘야 합니다.
그 이유는 slash compact를 실행할 때
죄송합니다, slash compact를 실행할 때
맞습니다.
implementation.md를 잊어버리고
implementation.md를 읽지 않고
그냥 넘어갈 것이기 때문입니다.
이것은 지난 몇 주 동안
제 스쿨 커뮤니티에 있었습니다.
지난 몇 주 동안 이 전체 시스템을
작업해왔습니다. 모든 것이 여기에 있습니다.
제가 비디오를 만들기 전에
미리 보시고 싶다면
스쿨 커뮤니티를 확인해보세요.
이 영상 설명란의 첫 번째 링크가
그것입니다. 하지만 여기서 보실 수 있듯이
기술적인 implementation.md 파일을
생성한다고 되어 있습니다.
제가 말했듯이, 그것이 제가 좋아하는 방식입니다.
그렇다면 특정 구현 파일을 어떻게 만들까요?
만약 여러분이 콜 메딘의
컨텍스트 엔지니어링 GitHub 리포지토리를
사용하고 있다면
지금 바로 말씀드리겠습니다.
리서치 단계에서는 제대로 작동하지 않습니다.
어떻게 해결할 수 있는지 보여드리겠습니다.
만약 콜의 컨텍스트 엔지니어링과 함께
사용하고 싶다면 자유롭게 사용하세요.
아니면 제가 사용하는 방식으로 사용하셔도 됩니다.
거의 같은 것입니다.
단지 이것이 더 복잡한 버전일 뿐입니다.
더 좋다는 것은 아닙니다.
더 좋다고 말하는 것도 아니고
더 나쁘다고 말하는 것도 아닙니다.
모르겠어요. 저는 그냥 조금 다른
버전을 사용하거든요. 네, 그럼 제가 실제로
여러분들에게 제가 시도했던 프롬프트를 보여드리겠습니다.
보시다시피 꽤 무거운
프롬프트죠. 이게 제가 사용한 겁니다. 음,
그리고 이것이 제공한 리서치는
정말 끔찍했어요. 맞죠? 그래서 대신에
우리가 할 일은
여기 Claude Code로 가는 겁니다. 새로운
폴더를 시작하죠. MKD 비디오 예제 5번이라고 하겠습니다.
혹시 이미 하나 있을 수도 있으니까요.
어, 그리고 여기서 실행하겠습니다. 그리고
저는 implementation
파일을 만들어달라고 할 겁니다.
오, 이미 하나 있네요.
문제가 있었네요. 죄송합니다. 잠깐만요. 이걸 붙여넣겠습니다.
이건 제가 만들려고 했던 프롬프트입니다. 음, 제
콜의 시스템으로 구축하려고 했던 것들에서 가져온
건데, 그다지 좋은
경험을 하지 못했어요. 그래서 대신에
제가 어떻게 하는지 보여드리겠습니다. 맞죠?
기본적으로 이게 전부입니다. 여기에는 특별한
것이 없어요. 제가 필요한 것은 이런 것들에 대해
좋고 철저한 리서치를 하는 것뿐입니다.
기본 수준의 리서치를 하면 안 됩니다.
이런 각각의 토픽에 대해 매우
상세한 리서치를 해야 합니다.
그것이 실제로 필요한 것입니다.
나머지 것들, 예를 들어 하나씩 구현하는 것 같은
건 간단한 할 일 목록으로
처리할 수 있어요. 맞죠?
그래서
보시다시피 여기에 많은
세부사항이 있습니다. 음, 그리고 이게
실제로, 솔직히 말하면 이게
컨텍스트 엔지니어링 예제보다 훨씬 더 나은
작업을 할 것 같습니다. 그리고
이 모든 것을 implementation.md
파일에 넣고
그 다음부터는 메모리에서 그것을 참조할 수 있습니다.
그리고 그것이 어떻게 작동하는지 잠시 후에 보여드리겠습니다.
그래서 여기서 예라고 하겠습니다.
이 모든 것을 가져올 겁니다. 보시다시피
가져오고 있지만, 바라건대 하나만 가져오는 게 아니라
여러 개를 가져올 겁니다.
여러 개를 가져올 겁니다. 네, 이제
중요한 부분입니다. 이게 콜의
시스템이 저에게는 구체적으로
해주지 않았던 것입니다.
네, 보시다시피 한 페이지만 스크래핑하는 대신에
각각에 대해 여러 페이지를 깊이
스크래핑하고 있습니다. 맞죠?
어떤 이유로 이것이 403 오류로 실패하고 있습니다.
아마 Cloudflare가 있을 겁니다. 그들이
Cloudflare를 가지고 있다고 해도 놀랍지 않을 거예요.
보시다시피 quick start에 대한
특별한 스크래핑을 하고 있습니다. queries products에 대한
특별한 스크래핑을 하고 있습니다. SEO grove에 대한
특별한 스크래핑을 하고 있습니다. 이것도
프롬프트의 일부였습니다. 더 많은 문서를 계속
수집하겠습니다. 그래서 여기서
차이점을 볼 수 있습니다. 이것은
실제로 엄청난 양의
리서치를 하고 있습니다. 그리고 이것이 할 일은
implementation.md에 구체적인
예제들을 출력하는 것입니다.
이것이 많은 이러한 도구들이 실패하는 부분입니다.
제 생각에는 이 단계를 충분히 잘 해내지 못하거든요.
그래서 웹마스터 도구가 보입니다.
맞죠? 그게 어, 서치
콘솔 관련 내용입니다. OpenAI는 스크래핑하지 않고 있네요.
아마 Gina 같은 것을 사용해야 할 것 같지만
나머지는 잘 작동하는 것 같습니다.
네, 그래서 저는 아마 더 깊이
들어갈 것 같습니다.
이걸 더 깊게 들어가겠죠? 제가 보통 하는 방식은
지금 이 영상에서는 안 하겠지만
보통 제가 하는 방식은
여기서 멈추고 말하는 거예요
계속해서 더 깊이 있는 연구를 해줘
관련된 더 많은 페이지들을 찾아보라고 하죠
어, 잠깐. 그게 맞네요
하지만 지금은 그냥
사실 그냥 구현 파일로
계속 진행하라고 하겠어요
이렇게 하는 이유는
그냥 영상을 마무리하고 싶어서예요
너무 오래 끌고 싶지 않거든요
하지만 개인적으로는
계획하고 또 계획하고 계속 계획하죠
하지만 핵심은
연구입니다
이 시스템에서 정말 마음에 들지 않는 건
연구가 너무 피상적이라는 거예요
이게 완벽한 예시죠
여기 연구는 엉망이에요
Claude 3.5 소네트를
사용하고 싶지 않아요
아무도 그러지 않죠. 모두가 원하는 건
Claude 4 소네트입니다
연구 수준이 부족했던 걸
볼 수 있죠. 그래서 이 시스템을
계속 사용하지 않은 거예요
여전히 이 시스템이나
뭐든 간에 좋은 점들이 많다고 생각해요
단지 이 부분이 저에게는
치명적인 단점이에요
여기서 한번 보시죠
댓글을 달기 전에 실제로
한번 스크롤해서 올려보죠
이건 정말 대단한데요
정말 많네요
실제로 여기에 얼마나 많은
내용이 있는지 보세요
어떻게 더 빨리 스크롤하죠?
아직도 계속되네요. 정말 대단해요
와, 알겠어요
정말 많았네요. 이제 비교해보죠
여기서 예라고 하고
마지막 단계를 보여드리면서
이 둘을 비교해보죠
이건 바이브 엔지니어링이 아니라
컨텍스트 엔지니어링 시스템으로
만들어진 거예요
이건 697줄이죠
여기 이것은 분명히
공백과 여러 내용들이 있지만
아마 2,000줄 정도
될 것 같아요
완전히 놀랍죠
여기에 정말 많은 내용이 있어요
줄 수는 사실
중요하지 않죠
전체적으로 봤을 때
방금 만든 것이
더 포괄적일 뿐만 아니라
실제로 더 좋다고 생각해요
Claude 4를 사용했는지
한번 확인해보죠
소네트, 소네트
소네트
아, 3.5 소네트네요. 전형적이죠
AI는 자기 자신을 코딩하는 걸
못 하는 걸로 집착하네요
정말 짜증나요
소네트 4를 사용하라고 분명히 말했는데
괜찮아요. 나중에 모델을 바꾸면 되죠
그럼 이걸 어떻게 사용할까요?
/memory를 해야 해요
프로젝트 메모리라고 하고
항상 implementation.md를
참조하고 무엇을 했고
다음에 무엇을 할지 작업 목록을 유지하라고
하고 나서 나가서 저장하고
엔터를 치면
다시 메모리를 하면
프로젝트 메모리가 저장된 걸 볼 수 있어요
/compact를 실행하거나 뭘 해도
이전 데이터가 여전히 남아있어요
말했듯이 저는 보통
더 많은 연구를 하죠
보통은 훨씬 더 꽉 차있겠지만
여기 연구가 컨텍스트 엔지니어링 시스템만큼
좋거나 더 좋다는 걸 볼 수 있어요
이것도 컨텍스트 엔지니어링이에요
어떤 단어든 뒤에 엔지니어링이라는
단어가 붙는 걸 싫어해요
프롬프트 엔지니어링, 컨텍스트 엔지니어링
그냥 거창해 보이려는 것 같아요
저는 엔지니어가 아니에요
저는 바이브 코더예요
시청해 주셔서 정말 감사합니다
끝까지 보신 분들은
정말 대단해요
스쿨 커뮤니티를 확인해 보시고, 곧 더 많은 콘텐츠로 만나뵙겠습니다. 안녕히 계세요.