governance-preamble

What problem does it solve?

Shared governance declaration for all Bunyan agents, ensuring a single source of truth for agent behavior and policy enforcement.

Core Features & Use Cases

• Central RBAC enforcement with five roles: Customer (عميل), Contractor (مقاول), Supervising Architect (مهندس مشرف), Field Engineer (مهندس ميداني), Admin (إدارة)
• Layered architecture rules: Controllers handle HTTP, Services contain business logic, Repositories handle data queries, Models define relationships and constraints
• Standardized error contract: All API responses use a consistent shape: { success, data, error }
• Migration discipline: forward-only migrations and strict naming conventions to prevent schema drift
• Use Case: Onboard new agents with a guaranteed governance baseline to ensure compliance across systems

Quick Start

Load the governance-preamble at startup to initialize the universal baseline across all Bunyan agents.