에이전트는 사용자의 코드와 저장소 내의 지침 파일을 읽습니다.컨텍스트는 해당 메모리 파일들을 프로젝트 노트, 생성된 컨텍스트 및 참조 자료와 통합합니다.
여기에 포함된 내용의 배경을 알고 싶다면 다음을 읽어보세요.프로젝트 컨텍스트에 대한 내용은 개념 항목에서 확인할 수 있으며, 이 페이지에서는 해당 컨텍스트를 관리하는 방법을 다룹니다.
저장소 메모리 파일
다음을 열어보세요:설정 → 지식 → 컨텍스트로 이동하여아래 영역을 확인하세요.저장소 소스.Coroid는 연결된 저장소에서 다음 파일들을 읽습니다:
AGENTS.md저장소 루트에 위치한 일반 에이전트 지침 파일CLAUDE.md저장소 루트에 위치한 Claude 지침 파일GEMINI.md저장소 루트에 위치한 Gemini 지침 파일.cursor/rules: 지원되는 Cursor 규칙 파일
이러한 파일들은 흔히 메모리 파일이라고 불리며, 활성화된 내용은 작업 시작 전에 에이전트의 프로젝트 컨텍스트에 포함됩니다. 파일명으로 특정 모델을 제한하지 않으며, 활성화된 소스들은 Coroid의 에이전트들에 의해 결합되어 사용됩니다.
기존 파일에는편집버튼이 표시되며, 예상 토큰 수와 에이전트가 해당 파일을 읽도록 하는 스위치가 함께 제공됩니다. 소스는 명시적으로 비활성화하지 않는 한 기본적으로 활성화 상태입니다. 여러 파일이 내용이 중복되거나 상충하는 경우, 에이전트가 따라야 할 소스만 활성화하고 나머지는 비활성화하세요.
생성표시는 해당 파일이 Coroid의 저장소 체크아웃에 존재하지 않음을 의미합니다. 파일 읽기 작업이 실패하면 페이지에다시 시도버튼이 나타납니다. 접근 오류가 발생했다고 해서 파일이 없는 것은 아닙니다. 연결된 저장소의 브랜치에 해당 파일이 커밋되었는지 확인하세요. 작업 실행 시 에이전트는 작업의 체크아웃 내용을 읽으므로, 해당 브랜치의 지침 파일 변경 사항이 작업에 즉시 적용됩니다.
활성화된 메모리 파일은@path를 이용해 저장소의 Markdown 내용을 가져올 수 있습니다. 예시:@AGENTS.md내부의CLAUDE.md또는@docs/conventions.md태그를 사용하면 됩니다. 경로는 참조가 포함된 파일을 기준으로 해석됩니다. Coroid는 중첩된 임포트를 처리하고 순환 참조를 방지하며, 동일한 파일과 지침 내용은 한 번만 포함시킵니다. 코드 예시나 이메일 주소 내의 참조는 그대로 유지되며, 저장소 외부의 참조는 로드되지 않습니다. 또한 명시적으로 비활성화된 저장소 소스를 우회하는 임포트도 허용되지 않습니다.
자동으로 감지되는 것은 위에 나열된 루트 소스뿐입니다. 중첩된AGENTS.md및 개별.cursor/rules/*.mdc파일은@임포트를 통해 포함시킬 수 있지만, 해당 디렉터리 범위는 자동으로 인식되지 않습니다.
앱 컨텍스트
아래의앱 컨텍스트영역에서는 Coroid에 저장된 지침 및 참조 자료를 관리할 수 있습니다. 수동으로 작성한 노트와 생성된 프로젝트 컨텍스트는 저장소 파일과 별개로 활성화하거나 비활성화할 수 있습니다. Git 외부에 속하는 정보를 저장할 때 이 기능을 활용하세요.
컨텍스트 추가하기
다음을 선택하세요:컨텍스트 추가버튼을 눌러 항목을 추가하세요. 각 항목에는 제목과 본문이 있으며, 이후에 편집하거나 삭제할 수도 있습니다.
좋은 항목은 짧고 구체적이며 오랫동안 유지될 수 있어야 합니다. 아키텍처 결정 사항, 스타일 규칙, API 계약 조건, 소유권 경계 및 명시적인 금지 사항 등이 여기에 해당합니다. 온보딩 관련 내용이나 저장소에서 이미 명확히 알 수 있는 정보는 포함하지 마세요.
항목은 별도로 구분하고 명확하게 명명하세요
하나의 주제당 하나의 항목을 만들고, 그 내용을 반영하는 제목을 붙이세요. '오류 처리 규칙'과 '사용 중지된 모듈'은 검색이 가능하지만, 두 내용을 모두 포함한 '참고 사항'이라는 단일 항목은 검색이 어렵습니다.
이는 작업 내용에 따라 컨텍스트가 선택적으로 로드되기 때문이며, 자세한 내용은단계별 역량항목을 참고하세요. 잘 구분된 항목들은 올바른 작업에 맞는 컨텍스트가 정확히 로드될 수 있도록 도와줍니다.
참고 자료
서면으로 작성된 내용 외에도 참조 자료를 첨부할 수 있습니다. 이는 다른 곳에 저장된 링크나 문서로, 권위 있는 사본이 위키나 디자인 도구에 존재하고 중복 사본이 오래되어 내용이 일치하지 않는 상황을 방지하기 위해 사용됩니다.
작업별 컨텍스트
프로젝트 전체에 적용되는 컨텍스트는 프로젝트 내의 모든 항목에 영향을 미칩니다. 특정 업무와 관련된 자료—티켓, 고객 보고서, 디자인 문서 등—는 해당 작업에 직접 첨부해야 합니다. 프로젝트 컨텍스트에 작업별 메모를 남기면 향후 다른 작업에서 불필요한 정보가 되어 혼란을 초래합니다.
항상 최신 상태로 유지하기
오래된 컨텍스트는 컨텍스트가 없는 경우보다 더 심각한 문제를 야기합니다. 에이전트가 이를 권위 있는 정보로 간주하기 때문입니다. 규칙이 변경될 경우 코드 변경과 동일한 커밋에서 해당 컨텍스트 항목도 함께 업데이트해야 합니다.
기존 컨텍스트 확인하기
가끔은 마치 처음 보는 사람처럼 컨텍스트를 읽어보세요. 항목이 점점 쌓이면서 1년 전에 완료된 마이그레이션 과정에서 작성된 내용이 현재에는 오해를 불러일으킬 수 있습니다.