Skip to content

Conversation

@nanotaboada
Copy link
Owner

@nanotaboada nanotaboada commented Jan 24, 2026

  • Reduce copilot-instructions.md to thin pointer file (~500 tokens)
  • Add AGENTS.md with operational procedures (on-demand loading)
  • Implement tiered loading to minimize auto-loaded token cost
  • Add token efficiency headers explaining load strategy

Instructions now use thin pointer architecture: essential context auto-loads, detailed procedures load on-demand via #file reference.


This change is Reviewable

Summary by CodeRabbit

  • Documentation
    • Reorganized and optimized operational guidance for improved clarity and efficiency.
    • Added comprehensive documentation covering development setup, workflow, and project architecture.
    • Restructured instructions to prioritize essential information and streamline on-demand resource references.

✏️ Tip: You can customize this high-level summary in your review settings.

- Reduce copilot-instructions.md to thin pointer file (~500 tokens)
- Add AGENTS.md with operational procedures (on-demand loading)
- Implement tiered loading to minimize auto-loaded token cost
- Add token efficiency headers explaining load strategy

Instructions now use thin pointer architecture: essential context
auto-loads, detailed procedures load on-demand via #file reference.
@coderabbitai
Copy link

coderabbitai bot commented Jan 24, 2026

Warning

Rate limit exceeded

@nanotaboada has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 0 minutes and 59 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

Documentation refactoring reorganizes guidance into two files: .github/copilot-instructions.md condensed to token-optimized instructions with on-demand references, while new AGENTS.md consolidates operational details including setup, workflows, CI/CD, architecture, and troubleshooting.

Changes

Cohort / File(s) Summary
Documentation Restructuring
.github/copilot-instructions.md, AGENTS.md
Replaces detailed Java/Spring Boot specifics in copilot instructions with condensed, token-efficient guidance and external references. Moves comprehensive operational content (setup, DevOps, CI/CD, troubleshooting, API endpoints) to new AGENTS.md file. Net: 53 lines added, 259 removed.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • PR #229: Directly related as both modify .github/copilot-instructions.md—this PR condenses the file to token-optimized guidance, while PR #229 took the opposite approach of adding comprehensive project-specific details.
🚥 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 uses Conventional Commits format (docs:), is well under 80 characters (57 chars), and accurately summarizes the main change: optimizing AI agent instructions for token efficiency.
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 feat/optimize-ai-agent-instructions

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.

@codacy-production
Copy link

codacy-production bot commented Jan 24, 2026

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation Diff coverage
+0.00% (target: -1.00%)
Coverage variation details
Coverable lines Covered lines Coverage
Common ancestor commit (a2f1350) 55 55 100.00%
Head commit (51fdabd) 55 (+0) 55 (+0) 100.00% (+0.00%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details
Coverable lines Covered lines Diff coverage
Pull request (#255) 0 0 ∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

@codecov
Copy link

codecov bot commented Jan 24, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (a2f1350) to head (51fdabd).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files
@@             Coverage Diff             @@
##              master      #255   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
  Complexity        22        22           
===========================================
  Files              2         2           
  Lines             55        55           
  Branches           4         4           
===========================================
  Hits              55        55           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link

@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: 1

🤖 Fix all issues with AI agents
In `@AGENTS.md`:
- Around line 97-117: Update the "Database Management" section: change the
runtime DB filename from storage/books.db to storage/books-sqlite3.db, correct
the statement about auto-recreation by replacing "Next app startup will recreate
via JPA" with a note that spring.jpa.hibernate.ddl-auto=none disables schema
generation and deleting the DB will cause startup failure (require restoring
from backup or manual reinitialization), and fix the tests config filename to
src/test/resources/application.properties; reference these exact identifiers
(storage/books-sqlite3.db, spring.jpa.hibernate.ddl-auto,
src/test/resources/application.properties) when making the edits.
🧹 Nitpick comments (3)
AGENTS.md (2)

171-193: Add language identifier to fenced code block.

The code block showing the project structure should specify a language identifier for better rendering and accessibility.

📝 Suggested fix
-```
+```text
 src/main/java/ar/com/nanotaboada/java/samples/spring/boot/
 ├── Application.java              # `@SpringBootApplication` entry point

88-90: Add language identifier to fenced code block.

The code block showing the JAR file path should specify a language identifier for consistency.

📝 Suggested fix
-```
+```text
 target/java.samples.spring.boot-{version}.jar
</details>

</blockquote></details>
<details>
<summary>.github/copilot-instructions.md (1)</summary><blockquote>

`25-29`: **Add language identifier to ASCII diagram.**

The fenced code block containing the architecture diagram should specify a language identifier for better rendering.


<details>
<summary>📝 Suggested fix</summary>

```diff
-```
+```text
 Controller → Service → Repository → JPA → Database
      ↓          ↓           ↓
 Validation  Cache    Query Methods
</details>

</blockquote></details>

</blockquote></details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

- Update runtime DB filename to storage/books-sqlite3.db
- Clarify spring.jpa.hibernate.ddl-auto=none disables schema generation
- Fix test config path to src/test/resources/application.properties
@sonarqubecloud
Copy link

@nanotaboada nanotaboada merged commit 3ca43c7 into master Jan 24, 2026
17 checks passed
@nanotaboada nanotaboada deleted the feat/optimize-ai-agent-instructions branch January 24, 2026 19:55
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