Skip to content

t1283: Context optimisation pass 3 — tighten language across always-loaded files#2048

Merged
marcusquinn merged 5 commits intomainfrom
feature/t1283
Feb 21, 2026
Merged

t1283: Context optimisation pass 3 — tighten language across always-loaded files#2048
marcusquinn merged 5 commits intomainfrom
feature/t1283

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Feb 21, 2026

Summary

Context optimisation pass 3: tighten language across all always-loaded files.

Token reductions

File Before After Reduction
build.txt ~3,161 ~1,877 -41%
.agents/AGENTS.md ~2,347 ~1,348 -43%
build-plus.md ~4,059 ~1,669 -59%
AGENTS.md (repo) ~1,010 ~672 -33%
Total ~10,577 ~5,566 -47%

Approach

  • Compressed verbose explanations to crisp directives
  • Merged overlapping rules (e.g., model reinforcements into completion discipline)
  • Grouped domain index entries to reduce table rows
  • Moved rationale to comments where preserved
  • Removed example phrases and generic coding advice that frontier models already know

Verification

  • Every rule preserved — only language tightened, no rules removed
  • Diff reviewed line-by-line for rule preservation
  • Files readable by sonnet-tier model without ambiguity

Ref #2042

Summary by CodeRabbit

  • Documentation
    • Simplified onboarding instructions and command formatting
    • Condensed workflow and operational guidance documentation
    • Clarified agent descriptions, procedures, and key capabilities
    • Tightened language throughout to reduce verbosity while maintaining clarity
    • Reorganized domain index and security sections for consistency
    • Updated working directory guidance with concise terminology

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 21, 2026

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 6 minutes and 18 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

This PR consolidates and simplifies documentation across agent configuration and prompt files by removing verbose language, streamlining guidance, and reorganizing sections while retaining core procedural information. No functional or executable code changes are introduced.

Changes

Cohort / File(s) Summary
Agent Prompt Configuration
.agents/prompts/build.txt
Mission, operational rules, tone, and discipline guidance condensed. Replaced multi-phase deliberation scaffolds with streamlined steps; removed verbose checklist formatting; tightened critical-thinking, tool-usage, and file-discovery prompts.
Agent Documentation Guides
.agents/AGENTS.md, .agents/build-plus.md
Onboarding, supported tools, and runtime identity sections simplified. Build+ workflow steps collapsed from verbose phases to concise tokens (Fetch, Understand, Investigate, Plan, Execute, Validate). Planning sections reworded to shorter imperative statements.
Root Agent Reference
AGENTS.md
Quick Reference consolidated; Development Commands and File Structure blocks condensed. "Before extending" guidance shortened to single sentence; legacy distinctions removed; core architecture references retained with flatter phrasing.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Poem

📋 Where verbose once rambled, concise now stands clear,
The agents' commands polished, year upon year,
Brevity triumphs—guidance distilled,
No bloat left behind, only essence instilled. ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the primary change: a third pass of context optimization focused on tightening language in always-loaded documentation files, with specific emphasis on token reduction and concision.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/t1283

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, 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 implements the third pass of context optimization, focusing on tightening the language within critical, always-loaded documentation files. The primary goal is to reduce token consumption, thereby improving the efficiency and performance of AI agents. Changes include condensing explanations, merging redundant rules, and removing non-essential details, resulting in a substantial reduction in token count across the affected files.

Highlights

  • Token Reduction: Achieved a significant overall token reduction of 47% across key always-loaded files, enhancing efficiency for AI agents.
  • Language Tightening: Compressed verbose explanations into crisp, direct directives and merged overlapping rules to streamline instructions.
  • Content Streamlining: Grouped domain index entries, moved rationale to comments, and removed generic coding advice to focus on essential information.
