[Hardening] Require scope review before approving Jules plans

[Hanjo92]

Summary / 요약

Jules plan approval 전에 생성된 plan을 원래 요청, scope note, non-goal과 대조하는 명시적 검토 단계를 추가합니다.

Risk Or Quality Gap / 리스크 또는 품질 공백

SKILL.md의 Quick Start와 예시는 wait 후 approve-plan으로 이어지지만, plan이 사용자의 원래 범위와 맞는지 검토하는 절차가 충분히 선명하지 않습니다. Jules가 unrelated refactor, dependency change, schema change, broad cleanup을 plan에 포함해도 에이전트가 그대로 승인할 위험이 있습니다.

Proposed Hardening / 제안 보강

• AWAITING_PLAN_APPROVAL 처리 규칙에 “plan scope review” 단계를 추가합니다.
• 생성된 plan을 original prompt, --scope-note, --non-goal, strict-scope contract와 비교하도록 문서화합니다.
• scope drift가 보이면 승인 대신 사용자에게 확인하거나 Jules에 수정 요청하는 예시를 추가합니다.
• 이 작업은 기존 [Hardening] Strengthen Jules task prompts against scope drift #7 prompt hardening과 연결하되, approval workflow 문서/운영 절차에 초점을 둡니다.

Verification Plan / 검증 계획

• google-jules-control/SKILL.md의 Quick Start, approval 예시, Decision Rules를 검토합니다.
• 필요하면 references/jules-reference.md에 state별 승인 전 검토 요약을 추가합니다.
• 문서 예시가 실제 helper 명령과 일치하는지 확인합니다.

Acceptance Criteria / 완료 기준

• plan approval 전 scope review 절차가 SKILL.md에 명확히 추가된다.
• scope drift를 발견했을 때 승인하지 않는 예시가 포함된다.
• --scope-note와 --non-goal이 approval 검토 기준으로 명시된다.
• 기존 #7과 중복되지 않게 workflow 중심으로 정리된다.

References / 참고 자료

• Existing issue: [Hardening] Strengthen Jules task prompts against scope drift #7
• google-jules-control/SKILL.md: Quick Start, approval example, Decision Rules
• google-jules-control/references/jules-reference.md: session states
• 분석일: 2026-04-24

[Hanjo92]

Pushed branch codex/issue-11-plan-approval-scope-review with commit 82aa0f4 (Document Jules plan approval scope review).

What changed:

• Added explicit plan scope review guidance before approve-plan in the skill quick start and approval example.
• Clarified that resume can auto-approve pending plans only after the same scope review.
• Added the approval gate to setup docs, Jules reference notes, and all platform prompt variants including Minimal prompts.

Verification:

• git diff --check
• python3 -m py_compile google-jules-control/scripts/jules_api.py
• python3 -m unittest discover -s tests (20 tests)
• rg check for approval/scope-review guidance across skill, docs, reference, and platform prompts