Upfront Field Requirements
Mandatory fields, format requirements, and character limits must be visible before the user attempts to submit — never revealed only after a validation error.
$ aoe install @community/rule-upfront-field-requirementsProjection
Always in _index.xml · the agent never has to ask for this.
UpfrontFieldRequirements [rule] v1.0.0
Mandatory fields, format requirements, and character limits must be visible before the user attempts to submit — never revealed only after a validation error.
Loaded when retrieval picks the atom as adjacent / supporting.
UpfrontFieldRequirements [rule] v1.0.0
Mandatory fields, format requirements, and character limits must be visible before the user attempts to submit — never revealed only after a validation error.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
warning
Applies When
designing any form with mandatory fields, format constraints, or character limits
Verify By
Load the form without interacting. Are required fields marked? Are format hints (e.g. 'MM/DD/YYYY') visible? Are character limits shown? All must be present before submission attempt.
Use Instead
Display required-field markers (*), format hints, and character limits inline before submission attempt.
Loaded when retrieval picks the atom as a focal / direct hit.
UpfrontFieldRequirements [rule] v1.0.0
Mandatory fields, format requirements, and character limits must be visible before the user attempts to submit — never revealed only after a validation error.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
warning
Applies When
designing any form with mandatory fields, format constraints, or character limits
Verify By
Load the form without interacting. Are required fields marked? Are format hints (e.g. 'MM/DD/YYYY') visible? Are character limits shown? All must be present before submission attempt.
Use Instead
Display required-field markers (*), format hints, and character limits inline before submission attempt.
Examples
- Phone field: shows 'Enter with country code e.g. +1 555 000 0000' as placeholder or helper text before any interaction.
- Password creation: character requirements (8 chars, 1 number, 1 symbol) shown below the field before typing.
- Character limit: a 280-character bio field shows '0 / 280' counter before the user starts typing.
- Bad: a date field that only reveals 'Please enter MM/DD/YYYY format' after the user submits '15/3/2026'.
Relations
related: [@community/check-form-label-associated, @community/check-form-validation-inline, @community/check-error-message-associated]
Rationale
Discovering requirements only through errors creates frustration and extra round-trips. Users who fill a form correctly the first time are more likely to convert and trust the product.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
warning
Applies When
designing any form with mandatory fields, format constraints, or character limits
Verify By
Load the form without interacting. Are required fields marked? Are format hints (e.g. 'MM/DD/YYYY') visible? Are character limits shown? All must be present before submission attempt.
Use Instead
Display required-field markers (*), format hints, and character limits inline before submission attempt.
Source
aoe-engine/examples/frontend-design/primes/compiled/@community/rule-upfront-field-requirements/atom.yaml