repo-patterns

name	repo-patterns
description	Shared repository conventions for data fetching, issue format, database write helpers, and route modules. Referenced by agents instead of duplicating inline.

Repo Patterns

Shared conventions that multiple agents reference. Read this file when working on implementation, review, or issue management.

Data Fetching Conventions

Database Write Helpers

Audit-Log / Event-Sourcing Patterns

Permission and Role Checks

Route Module Conventions

GitHub Issue Format

When creating issues, use this format:

• Title: [Bug][<scope>][<severity>] <short title>
• Required sections:
  • ## Problem
  • ## Reproduction / Context
  • ## Diagnostics / Evidence
  • ## Expected behavior
  • ## Proposed direction
  • ## Acceptance criteria (with - [ ] <criterion> checkboxes)
• Required labels:
  • Always: bug
  • Always: one severity label from critical | major | minor
  • Include scope labels when applicable: frontend, backend, testing, ux, accessibility, localization, security, code-quality, mobile