Claude Code, Codex, Cursor와 같은 개발자 보조 도구와 Coroid의 에이전트는 동일한AGENTS.md을 읽습니다. 그중 대부분은 두 도구에 모두 적용되는데, 바로 명령어, 규칙 및 경계입니다. 예외는 Git 워크플로우로, 이 부분은 Coroid가 직접 브랜치, 커밋 및 풀 요청을 생성합니다.
Coroid의 에이전트가 읽는 내용
각 작업 시작 전에 Coroid의 에이전트는 저장소 루트에 있는 메모리 파일을 읽습니다:AGENTS.md, CLAUDE.md, GEMINI.md와 Cursor의 규칙은.cursor/rules. 이들은@을 가져오며, 동일한 지침은 한 번만 포함됩니다. 어떤 소스를 에이전트가 받을지 선택하려면설정 → 지식 → 컨텍스트. 자세히 알아보려면프로젝트 컨텍스트.
작업은 자체 체크아웃에서 파일을 읽으므로,AGENTS.md에 적용된 변경 사항은 기본 브랜치에 병합된 이후에 시작되는 작업에만 영향을 줍니다.
두 도구에 모두 적용되는 내용
모든 에이전트를 위해 이 내용을 한 번만 작성하세요:
- 명령어: install, build, test 및 가장 좁은 범위의 유용한 테스트(예: 하나의 패키지나 파일)입니다. 깨끗한 복제본에서 이 명령어들을 확인하고, 실행할 디렉터리와 테스트에 필요한 서비스를 명시하세요.
- 코드에는 나타나지 않는 규칙: 이름 지정 방식, 오류 처리 방법, 문자열 번역 방식, 금지된 패턴 등입니다.
- 경계: 고정된 모듈, 팀이 소유한 경로, 추가하지 말아야 할 종속성, 수동으로 편집해서는 안 되는 파일 등입니다.
내용은 간결하게 작성하세요. 모든 줄은 각 작업마다 모든 에이전트가 읽습니다. 긴 문서는 링크로 연결하고, 코드에 이미 명시된 내용은 제외하세요.
Coroid가 직접 수행하는 작업
Coroid의 에이전트는 샌드박스 내에서 파일을 수정합니다. 나머지 작업은 Coroid가 처리합니다:
| 단계 | Coroid에서 |
|---|---|
| 브랜치 | Coroid는 작업별로 하나의 브랜치를 생성합니다:feature/coroid-<id>-<title>, 또는bugfix/, refactor/, test/또는docs/작업 유형에 따라 결정됩니다. 계획의 레인은coroid/factory/… |
| 커밋 | Coroid는 커밋 메시지를 작성하고 출처 트레일러인Coroid-Task을 추가합니다. 연결된 계정이 작성자인 경우Co-authored-by: Coroid <ai@coroid.ai> |
| 푸시 | Coroid는 브랜치를 푸시합니다. 샌드박스는git push, git pull, git fetch및git clone, 그리고 사용자의 제공업체에 대한 인증 정보는 보관하지 않습니다. |
| 풀 요청 | Coroid는 작업 제목을 딴 풀 요청을 열고, 작업, 수락 기준, QA 및 리뷰 결과를 링크로 포함하는 설명을 추가합니다. |
""과 같은 지침은ws/브랜치에서 작업하기", "pull request를 열어서gh pr create" 또는 "각 커밋 끝에 공동 작성자 라인을 추가하기"와 같은 지침은 Coroid 내부에서는 적용되지 않습니다. 에이전트가 수정한 파일만 샌드박스를 떠나므로, 거기서 생성된 브랜치나 커밋은 삭제됩니다. Coroid는 지침 파일보다 먼저 에이전트에게 이를 알려주므로 해당 단계는 건너뛰고 나머지 지침을 따릅니다.
기본 브랜치에는 아무것도 커밋되지 않습니다: 자세히 알아보려면저장소 및 브랜치 설정.
어떤 부분이 어디에 적용되는지 명시하세요
Coroid의 에이전트는 이미 Git 워크플로우를 건너뛰므로, 파일에 이를 명시하면 모든 독자와 관련 인력에게 도움이 되며, 완료 전에 실행해야 하는 검사와 같은 Coroid 전용 단계도 한곳에 모을 수 있습니다. 상단 근처에 짧은 섹션을 추가하세요:
## Working in Coroid
When you run inside Coroid, Coroid creates the branch, commits, pushes and
opens the pull request. Change files only, and skip "Git workflow" below.
Before you finish, run `npm run validate`.그런 다음 로컬 워크플로우를 그 본래의 용도대로 표시하세요:
## Git workflow (local agents)
- Branch: `ws/<nn>-<name>` from `main`, in your own worktree.
- Commit messages end with your assistant's co-author line.
- Run `npm run check:local`, then open the pull request with `gh pr create`.개발자 보조 도구는 각자의 워크플로우를 유지하므로, 어떤 단계가 누구의 것인지 헷갈릴 일이 없습니다.
pull request가 통과해야 하는 검사
에만 작성된 검사는AGENTS.md에이전트가 실행하기로 결정할 때만 실행됩니다.
Coroid의 커밋도 husky나 pre-commit 같은 저장소의 Git 훅을 건너뜁니다. 모든 변경 사항에 적용되어야 하는 검사는품질 관리를저장소 명령어검사로 지정하세요:
- Coroid는 에이전트가 만든 변경 사항에 대해 이 검사를 실행합니다.
- pull request 검사가 활성화되면, Claude Code, Codex, Cursor로 작성된 풀 요청을 포함하여 팀이 연 풀 요청에도 이 검사가 적용됩니다.
이렇게 두 가지 작업 방식이 동일한 기준을 충족합니다. 자세히 알아보려면품질 정책 및 게이트.
불필요한 코드 방지 규칙의 경우, 개발자 보조 도구가 MCP를 통해 Coroid에 요청할 수 있습니다.anti_slop_rules는 프로젝트의 규칙을 명시한 스니펫을 반환합니다AGENTS.md: 자세히 알아보려면편집기에서 적용되는 불필요한 코드 방지 규칙.
일부 브랜치에만 적용되는 CI
CI나 브랜치 보호 기능이 일부 브랜치 이름에만 적용되는 경우, Coroid의 브랜치 이름을 추가하세요:
feature/coroid-*
bugfix/coroid-*
refactor/coroid-*
test/coroid-*
docs/coroid-*
coroid/factory/**그렇지 않으면 Coroid의 풀 요청에 팀이 의존하는 검사가 적용되지 않은 채로 열립니다.
모든 도구를 위한 단일 파일
지침은 한 번만AGENTS.md:
- Codex및Cursor읽기
AGENTS.md. - Claude Code읽습니다
CLAUDE.md. 이를 하나의@AGENTS.md줄로 만들고, Claude Code에 필요한 내용만 포함하세요. - Cursor도 해당 규칙을
.cursor/rules. Coroid는 이를 읽으며 Cursor가 이를 적용하는 방식을 확인하려면 다음을 참조하세요:프로젝트 컨텍스트.
Coroid는CLAUDE.md를 가져와서 포함시킵니다AGENTS.md한 번만.
Coroid가 무엇을 읽는지 확인하세요
다음 경로에서 확인할 수 있습니다:설정 → 지식 → 컨텍스트, 저장소 소스각 파일을 나열하며 추정 토큰 수와 스위치가 함께 표시됩니다.편집해당 파일을 엽니다. 저장하면 연결된 저장소에 pull request가 생성되며, 이 변경 사항은 다른 항목과 동일한 검토 절차를 거칩니다.