Search docs

Docs search
Back to Rule Catalog
AP-EVT-004Event Architecture

Event naming inconsistency

Flags event names that do not follow the repository's event naming convention.

warningviolationNo auto-fix

How to fix

  1. Use the established event naming convention.
  2. Prefer past-tense fact names for domain events when that is the local pattern.
  3. Update publisher, handler, and contract names together.

What it means

An event name appears inconsistent with adjacent event names or documented conventions.

Why it matters

Consistent event naming helps teams understand event meaning, ownership, and lifecycle.

Common causes

  • Some events are named as commands and others as facts.
  • Pluralization or tense varies across modules.
  • Renames did not update all references.

Example bad pattern

StartUpload, RepositoryUploadedEvent, and upload_finished all describe the same style of event.

Example good pattern

RepositoryUploaded follows the same noun/verb tense convention as adjacent events.

Related files/config

  • apps/api/src
  • packages/contracts/src

Related CLI commands

  • archpilot validate
  • archpilot validate --ci
AP-EVT-004 - Event naming inconsistency | ArchPilot Docs