Noun Based Nav Labels
Navigation labels must be noun-based, consistent, present-tense, and free of jargon, marketing language, or cleverness — users navigate to destinations, not actions.
$ aoe install @community/rule-noun-based-nav-labelsProjection
Always in _index.xml · the agent never has to ask for this.
NounBasedNavLabels [rule] v1.0.0
Navigation labels must be noun-based, consistent, present-tense, and free of jargon, marketing language, or cleverness — users navigate to destinations, not actions.
Loaded when retrieval picks the atom as adjacent / supporting.
NounBasedNavLabels [rule] v1.0.0
Navigation labels must be noun-based, consistent, present-tense, and free of jargon, marketing language, or cleverness — users navigate to destinations, not actions.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
medium
Exceptions
- Action-oriented apps (to-do lists, task managers) where the primary nav item is a verb+noun: 'Add Task' as a shortcut — acceptable if accompanied by a noun destination
Loaded when retrieval picks the atom as a focal / direct hit.
NounBasedNavLabels [rule] v1.0.0
Navigation labels must be noun-based, consistent, present-tense, and free of jargon, marketing language, or cleverness — users navigate to destinations, not actions.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
medium
Exceptions
- Action-oriented apps (to-do lists, task managers) where the primary nav item is a verb+noun: 'Add Task' as a shortcut — acceptable if accompanied by a noun destination
Examples
- Correct: Dashboard, Projects, Settings, Billing, Team
- Violation: 'Discover' — verb, not a destination
- Violation: 'Your Journey' — vague, no specific meaning
- Violation: 'HQ' for Settings — internal jargon
- Violation: 'Explore Plans' in main nav — CTA, belongs on a button
Relations
related: [@community/rule-navigation-flat-when-shallow, @community/fact-recognition-over-recall]
Rationale
Navigation is a wayfinding system. Users scan nav items to recognize their destination, not to be persuaded. Verbs ('Discover', 'Explore') describe actions and belong on buttons, not nav items. Jargon requires domain knowledge that new users lack.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
medium
Exceptions
- Action-oriented apps (to-do lists, task managers) where the primary nav item is a verb+noun: 'Add Task' as a shortcut — acceptable if accompanied by a noun destination
Source
aoe-engine/examples/frontend-design/primes/compiled/@community/rule-noun-based-nav-labels/atom.yaml