feat(wbfy): tell agents that AGENTS_EXTRA.md is the only editable instruction file

[exKAZUu]

Customer Summary

• Every repository maintained by wbfy will now tell AI agents that AGENTS.md, CLAUDE.md, GEMINI.md, .cursor/rules/general.mdc, and .gemini/styleguide.md are generated files, and that AGENTS_EXTRA.md is the only file to edit for agent instructions.
• This prevents agents from hand-editing generated files whose changes would be lost on the next wbfy run.
• The line appears in each repository after its next wbfy run; no action is required from repository owners.

Technical Summary

• Adds one bullet to the General Instructions template in packages/wbfy/src/generators/agents.ts, placed right after the .tmp bullet and before the conditional instructions.
• Regenerates this repository's own AGENTS.md, CLAUDE.md, GEMINI.md, and .cursor/rules/general.mdc so they carry the new line.
• The wording matches the existing rule in docs/expected-repository-rules.md.

Why

• Agents frequently edited CLAUDE.md directly, and wbfy silently overwrote those edits on its next run.
• Stating the ownership rule inside the generated files themselves reaches every agent that reads them.

Testing

• bun run verify passed.
• bun test test/unit/agentInstructions.test.ts in packages/wbfy passed.
• CI passed on the merged head.

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! 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 updates the generated agent instructions to ensure that contributors and automated agents understand the correct workflow for modifying configuration files. By centralizing the source of truth to AGENTS_EXTRA.md, it prevents potential conflicts and manual effort loss caused by automated overwrites.

Highlights

• Instruction Update: Added a clear directive to the generated agent instructions specifying that AGENTS_EXTRA.md is the single source of truth for agent configuration.
• Prevention of Overwrites: Explicitly warned agents that multiple generated files are overwritten during every wbfy run, preventing accidental manual edits.

New Features

🧠 You can now enable Memory (public preview) to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

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 the 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 counterproductive. 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.

---

The files are built by code's own hand, / To follow rules as you have planned. / Edit the source and not the rest, / To keep your agents at their best.

Footnotes

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

[gemini-code-assist]

Code Review

This pull request updates the generated agent instructions in packages/wbfy/src/generators/agents.ts to clarify that several documentation and configuration files (such as AGENTS.md, CLAUDE.md, etc.) are auto-generated from AGENTS_EXTRA.md and overwritten on every run, directing developers to only edit AGENTS_EXTRA.md. There are no review comments, and I have no additional feedback to provide.