에이전트는 코드를 읽습니다.컨텍스트코드로 표현할 수 없는 내용, 즉 결정 사항, 제약 조건 및 관례를 저장하는 공간입니다.
여기에 포함되는 내용의 근거는 다음 문서에서 확인할 수 있습니다.프로젝트 컨텍스트개념 항목의 ‘프로젝트 컨텍스트’에서 해당 내용을 확인하고 관리 방법도 알아보세요.
컨텍스트 추가하기
프로젝트의컨텍스트섹션을 열고 항목을 추가하세요. 각 항목은 제목과 본문으로 구성되며 나중에 수정하거나 삭제할 수 있습니다.
좋은 항목은 짧고 구체적이며 변경되지 않는 내용이어야 합니다. 아키텍처 결정 사항, 스타일 관례, API 계약, 소유권 경계 및 명시적인 금지 사항 등이 여기에 해당합니다. 온보딩 관련 내용이나 저장소에서 이미 명확히 알 수 있는 정보는 제외됩니다.
항목은 별도로 작성하고 명확한 이름을 지정하세요.
하나의 주제당 하나의 항목을 만들고 그 내용을 반영하는 제목을 붙이세요. '오류 처리 관례'와 '사용이 중단된 모듈'은 쉽게 찾을 수 있지만, 두 가지 내용을 모두 포함하는 '참고 사항'이라는 단일 항목은 검색이 어렵습니다.
이는 컨텍스트가 현재 작업에 따라 선택적으로 로드되기 때문입니다. 자세한 내용은단계별 역량을 참고하세요. 잘 분리된 항목은 각 작업에 맞는 올바른 정보를 제공합니다.
참조 자료
텍스트 형태의 항목 외에도 참조 자료를 첨부할 수 있습니다. 이는 위키나 디자인 도구에 저장된 공식 문서를 가리키는 링크 및 문서로, 중복된 사본으로 인한 정보 불일치를 방지하기 위해 사용됩니다.
작업별 컨텍스트
프로젝트 수준의 컨텍스트는 프로젝트 내 모든 작업에 적용됩니다. 특정 작업, 즉 티켓, 고객 보고서, 디자인 문서와 관련된 자료는 해당 작업에 직접 첨부해야 합니다. 프로젝트 컨텍스트에 작업별 메모를 남기면 이후 모든 작업에서 불필요한 정보로 작용합니다.
최신 상태 유지하기
오래된 컨텍스트는 누락된 컨텍스트보다 더 해롭습니다. 에이전트는 이를 공식적인 정보로 간주하기 때문입니다. 관례가 변경되면 코드 변경과 동시에 해당 항목도 업데이트해야 합니다.
기존 컨텍스트 확인하기
가끔은 마치 처음 접하는 사람처럼 컨텍스트를 읽어보세요. 항목이 점점 쌓이면서 1년 전에 작성된 마이그레이션 관련 항목이 현재에는 오해의 소지가 있을 수 있습니다.