Changelog
  • .agents/AGENTS.md
    • Simplified introductory text and tool descriptions.
    • Condensed 'MANDATORY' sections into concise rule references.
    • Grouped related entries in the 'Domain Index' table (e.g., Git/PRs/Releases, Documents/PDF).
    • Streamlined the 'Capabilities' section into a bulleted list with a single reference.
    • Shortened descriptions for Security and Working Directories sections.
  • .agents/build-plus.md
    • Refactored 'Core Responsibility' and 'Intent Detection' sections for brevity and directness.
    • Consolidated 'Quick Reference' items into a more compact bulleted list.
    • Streamlined 'Build Workflow' steps, removing verbose explanations and merging related actions.
    • Simplified 'Planning Workflow' and 'Planning File Access' sections.
    • Condensed 'Quality Gates,' 'Git Safety Practices,' and 'Communication Style' guidelines.
    • Shortened 'File Reading Best Practices'.
  • .agents/prompts/build.txt
    • Rewrote the 'Mission' statement to be more concise and direct, using bullet points.
    • Condensed 'Tone and style,' 'Professional objectivity,' 'Critical thinking,' 'Completion and quality discipline,' 'Task Management,' and 'Tool usage policy' sections.
    • Simplified 'Git Workflow' instructions.
    • Streamlined 'Context Compaction Survival' and 'Model-Specific Reinforcements' sections.
  • AGENTS.md
    • Removed 'Purpose' and 'Repo' from Quick Reference.
    • Consolidated 'AI Tool Config Paths' and 'Development Commands' into a single 'Commands' bullet.
    • Simplified 'File Structure' description.
    • Shortened references to 'Development Lifecycle' and 'Self-Assessment Protocol'.
Activity
  • No specific activity (comments, reviews, progress updates) was provided in the context for this pull request.
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.

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 34 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sat Feb 21 02:12:49 UTC 2026: Code review monitoring started
Sat Feb 21 02:12:49 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 34

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 34
  • VULNERABILITIES: 0

Generated on: Sat Feb 21 02:12:52 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

Copy link

@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 performs a significant context optimization pass, reducing token counts across core agent files. While generally effective, some critical operational directives were over-compressed, potentially leading to persona confusion, difficulty in managing shared worktrees, less effective memory retrieval, and a loss of guidance on code comment quality. The feedback identifies specific regressions where restoring key information or commands would maintain guardrails without significantly impacting token savings.

coderabbitai[bot]
coderabbitai bot previously requested changes Feb 21, 2026
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.agents/build-plus.md:
- Around line 96-133: There are MD022 markdownlint violations because several
"###" headings in the Build Workflow section lack a blank line after the heading
(examples: "1. Fetch URLs", "2. Understand the Problem", "2b. Domain Expertise
Check", "3-4. Investigate & Research", "5. Plan", "6. Code Changes", "7.
Debugging", "8. Testing", "9. Validate"); fix by inserting exactly one blank
line immediately after each of these "###" headings so the heading is separated
from its first content line, apply this same one-blank-line pattern to all other
"###" headings in the file, and re-run markdownlint/CI to confirm MD022 is
resolved.

In `@AGENTS.md`:
- Line 8: Update the Quick Reference entry that currently lists
"version-manager.sh release [major|minor|patch]" to use the full script path
".agents/scripts/version-manager.sh release [major|minor|patch]" so it matches
the Quality Workflow usage; locate the occurrence of the literal
"version-manager.sh release [major|minor|patch]" in AGENTS.md and replace it
with ".agents/scripts/version-manager.sh release [major|minor|patch]".

@marcusquinn marcusquinn dismissed coderabbitai[bot]’s stale review February 21, 2026 02:33

Auto-dismissed: bot review does not block autonomous pipeline

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 34 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sat Feb 21 02:49:14 UTC 2026: Code review monitoring started
Sat Feb 21 02:49:14 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 34

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 34
  • VULNERABILITIES: 0

Generated on: Sat Feb 21 02:49:17 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@sonarqubecloud
Copy link

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.

1 participant