콘텐츠 원천 소스
여러 시스템에 복사되는 콘텐츠 중 무엇을 최종 기준으로 삼을지 정한 원본 위치를 말한다. Vive Coding 365 같은 AI 운영 사이트에서는 로컬 JSON을 원천 소스로 두고, Turso DB를 공개 런타임 미러로 두면 검수·백업·재동기화가 쉬워진다. AI가 DB에 직접 임의 데이터를 넣는 구조보다, 원천 JSON 검증 후 업로드하는 구조가 추적성과 품질 관리에 유리하다.
영어 표기
Content Source of Truth
예시
뉴스 글은 content/posts/news JSON을 원천으로 삼고, 업로드 스크립트가 같은 내용을 posts 테이블에 저장한다. 화면이 이상하면 DB를 직접 고치기보다 원천 JSON과 DB 동기화 상태를 먼저 비교한다.
참고
위키피디아 링크는 일반 개념 참고용이며, 실제 구현은 프로젝트의 스키마와 운영 규칙을 기준으로 해야 한다.
카테고리
컨텍스트 엔지니어링
난이도
basic
태그
콘텐츠 · 원천
함께 읽기
연관 용어
CLI·터미널 도구
터미널
영어 표기 Terminal
터미널은 키보드로 명령을 입력해 개발 환경을 조작하는 화면이다. 초보자에게는 검은 창처럼 보이지만, 실제로는 설치, 테스트, 빌드, Git 작업, AI 코딩 에이전트 실행을 한곳에서 연결하는 작업대에 가깝다. VIBE 코딩에서는 AI가 제안한 명령을 그대로 복사하기 전에 현재 폴더, 변경 파일, 실행 목적을 확인하는 습관이 중요하다. 터미널 출력은 실패 원인과 검증 결과를 가장 직접적으로 보여주므로, 화면을 닫기보다 에러 메시지를 읽고 필요한 부분만 AI에게 다시 전달해야 안전하다.
컨텍스트 엔지니어링
컨텍스트 엔지니어링
영어 표기 Context Engineering
AI 모델에게 '무엇을 보여줄 것인가'를 설계하는 기술로, 컨텍스트 윈도우에 정확히 필요한 정보만을 적절한 양과 형태로 제공하여 모델의 응답 품질을 극대화하는 것이 목표이다. 프롬프트 엔지니어링이 '무엇을 물을 것인가(질문의 설계)'에 집중한다면, 컨텍스트 엔지니어링은 '모델이 무엇을 볼 수 있는가(정보의 설계)'에 집중한다. 핵심 원칙은 '너무 많지도, 너무 적지도 않은 정보 제공(Goldilocks principle)'이다. 10만 줄 코드베이스에서 AI가 '결제 모듈 리팩토링'을 수행할 때, 전체 코드를 넣으면 컨텍스트 부패(Context Rot)가 발생하고, 결제 파일만 넣으면 의존성을 놓친다. 결제 관련 파일 + API 스키마 + 테스트 코드 + CLAUDE.md의 아키텍처 섹션만 제공하는 것이 최적이다. 구체적인 기법으로는 CLAUDE.md/AGENTS.md(프로젝트 규칙 파일), .cursorrules(IDE 설정), RAG(외부 데이터 검색), 코드베이스 인덱싱(자동 검색), 점진적 공개(단계별 정보 제공) 등이 있다. 관계 정리: 프롬프트 엔지니어링(무엇을 묻는가) ⊂ 컨텍스트 엔지니어링(모델이 무엇을 보는가) ⊂ 하네스 엔지니어링(전체 시스템이 어떻게 운영되는가).
컨텍스트 엔지니어링
CLAUDE.md / AGENTS.md
영어 표기 CLAUDE.md / AGENTS.md
프로젝트 루트 디렉토리에 배치하는 마크다운 파일로, AI 에이전트에게 프로젝트의 아키텍처, 코딩 컨벤션, 빌드·테스트 명령어, 기술 스택, 제약 조건 등을 알려주는 '프로젝트 지도(map)' 역할을 한다. Claude Code에서 /init 명령어로 자동 생성할 수 있으며, AI가 프로젝트를 처음 접할 때 가장 먼저 읽는 파일이다. 잘 작성된 CLAUDE.md는 AI 에이전트의 코드 생성 품질을 극적으로 향상시키며, 반대로 이 파일이 없으면 AI가 프로젝트의 패턴과 규칙을 이해하지 못해 일관성 없는 코드를 생성한다. Mitchell Hashimoto(하네스 엔지니어링 창시자)는 AGENTS.md를 반복적으로 개선하는 것을 하네스 엔지니어링의 핵심 활동으로 제안했다. 구체적 방법론은: AI 에이전트가 실수를 했을 때, 같은 실수를 반복하지 않도록 해당 규칙을 AGENTS.md에 추가하는 것이다. 시간이 지남에 따라 AGENTS.md는 프로젝트의 모든 '암묵적 규칙'이 명시화된 문서로 성장한다. CLAUDE.md는 Claude Code 전용이고, AGENTS.md는 도구 독립적인 범용 이름이며, 기능과 목적은 동일하다.