Plain Language
Product copy must use everyday language rather than technical or domain-specific jargon — if a 10-year-old would need to look it up, rephrase it.
$ aoe install @community/rule-plain-languageProjection
Always in _index.xml · the agent never has to ask for this.
PlainLanguage [rule] v1.0.0
Product copy must use everyday language rather than technical or domain-specific jargon — if a 10-year-old would need to look it up, rephrase it.
Loaded when retrieval picks the atom as adjacent / supporting.
PlainLanguage [rule] v1.0.0
Product copy must use everyday language rather than technical or domain-specific jargon — if a 10-year-old would need to look it up, rephrase it.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
medium
Exceptions
- Developer tools and APIs where the audience is technical and the technical term is the correct one (e.g., 'webhook', 'API key', 'OAuth' in a developer console)
- Domain-specific B2B tools where the jargon is the user's native vocabulary (medical, legal, financial)
Loaded when retrieval picks the atom as a focal / direct hit.
PlainLanguage [rule] v1.0.0
Product copy must use everyday language rather than technical or domain-specific jargon — if a 10-year-old would need to look it up, rephrase it.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
medium
Exceptions
- Developer tools and APIs where the audience is technical and the technical term is the correct one (e.g., 'webhook', 'API key', 'OAuth' in a developer console)
- Domain-specific B2B tools where the jargon is the user's native vocabulary (medical, legal, financial)
Examples
- Violation: 'Authenticate your OIDC provider' → Correct: 'Connect your login service'
- Violation: 'Invalidate cache' (settings button) → Correct: 'Clear saved data'
- Violation: 'Webhook endpoint configured' (success state) → Correct: 'Notifications set up'
- Violation: 'Your API rate limit has been exceeded' → Correct: 'You've made too many requests — please wait a moment'
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
medium
Exceptions
- Developer tools and APIs where the audience is technical and the technical term is the correct one (e.g., 'webhook', 'API key', 'OAuth' in a developer console)
- Domain-specific B2B tools where the jargon is the user's native vocabulary (medical, legal, financial)
Source
aoe-engine/examples/frontend-design/primes/compiled/@community/rule-plain-language/atom.yaml