Skip to content

Conversation

@NTaylorMullen
Copy link
Collaborator

Summary

Refines Gemini 3 system instructions to reduce programmatic chattiness while maintaining clarity for non-obvious actions.

Details

Following feedback that Gemini 3 was becoming too verbose, this PR adjusts the model instructions:

  • Updated the 'Explain non-obvious actions' mandate to specifically target non-obvious behavior (complex commands, planning phases, etc.) while explicitly discouraging the explanation of obvious actions like simple file reads.
  • Restored the 'No Chitchat' rule for Gemini 3, with a narrow exception for the aforementioned non-obvious explanations.
  • These changes ensure the model remains direct and concise in most interactions while still keeping the user informed when taking complex actions.

Related Issues

Related to #13810

How to Validate

Run the prompt unit tests:

npm test -w @google/gemini-cli-core src/core/prompts.test.ts

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Docker
      • Podman
      • Seatbelt

- Update system instructions to only explain non-obvious actions for Gemini 3.
- Restore 'No Chitchat' rule for Gemini 3 with an exception for necessary explanations.
- Update tests and snapshots to reflect prompt changes.
@NTaylorMullen NTaylorMullen requested a review from a team as a code owner January 8, 2026 07:20
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @NTaylorMullen, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on enhancing the user experience with the Gemini 3 model by making its responses more concise and direct. It achieves this by carefully adjusting the model's internal system instructions, ensuring that it avoids unnecessary conversational filler and only provides detailed explanations when an action is genuinely complex or non-obvious. This refinement aims to streamline interactions without sacrificing clarity for critical operations.

Highlights

  • Refined Gemini 3 System Instructions: The system instructions for the Gemini 3 model have been updated to reduce verbosity and programmatic chattiness.
  • Clarified 'Explain Non-Obvious Actions' Mandate: The instruction for explaining actions has been refined to specifically target complex commands, planning phases, or non-trivial summaries, while explicitly discouraging explanations for obvious actions like simple file reads.
  • Restored 'No Chitchat' Rule: The 'No Chitchat' rule has been reinstated for Gemini 3, with a narrow exception allowing conversational filler only when explaining non-obvious actions.
  • Updated Prompt Snapshots and Tests: Snapshot tests and unit tests for prompts have been updated to reflect these new instructions and ensure the 'No Chitchat' rule is correctly applied to Gemini 3.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request effectively refines the Gemini 3 system instructions to reduce verbosity, which aligns well with the stated goals. The changes to the prompts are clear and the corresponding test updates are correct. I've included one suggestion to improve code readability and maintainability by refactoring an Immediately Invoked Function Expression (IIFE) to a more modern and concise ternary operator.

@github-actions
Copy link

github-actions bot commented Jan 8, 2026

Size Change: +486 B (0%)

Total Size: 22.3 MB

ℹ️ View Unchanged
Filename Size Change
./bundle/gemini.js 22.3 MB +486 B (0%)
./bundle/sandbox-macos-permissive-closed.sb 1.03 kB 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-closed.sb 3.29 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B

compressed-size-action

…tchat rule

- Update 'Explain Before Acting' mandate for Gemini 3: Explicitly forbid silent tool calls and require concise explanations of intent or strategy.
- Simplify 'No Chitchat' for Gemini 3: Prohibit conversational filler while allowing exceptions for mandatory intent explanations, removing restrictive clauses on reasoning narration.
- Update test snapshots to align with prompt changes.
@NTaylorMullen NTaylorMullen added this pull request to the merge queue Jan 9, 2026
@NTaylorMullen
Copy link
Collaborator Author

Merging the verbosity here feels way way better

Merged via the queue into main with commit 41e627a Jan 9, 2026
26 checks passed
@NTaylorMullen NTaylorMullen deleted the ntm/verbosity-change branch January 9, 2026 08:07
theerud pushed a commit to theerud/gemini-cli that referenced this pull request Jan 9, 2026
sumansaurabh pushed a commit to sumansaurabh/gemini-cli that referenced this pull request Jan 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants