# Permissions Package AI Agent Instructions (`packages/permissions`)

> **Package:** `@keluargamart/permissions`  
> **Role:** Canonical 198 RBAC Permissions Catalog & Evaluation Helpers

---

## 1. Responsibilities

- Holds the exact list of 198 permissions defined in `apps/backend/internal/modules/rbac/catalog.go`.
- Exports `PERMISSIONS` dictionary, `can(permissions, requiredPermission, role)`, and `isSuperAdmin(role)`.
- Provides full TypeScript declaration in `src/index.d.ts`.

---

## 2. Modification Rules

1. **Source of Truth**: Permissions are authored first in `apps/backend/internal/modules/rbac/catalog.go`.
2. **Synchronize Package**: Update `src/permissions.txt`, `src/index.js`, and `src/index.d.ts`.
3. **Verify Zero Drift**: Run `pnpm drift:check` from root.
4. **Run Package Tests**: `pnpm --filter @keluargamart/permissions test`.