이 페이지는 AI 어시스턴트인 Claude Code, Codex, Cursor 또는 웹 페이지를 읽고 사용자의 로컬 저장소에서 작업할 수 있는 모든 어시스턴트를 위한 가이드라인입니다. 이 가이드는 어시스턴트가 하나 이상의 저장소에 대해 Coroid를 설정하도록 안내합니다. 로그인, 접근 권한 부여, 비밀번호 입력, 변경 사항 승인 등 사람만 수행할 수 있는 단계마다 사용자에게 요청합니다.
어시스턴트에게 이 가이드를 전달하세요.
Coroid가 작업할 저장소에서 어시스턴트를 열고 다음 프롬프트를 입력하세요:
Set up Coroid for this repository. Follow the runbook at
https://coroid.ai/docs/export/en-US/getting-started/assistant-setup.md
step by step. Ask me before you change anything, and never ask me to paste a
password or token into this chat.여러 개의 저장소를 처리하려면 이들 모두를 포함하는 디렉터리에서 어시스턴트를 열고 프롬프트에 저장소 이름을 명시하세요. 어시스턴트가 검사 및 확인을 수행한 뒤, 사용자가 개입해야 하는 각 단계에서 정확히 어떤 작업을 해야 하는지 알려줍니다.
어시스턴트를 위한 기본 규칙
Coroid는 작업 설명을 사용자의 저장소에 있는 테스트 완료 및 리뷰된 pull request로 변환하는 호스팅형 AI 소프트웨어 제조 플랫폼입니다. 다음 규칙을 반드시 준수하세요:
- 사용자가 행동하고, 어시스턴트가 준비합니다.어시스턴트는 사용자를 대신해 가입, 로그인, 이용 약관 동의, 앱 설치 또는 접근 권한 부여를 할 수 없습니다. 정확히 어떤 작업을 어디서 수행해야 하는지 알려준 뒤, 사용자가 완료를 확인할 때까지 기다려야 합니다.
- 대화 내용에 비밀 정보를 포함하지 마세요.절대 비밀번호, 개인용 액세스 토큰, 공급자 키 또는 MCP 토큰을 요청하지 마세요. 사용자는 Coroid 포털이나 자체 셸에 비밀 정보를 입력합니다. 만약 채팅창에 이러한 정보가 잘못 입력된 경우, 사용자에게 해당 토큰을 취소하고 새로 발급하도록 안내하세요.
- 변경 사항 적용 전에 항상 확인하세요.사용자의 저장소, Coroid 프로젝트 및 초대장에 대한 커밋, 브랜치, 풀 리퀘스트 등을 처리합니다.
- 다음 단계로 진행하기 전에 각 단계를 반드시 확인하세요.검증에 실패한 경우 해당 단계의 안내를 따르고, 검증이 통과되거나 사용자가 건너뛰기로 결정할 때만 다음 단계로 진행하세요.
- 추측이 아닌 제품의 안내를 따르세요.포털에 이 가이드에 설명되지 않은 항목이 표시되는 경우, 사용자에게 보이는 내용을 알려주고 포털의 안내를 따르세요. 설정을 임의로 만들어내지 마세요.
- 설정 기록을 남겨두세요.최종 결과를 위해 각 단계와 그 결과를 반드시 기록하세요.
각 단계는 해당 페이지와 세부 정보를 연결합니다.https://coroid.ai/llms.txt전체 문서 내용을 색인화합니다.
1단계: 계획을 합의하세요.
다음 질문들을 한 번에 묻되, 개별적으로 묻지 마세요:
| 질문 | 중요성 |
|---|---|
| Coroid가 작업할 저장소는 어느 것인가요? | 저장소당 프로젝트는 하나씩입니다. |
| GitHub 또는 GitLab? 개인이 소유하는가요, 아니면 조직이 소유하는가요? | 이 선택에 따라 Coroid의 연결 방식과 승인 담당자가 결정됩니다. |
| Coroid가 풀 리퀘스트를 생성해야 하나요 (동기화됨), 아니면 처음에는 Coroid 내부에서 작업을 진행해야 하나요 (로컬 전용)? | 로컬 전용 모드에서는 저장소에 데이터를 절대 기록하지 않습니다. |
| 이미 존재하는 Coroid 조직이 있고, 사용 중인 요금제는 무엇인가요? | 무료 요금제는 프로젝트 하나만 지원하며 다른 멤버를 추가할 수 없습니다. |
| 누가 작업을 리뷰하고, 그 역할은 무엇인가요? | 멤버를 초대하려면 Professional 요금제가 필요합니다. |
| Coroid가 조직에서 제공하는 모델 공급자 키를 사용해야 하나요? | 선택 사항입니다. Coroid가 라우팅하는 모델의 경우 키가 필요하지 않습니다. |
그런 다음 아래에 나열된 단계들, 사용자가 개입해야 하는 부분 및 적용 범위에 포함된 저장소를 바탕으로 계획을 다시 확인하세요.
다음을 참고하세요:계획 및 요금제, 제한 사항 및 할당량및동기화됨 또는 로컬 전용.
2단계: 깨끗한 클론 상태에서 각 저장소의 빌드 및 테스트 가능 여부를 확인하세요.
이것은 가장 유용한 작업입니다. 모든 Coroid 작업은 깨끗하고 일회용인 Linux 워크스페이스에서 실행됩니다. 즉, 새로운 클론본이며 캐시된 항목도 없고 이미지의 툴체인 외에는 아무것도 설치되지 않습니다. 프로젝트를 빌드 및 테스트할 수 없는 에이전트는 자체 작업을 검증할 수 없으며, 변경 사항과 무관한 이유로 검증 단계에서 작업이 실패합니다.
로컬에서 해당 저장소를 작업할 수 있다면, 각 저장소에 대해 다음 단계를 따르세요:
- 사용 언어, 패키지 관리자, 그리고 모노레포 여부를 확인하세요.
- README, CI 구성 파일 및 매니페스트에서 설치, 빌드, 테스트 명령어를 찾아보세요.
- 실행하기 전에 반드시 확인하세요. 그런 다음 빈 임시 디렉터리에 저장소를 클론한 뒤, 다른 설정 없이 설치, 빌드, 테스트를 진행하세요. 사용자의 작업 복사본에는 캐시가 존재하며
.env파일이 문제를 숨길 수 있습니다. - 새로운 클론에서는 제공되지 않는, 실행에 필요한 항목을 모두 기록해 두세요:
- 테스트에서 요구하는 데이터베이스, 캐시 또는 큐와 같은 서비스입니다.
- 코드 생성, 마이그레이션 또는 피클과 같이 테스트 전에 필요한 단계입니다.
- 환경 변수 또는
.env파일이 커밋되지 않은 경우입니다. - 비공개 패키지 레지스트리입니다.
- 에 포함되지 않은 런타임입니다. 에이전트 환경입니다.
배포, 게시 또는 공유 환경을 변경하는 명령어는 절대 실행하지 마세요. 테스트 스위트가 느리거나 유료 서비스를 호출하는 경우에는 반드시 사용자에게 먼저 허락을 구하세요.
각 저장소별로 간단한 준비 상태 확인 결과를 보고하세요. 여기에는 명령어, 테스트 스위트 실행 시간, 통과 항목, 그리고 제안된 수정 방법과 함께 각 격차 사항이 포함됩니다.
| 격차 | 제안할 수정 방법 |
|---|---|
| 테스트에는 데이터베이스 또는 다른 서비스가 필요합니다. | 테스트 스위트와 관련 서비스를 함께 실행하는 Dockerfile 또는 Compose 파일입니다. |
필수.env파일이 커밋되지 않은 경우입니다. | 코드 내에 테스트 기본값을 정의하거나, 비밀 값을 제외한 설정을 포함한 커밋된 테스트 구성 파일을 사용하세요. |
| 테스트에 실제 비밀이 필요한 경우입니다. | 테스트에서 해당 종속성을 모의 처리하세요. 비밀 정보는 절대 커밋하지 마세요. |
| 종속성은 비공개 레지스트리에서 가져오는 경우입니다. | 사용자에게 알려주세요. Coroid는 프로젝트 구성으로 해당 정보에 대한 인증 정보가 필요합니다. |
| 명령어가 하위 디렉터리에서만 작동하는 경우입니다. | 정확한 디렉터리와 워크스페이스 필터를 기록해 두세요. |
누락된 런타임도 장애물이 되지 않습니다. 툴체인이 포함된 컨테이너를 사용하면 해결할 수 있습니다. 로컬에서 저장소에 접근할 수 없다면 사용자로부터 가능한 정보를 수집한 뒤, 깨끗한 클론 확인을 수행하지 못했음을 기록해 두세요.
다음 내용을 참조하세요:빌드 및 테스트 구성및언어 지원 및 에이전트 환경.
3단계: Coroid의 에이전트가 읽을 수 있는 지침 작성하기
모든 작업을 수행하기 전에, Coroid의 에이전트는 저장소 내의 메모리 파일을 읽습니다:AGENTS.md, CLAUDE.md또는GEMINI.md루트 디렉터리에 위치하며.cursor/rules입니다.
2단계에서 확인한 명령어를 여기에 입력하세요.
다음을 포함하는AGENTS.md또는 기존 파일에 추가할 내용을 작성하세요. 여기에는 다음이 명시되어야 합니다:
- 깨끗한 클론에서 확인된 설치, 빌드, 테스트 명령어와 이를 실행할 디렉터리입니다.
- 테스트에 필요한 단계와 서비스입니다.
- 하나의 패키지나 파일과 같이 가장 좁은 범위의 유용한 테스트를 실행하는 방법입니다.
- 코드에는 나타나지 않는 규칙과 경계: 고정된 모듈, 수정 금지 영역, 추가 금지 종속성 등입니다.
코드에 이미 명시된 내용은 제외하고 파일 크기를 최소화하세요. 만약CLAUDE.md또는.cursor/rules에 동일한 지침이 포함되어 있다면, 이를AGENTS.md다른 파일에서@AGENTS.md줄을 사용하여 불러오세요.
사용자에게 변경 내용을 표시합니다. 사용자의 승인을 받은 후 새 브랜치에 커밋하고 pull request를 열거나, 커밋 작업을 사용자에게 맡깁니다. 첫 번째 작업을 수행하기 전에 반드시 기본 브랜치에 도달해야 하는데, 각 작업은 해당 브랜치의 체크아웃본에서 메모리 파일을 읽어오기 때문입니다. 사용자가 승인한 2단계의 수정 사항도 동일한 방식으로 처리합니다.
확인하기프로젝트 컨텍스트 설정및프로젝트 컨텍스트.
4단계: 계정 및 조직(사용자)
사용자가 이미 Coroid 조직의 소유자 또는 관리자로 속해 있다면 이 단계는 건너뛰세요.
사용자에게 다음을 요청하세요:
- 에서 가입하도록 안내하세요
https://client.coroid.ai/auth/signup업무용 이메일을 사용하여 주소를 인증하세요 - 서비스 이용 약관에 동의하세요
- 조직을 생성하세요
확인하기:사용자가https://client.coroid.ai/projects를 열 수 있는지 확인하세요. 이 설정을 완료하는 사람은 소유자 또는 관리자 역할이 필요한데, 오직 이 역할만이 소스 제어를 연결하고 공급자 키를 추가할 수 있기 때문입니다.
확인하기계정 및 조직 생성하기.
5단계: 소스 제어 연결(사용자)
시작하기 전에 사용자와 함께 접근 권한 요구 사항을 확인하세요. 다른 사람의 승인을 기다리느라 중간에 설치가 중단되는 경우가 이 단계가 1분이 아닌 하루가 걸리는 주된 원인입니다.
GitHub
사용자는설정 → 연결 → 소스 제어
(https://client.coroid.ai/settings/connections/source-control).
| 옵션 | 다음과 같은 경우에 사용하세요 | GitHub에서 사용자가 필요로 하는 항목 |
|---|---|---|
| GitHub 앱(권장) | 거의 항상 | 저장소를 소유한 계정 또는 조직에 앱을 설치할 수 있는 권한이 필요합니다. 조직의 경우 보통 소유자에게 이 권한이 부여되며, 다른 멤버는 설치를 요청하여 소유자의 승인을 받을 수 있습니다. |
| 개인 액세스 토큰 | 해당 앱은 사용자가 직접 얻을 수 없는 승인이 필요합니다. | 전통적인 토큰으로서repo범위를 가지거나, 선택한 저장소에 대해 읽기 및 쓰기 권한을 가진 세분화된 토큰입니다.콘텐츠및풀 요청선택한 저장소에 대해 |
| URL로 연결, 연결 없음 | 공개 저장소로,로컬 전용 | 없음 |
GitHub 앱:GitHub 설치 화면에서 사용자는저장소만 선택그리고 1단계에서 합의된 저장소를 지정합니다. 해당 앱은 설치한 사람이 퇴사하더라도 계속 작동하며 웹훅 이벤트를 수신하고, 이를 통해 Coroid가 풀 요청에 대한 검증 결과를 게시할 수 있습니다. 토큰으로는 GitHub 검증 결과를 게시할 수 없습니다.
개인 액세스 토큰:사용자는 GitHub에서 만료 기한을 설정한 뒤 이를 Coroid 포털에 붙여넣습니다. 합의된 저장소에만 접근할 수 있도록 제한된 세분화된 토큰을 사용하는 것이 좋습니다. 풀 요청은 토큰 소유자에게 귀속되며, 해당 사용자의 접근 권한이 상실되면 연결이 끊어집니다.
GitLab
GitLab는 비공개 미리보기 단계에 있으며 활성화된 계정에만 표시됩니다. 이는api범위를 가진 개인 액세스 토큰으로 연결됩니다. 만약 소스 제어 목록에 GitLab이 표시되지 않는다면 사용자에게 Coroid에 문의하도록 안내하고, 이를 기반으로 작업 계획을 세우지 마세요.
브랜치 보호
Coroid는 일반적인 Pull Request를 생성하므로 브랜치 보호 규칙, 필수 검증 및 리뷰 규칙이 여전히 적용됩니다. 보호 규칙을 유지하는 것을 권장합니다. 해당 규칙에서 서명된 커밋이나 Coroid가 생성할 수 없는 상태 확인을 요구하는 경우, Pull Request가 생성되더라도 병합될 수 없게 됩니다. 사용자에게 이 사실을 알려주고 규칙을 변경하지 마세요.
확인:소스 제어 항목에 연결된 공급자로 표시되는지 확인하세요. 실제 증거는 6단계에서 프로젝트 목록에 해당 저장소가 나타날 때 확인할 수 있습니다.
참고:코드를 연결하기, GitHub, GitLab및저장소 및 브랜치 설정.
6단계: 프로젝트 생성(사용자)
저장소당 하나의 프로젝트를 생성하며, 하나의 저장소에 두 개의 프로젝트를 생성해서는 안 됩니다. 사용자는프로젝트 → 새로 만들기 (https://client.coroid.ai/projects/new)를 열고 각 저장소에 대해 다음을 수행합니다:
- 연결된 공급자에서 해당 저장소를 선택하거나URL로 연결하기를 이용하여 공개 저장소를 추가합니다.
- 저장소 모드를 선택합니다.저장소 모드: '동기화됨' 모드에서는 Coroid가 브랜치를 푸시하고 Pull Request를 생성하며, '로컬 전용' 모드에서는 누군가동기화 시작
- 기본 브랜치를 확인합니다.
- 프로젝트를 생성합니다.
팀에서 기본 브랜치가 아닌 다른 브랜치로 병합하는 경우, 예:develop, 프로젝트의 저장소 설정에서 기준 브랜치를 지정해야 합니다. 잘못된 기준 브랜치를 설정하면 Pull Request가 아무도 리뷰하지 않는 브랜치로 전송됩니다.
목록에 저장소가 표시되지 않는 경우 그 원인은 거의 다음 중 하나입니다:
- GitHub 앱에 해당 저장소에 대한 접근 권한이 부여되지 않았습니다.
- 토큰의 범위가 해당 저장소를 나열하기에 너무 제한적입니다.
- 해당 저장소는 연결된 조직과 다른 조직에 속해 있습니다.
다음을 참조하세요:첫 번째 프로젝트 생성하기및저장소 및 브랜치 설정.
7단계: Coroid가 확인한 내용 확인하기
사용자에게 각 프로젝트의 개요 페이지를 열어서 다음 내용을 읽어달라고 요청하세요:저장소세부 정보와 그 아래에 나열된 내용을 확인하세요:설정 완료하기:
- 상태및브랜치: 저장소가 복제되었으며, 합의한 기본 브랜치에 있습니다. 개요에 저장소가 아직 복제되지 않았다고 표시되면 사용자는 "저장소 복제하기.
- 스택: Coroid가 감지한 언어, 프레임워크, 패키지 관리자 및 테스트 도구입니다. 이를 준비 상태 확인 결과와 비교하세요. 첫 동기화 후 스택이 비어 있거나 잘못된 경우 사용자는 해당 위치에서 다시 스캔할 수 있습니다.
- 설정 완료하기: "종속성 설치가 제대로 되지 않음"과 같은 항목은 2단계에서 확인한 동일한 문제점을 가리킵니다. 사용자와 함께 이 문제를 해결하세요.
그런 다음 사용자는 프로젝트의설정 → 지식 → 컨텍스트로 이동합니다. 3단계에서 생성된 메모리 파일이저장소 소스에 포함되어 있고 활성화되어 있어야 합니다. 만약생성가 표시된다면 해당 파일이 아직 연결된 브랜치에 도달하지 못한 것입니다.
다음을 참조하세요:프로젝트 컨텍스트 설정및빌드 및 테스트 구성.
8단계: 조직 설정(선택 사항)
사용자가 지금 이 설정을 적용할지 묻습니다. 모든 항목에는 적절한 기본값이 존재합니다.
- 멤버,설정 → 멤버: 소유자, 관리자, 멤버 또는 리뷰어 권한을 가진 사람으로, 이들은 Pull Request를 검토합니다. 정책 및 공급자 키를 변경해야 하는 사용자에게만 관리자 권한을 부여하는 것을 권장합니다. Professional 요금제가 필요합니다.
- 공급자 키,설정 → 공급자 키: 조직에서 사용하는 자체 모델 공급자 계정을 등록하기 위해서만 사용됩니다. 사용자는 포털에서 해당 키를 입력합니다. 공급자 측에서 지출 한도가 적용된 제한된 권한의 키를 사용할 것을 권장합니다.
- 다른 조직의 설정: 해당 조직으로 설정 번들을 내보낸 뒤설정 → 데이터 → 설정 내보내기에서 가져옵니다. 비밀 정보는 플레이스홀더 형태로 전달되므로 미리보기의 각
needsRebind항목을 반드시 확인해야 합니다.
다음 내용을 참고하세요:계정 및 조직 생성하기, 공급자 키및설정 내보내기 및 가져오기.
9단계: Coroid에 직접 연결하기(선택 사항)
사용 중인 클라이언트가 원격 MCP 서버를 지원한다면, 다음 주소의 Coroid MCP 서버를 통해 Coroid에 접근할 수 있습니다:https://api.coroid.ai/mcp. 설정 과정에서는 이 기능을 필수로 사용하지 않지만, 이를 통해 직접 프로젝트를 확인하고 추후 작업 실행을 돕는 데 활용할 수 있습니다.
- 사용자는설정 → 자동화 → Coroid MCP 서버
(
https://client.coroid.ai/settings/automation/coroid-mcp)를 엽니다. 해당 조직에서 이 기능을 사용할 수 없다면 이 단계는 건너뛰세요. - 클라이언트 설정각 클라이언트별로 사용되는 명령어가 표시됩니다. OAuth를 이용할 경우 사용자는 브라우저에서 접근 권한을 승인합니다. 개인용 액세스 토큰을 사용하는 경우에는 사용자가 해당 토큰을 생성하여액세스 토큰에 저장하고 자신이 사용하는 셸의 환경 변수에 보관합니다. 실제 토큰 값을 직접 확인할 필요는 없습니다.
- 작동에 필요한 최소한의 접근 권한을 권장합니다:
mcp.read를 통해 설정 상태를 확인하세요. 또한mcp.work.write는 작업을 생성해야 하는 경우에만 사용하십시오. 토큰의 적용 범위를 지정된 프로젝트로 제한하고 만료 기한을 설정한 뒤자동화 정책을 미리 구성해야 클라이언트가 무인으로 작업을 수행할 수 있습니다.
확인 방법:명령을list_projects, 그 다음get_project6단계에서 지정한 각 프로젝트에 대해 실행하여 리포지토리와 브랜치가 올바른지 확인하세요.
MCP용으로는 오직api.coroid.ai만 사용하십시오. 클라이언트 포털의 호스트명에서는 이를 지원하지 않습니다.
다음 내용을 참고하세요:Coroid를 MCP 서버로 활용하기.
10단계: 첫 번째 작업 초안 작성하기
새로 생성한 프로젝트 중 하나에서 사용자와 함께 작은 규모의 첫 번째 작업을 초안으로 작성해 보세요. 좋은 첫 작업은 실제로 구현 가능하며 규모가 작고 기존 테스트와 연관성이 있으며 명확한 완료 기준을 가진 작업입니다. 인증 처리, 결제 기능, 데이터 마이그레이션, 범위가 불명확한 정리 작업, 아직 결정되지 않은 설계 관련 사항은 피하세요.
구현 방식이 아닌 결과물을 기술하세요. 작업이 완료되었을 때 어떤 상태가 되어야 하는지, 어떤 파일이 관련되는지, 그리고 건드리면 안 되는 부분은 무엇인지 명시하세요. 사용자는새 작업 (https://client.coroid.ai/work/new)에서 해당 내용을 제출하면 시스템이 사양을 읽고 계획을 승인합니다. 작업 실행에는 에이전트 시간이 소요되며 무료 요금제의 경우 UTC 기준 하루에 2시간만 제공되므로 실행 시점은 사용자가 직접 결정하도록 하세요.
다음 내용을 참고하세요:첫 번째 작업 실행하기및사양.
11단계: 작업 위임하기
사용자에게 설정 정보를 전달하세요:
- 각 리포지토리별로 프로젝트, 리포지토리 모드 및 기본 브랜치 정보를 확인할 수 있습니다.
- 소스 제어가 어떻게 연결되었는지와 해당 연결의 소유자를 확인하세요. 여기에는 앱 설치 프로그램 또는 액세스 토큰의 소유자와 토큰의 만료일이 포함됩니다.
- 리포지토리별로 수정된 항목과 아직 처리되지 않은 항목(예: 열린 풀 요청 포함)을 확인할 수 있습니다.
AGENTS.md사용자가 별도로 유지하기로 선택한 항목도 함께 확인할 수 있습니다. - 적용되거나 건너뛴 선택적 설정과 초안으로 작성된 첫 번째 작업 내용도 확인할 수 있습니다.
그런 다음 사용자를 다음 페이지로 안내하세요.결과물을 리뷰하고 병합하세요.첫 번째 pull request에서 제공되는 내용을 확인할 수 있습니다.
다음 단계로 진행하세요.
계정과 조직을 생성하세요.— 동일한 설정 과정을 수동으로 진행하는 방식입니다.