Search docs
Docs searchValidation rule
Back to Rule CatalogAP-EVT-004Event ArchitectureEvent naming inconsistency
Flags event names that do not follow the repository's event naming convention.
warningviolationNo auto-fix
How to fix
- Use the established event naming convention.
- Prefer past-tense fact names for domain events when that is the local pattern.
- 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/srcpackages/contracts/src
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs