Summary / 요약
create-session --branch와 --automation-mode AUTO_CREATE_PR의 의미를 명확히 문서화합니다.
Current Problem / 현재 문제
예시는 대부분 --branch main을 사용하지만, 이 값이 base branch인지, 작업 branch인지, Jules가 PR을 만들 때 어떤 의미를 갖는지 설명이 부족합니다. 사용자가 기존 feature branch에서 Jules를 이어가게 하거나 default branch가 main이 아닌 저장소를 다룰 때 혼동이 생길 수 있습니다.
Why It Matters / 왜 중요한가
잘못된 branch 선택은 Jules가 엉뚱한 기준으로 작업하거나, 기대와 다른 PR을 만들거나, 이미 진행 중인 작업과 충돌하는 원인이 됩니다. PR 자동 생성 옵션도 운영상 중요한 side effect이므로 명확한 선택 기준이 필요합니다.
Proposed Change / 제안 변경
--branch가 Jules API의 sourceContext.githubRepoContext.startingBranch에 매핑된다는 점을 설명합니다.- 사용자가 branch를 명시하지 않았을 때 default branch를 확인하는 권장 절차를 제안합니다.
- default branch, release branch, existing feature branch 예시를 추가합니다.
--automation-mode AUTO_CREATE_PR를 언제 켜고 언제 생략할지 문서화합니다.
Acceptance Criteria / 완료 기준
References / 참고 자료
google-jules-control/SKILL.md: create-session examplesgoogle-jules-control/references/jules-reference.md: startingBranch, automationMode- 분석일: 2026-04-24
Summary / 요약
create-session --branch와--automation-mode AUTO_CREATE_PR의 의미를 명확히 문서화합니다.Current Problem / 현재 문제
예시는 대부분
--branch main을 사용하지만, 이 값이 base branch인지, 작업 branch인지, Jules가 PR을 만들 때 어떤 의미를 갖는지 설명이 부족합니다. 사용자가 기존 feature branch에서 Jules를 이어가게 하거나 default branch가main이 아닌 저장소를 다룰 때 혼동이 생길 수 있습니다.Why It Matters / 왜 중요한가
잘못된 branch 선택은 Jules가 엉뚱한 기준으로 작업하거나, 기대와 다른 PR을 만들거나, 이미 진행 중인 작업과 충돌하는 원인이 됩니다. PR 자동 생성 옵션도 운영상 중요한 side effect이므로 명확한 선택 기준이 필요합니다.
Proposed Change / 제안 변경
--branch가 Jules API의sourceContext.githubRepoContext.startingBranch에 매핑된다는 점을 설명합니다.--automation-mode AUTO_CREATE_PR를 언제 켜고 언제 생략할지 문서화합니다.Acceptance Criteria / 완료 기준
--branch의 의미와 선택 기준이SKILL.md또는 reference에 설명된다.main이 아닌 저장소 예시가 포함된다.AUTO_CREATE_PR의 side effect와 사용 기준이 명확하다.References / 참고 자료
google-jules-control/SKILL.md: create-session examplesgoogle-jules-control/references/jules-reference.md:startingBranch,automationMode