규칙 쓰기

규칙은 세션의 첫 메시지 끝에 붙는 판단 기준이에요. 세션은 사람 없이 돌기 때문에, 사람이 옆에서 해 줄 말을 미리 적어 두는 곳이에요.

내장 규칙과 규칙 파일

	언제 쓰나요	어디 있나요
내장 규칙	`RULES_FILE` 이 없을 때	저장소의 `rules.md`, 이미지에 들어가요
규칙 파일	`RULES_FILE` 을 지정했을 때	그 경로의 파일, 보통 컨테이너에 마운트

규칙 파일은 내장 규칙을 통째로 대신해요. 합치지 않아요. 내장 규칙에서 출발하고 싶으면 내장 규칙을 복사해서 고치세요.

규칙 파일은 실행할 때마다 다시 읽어요. 파일만 고치면 재시작 없이 다음 실행부터 반영돼요. 다만 서버가 시작할 때 한 번 읽어 보고, 없거나 비어 있으면 시작하지 않아요. 실행 중에 파일이 사라지면 그 실행은 실패로 남아요.

규칙 안의 {{workdir}} 는 BRIDGE_WORKDIR 로 바뀌어요. 그 밖의 글자는 그대로 전해져요.

내장 규칙은 어느 레포에나 맞는 것만 담고 있어요. 내 환경에서 사람이 늘 하던 말을 더하세요.

레포를 찾는 법: "레포는 {{workdir}} 아래, 없으면 gh repo clone myorg/<이름>"
패키지 매니저 실행법: "yarn 은 npx -y corepack@0.34.0 yarn@<packageManager 의 버전> 으로 실행해요"
레포마다 다른 테스트 방법: "docs 레포 테스트는 LANG=en_US.UTF-8 로 돌려요(요일 이름이 로캘을 따라가요)"
못 고칠 때 어디에 적는지: "스캐너 레포의 ignore.json 에 id·repo·package·이유·만료일(최대 3개월 뒤)을 추가해요"
커밋 규칙: "커밋 메시지 끝에 Co-Authored-By 줄을 넣되, company-app 레포에는 넣지 않아요"
배포 확인법: "push 뒤 1분 안에 배포가 안 보이면 배포 도구에서 직접 배포해요. 새 컨테이너가 healthy 가 된 뒤에 라이브를 확인해요"
PR 로 멈추고 싶은 레포: "payments 레포는 push 하지 말고 PR 을 만든 뒤 멈춰요"

질문할 여지를 없애요. 세션이 질문하면 실행이 확인 대기에 멈추고, 그동안 오는 트리거는 모두 건너뛰어요. 갈림길마다 "이럴 땐 이렇게"를 적어 두세요.
멈추는 조건을 적어요. "같은 문제로 2번 실패하면 그 항목은 멈추고 결과에 적어요" 같은 문장이 없으면 세션이 오래 붙잡고 있을 수 있어요.
결과 형식을 마지막에 적어요. 기록 화면에는 세션의 마지막 답변이 그대로 남아요. "항목별 결과(고침/보류/실패), 커밋 해시, 배포 결과를 짧게"처럼 형식을 정하세요. 화면은 **굵게** 와 `코드` 를 표시해요.
시크릿을 쓰지 말라고 적어요. 결과가 화면에 남으니까요.
번호 목록으로 써요. 세션이 결과에서 "규칙 4 때문에 보류" 처럼 가리키기 쉬워요.