Core Rule

The Consistency Rule

A teammate comparing Add and Edit must see the same fields, same validation rules, same error messages, same layout, and same loading and success behavior.

Difference Allowed Why
Page or modal titleYesContext label only
Submit button labelYesAction wording only
Pre-filled values in EditYesExisting data is loaded
Some fields disabled in EditOnly if intentionalDocumented business rule required
Additional Edit-only fieldsOnly if they do not exist at creation timeExamples: created_at, post-creation status

Live Add / Edit Example

Add Project
Edit Project
Behavior Add Edit
FieldsName, Status, DescriptionName, Status, Description
Validation schemaSharedShared
Field orderSame orderSame order
Spacing and layoutShared componentShared component
Button wordingCreate ProjectSave Changes

Shared Component Requirement




Field Consistency




Validation Consistency




UI and Layout Consistency




Pre-Fill Behavior (Edit Only)

Good Edit Loading State



Submit Behavior