governance-preamble

Define RBAC, layering, and error contract rules for Bunyan agents.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/majedsiefalnasr/bunyan-app-cursor --skill governance-preamble
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: governance-preamble
Source: https://github.com/majedsiefalnasr/bunyan-app-cursor/tree/main/.agents/skills/governance-preamble
Command: npx skills add https://github.com/majedsiefalnasr/bunyan-app-cursor --skill governance-preamble

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about governance-preamble

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce RBAC and standardized API error contracts across AI agents?

You can enforce RBAC and API error contracts by loading a universal governance baseline at agent startup to standardize behavior and policy enforcement across all workflows. This establishes a single source of truth for access control and consistent response shapes.

What is a governance baseline for AI agent architecture?

A governance baseline is a shared declaration loaded by all agents to enforce role-based access control, layered architecture rules, and a consistent error contract. It standardizes behavior across backend, frontend, auth, and agent workflows to ensure compliance.

How do I standardize API response formats across multiple agents?

Standardize API responses by implementing a defined error contract that enforces a consistent shape: { success, data, error }. This baseline is loaded at startup to guarantee all agents return uniform API responses across the entire system.

Can I use a governance preamble to enforce layered architecture and migration discipline?

Yes, a governance preamble enforces layered architecture by dictating that controllers handle HTTP, services contain business logic, and repositories handle data queries. It also implements forward-only migrations and strict naming conventions to prevent schema drift.

Do I need to load a governance baseline at startup to onboard new agents?

Yes, loading the governance baseline at startup initializes the universal policy enforcement baseline across all new agents. This ensures guaranteed compliance with RBAC, layered architecture rules, and standardized API error contracts from the beginning.

What roles should a role-based access control system for field operations include?

An RBAC system for field operations should include Customer, Contractor, Supervising Architect, Field Engineer, and Admin roles. Central RBAC enforcement ensures these five roles have defined access permissions across all agent workflows.