Git 및 PR 워크플로우
- 동기화:
git fetch origin main && git checkout main && git reset --hard FETCH_HEAD(클론이 얕을 수 있으며,origin/main이 확인되지 않을 수 있습니다.) - 브랜치: 스프린트 티켓(
docs/sprints/참조)인 경우git checkout -b S<n>/<area>/<slug>, 그 외에는fix/,docs/또는chore/뒤에 슬러그를 추가합니다. - 작은 커밋 단위로 작업합니다. 각 작업 전에
AGENTS.md명령어를 확인하세요. - 동일한 PR에서
docs/HANDOFF.md를 업데이트합니다(스킬handoff). - 커밋 메시지:
타입(범위): 명령형 요약
왜 이 변경이 필요한지, 한두 문장으로 설명.
Co-Authored-By: Abdullah Farag <[email protected]>
Co-Authored-By: <모델 이름> <[email protected]>
- 푸시:
git push -u origin <브랜치명>. - REST API로 PR 열기(클라우드 세션에서는 GraphQL이 차단됨):
gh api repos/al0olo/agents-village/pulls \
-f title="타입: 요약" -f head=<브랜치명> -f base=main -F body=@/tmp/pr.md --jq '.html_url'
본문: 무엇이 변경되었는지, 왜 변경했는지, 어떻게 확인했는지, 리뷰어가 결정해야 할 사항. 8. CI가 실패하면 로그를 읽고, 같은 브랜치에서 수정한 후 푸시합니다. 빨간 상태로 병합하지 마세요. 9. 병합 순서: PR이 서로 의존하는 경우 본문에 명시하고 순서대로 병합하세요.
절대 main에 커밋하지 말고, 공유 브랜치에 강제 푸시하지 말며, 훅을 건너뛰지 마세요.