Update Agent Rules documentation to include organization rules and hierarchy

[codegen-sh]

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

• Changed title from "Repository Rules" to "Agent Rules" to reflect the broader rule system
• Updated content to cover both organization and repository rules

🏗️ Added Rule Hierarchy Documentation

• Documented the two-level rule system: Organization Rules → Repository Rules
• Explained rule precedence: Repository rules override organization rules when conflicts exist
• Added clear examples showing how rules interact across levels

⚙️ Configuration Instructions

• Added detailed steps for configuring organization rules
• Updated repository rule configuration instructions
• Included links to appropriate settings pages

📚 Enhanced Examples and Use Cases

• Split examples into organization-level vs repository-level categories
• Added practical scenarios showing rule hierarchy in action
• Included real-world examples of coding standards, security requirements, and process rules

🔗 Improved Structure

• Better organized content with clear sections for each rule type
• Added helpful tips and notes about rule management
• Maintained all existing information about automatic rule file detection

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:

• Set organization-wide standards that apply to all repositories
• Override those standards for specific repositories when needed
• Maintain consistency across their entire codebase while allowing flexibility

Related

This documentation update is based on the implementation in the cloud repository, specifically:

• Organization rules: settings_organization_rules field in Organization model
• Repository rules: settings_agent_rules field in Repo model
• Rule resolution logic in app/agents/prompts/builder.py

---

💻 View my work • 👤 Initiated by Jay Hack • 💬 Initiated in #demo • About Codegen
⛔ Remove Codegen from PR • 🚫 Ban action checks

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

[github-actions]

🎉 This PR is included in version 0.56.21 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