Update Agent Rules documentation to include organization rules and hierarchy #1246
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Renamed from 'Repository Rules' to 'Agent Rules' to reflect broader scope - Added comprehensive explanation of organization rules vs repository rules - Documented rule hierarchy: repository rules override organization rules - Added detailed configuration instructions for both rule types - Included practical examples showing rule hierarchy in action - Updated use cases to show organization-level vs repository-level examples
codegen-sh
bot
requested review from
a team and
codegen-team
as code owners
Codecov Report✅ All modified and coverable lines are covered by tests. |
- Added user rules as the first level in the three-tier hierarchy - Updated rule precedence: Repository > Organization > User - Added user rules configuration section with 'Coming Soon' note - Included user-level rule examples for personal preferences - Updated rule resolution process to include all three levels - Enhanced hierarchy examples to show user, org, and repo rules working together Co-authored-by: Jay Hack <jay@codegen.com>
jayhack
approved these changes
Sep 14, 2025
Contributor
|
🎉 This PR is included in version 0.56.21 🎉 The release is available on GitHub release Your semantic-release bot 📦🚀 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR updates the "Repo Rules" documentation to comprehensively cover the full agent rules system, including organization rules and the rule hierarchy.
Key Changes
📝 Renamed and Expanded Scope
🏗️ Added Rule Hierarchy Documentation
⚙️ Configuration Instructions
📚 Enhanced Examples and Use Cases
🔗 Improved Structure
Why This Matters
The previous documentation only covered repository rules, leaving users unaware of the powerful organization-level rule capabilities. This update provides a complete picture of how teams can use Codegen's hierarchical rule system to:
Related
This documentation update is based on the implementation in the
cloudrepository, specifically:settings_organization_rulesfield in Organization modelsettings_agent_rulesfield in Repo modelapp/agents/prompts/builder.py💻 View my work • 👤 Initiated by
Jay Hack• 💬 Initiated in #demo • About Codegen⛔ Remove Codegen from PR • 🚫 Ban action checks