Reverse spec drafted

Modal, drawer and full-page editor

Rules for choosing focused dialogs, side drawers or full-page editors by complexity and risk.

Observed routeShared componentFuture Spec 16 →

Current maturityConsistent visual pattern with safety and scale gaps

Evidence confidenceVerified

Last reviewedAugust 4, 2026

Visual evidenceDeferred during UI updates

Current-state summary

Internal Note, Task, Project Opportunity, Project Vision and Task Template dialogs share centered overlays, strong titles, supporting copy, close controls, sectioned content and Cancel/primary actions. Long forms can exceed the viewport, and the Task Edit defect shows that shared appearance does not guarantee correct command mode or loaded record identity.

Interface inventory

Anatomy and verified behavior

Verification states separate observed behavior from requirements or assumptions.

Element	Current behavior	Verification
Overlay and frame	Centered white surface over dimmed application.	Verified
Header	Title, explanation and close action.	Verified
Body	Supports simple composers and large sectioned forms.	Verified
Footer	Cancel and primary action commonly anchored.	Verified
Mode identity	Task Edit incorrectly opens blank Create mode.	Critical defect

User journeys

Current flows

Create or edit safely

Open explicit mode
Load target identity/version for Edit
Trap focus and announce title
Change fields
Validate
Confirm destructive impact when relevant
Save command
Return focus to invoker

State model

Current and expected states

Opening/loading

Not consistently separated.

Idle

Common form state.

Dirty

Unsaved-close warning is unverified.

Saving/error

Not consistently evidenced.

Conflict

Not represented.

Product rules

Non-negotiable boundaries

Create, Edit, View and Confirm are explicit modes.
Edit loads immutable target identity and current version before enabling save.
Focus is trapped and restored.
Escape/close respects unsaved changes.
Long workflows use full-page or stepped patterns when a modal becomes unmanageable.

Dependencies

Shared dialog primitiveDynamic formsCommands and optimistic concurrencyAccessibilityUnsaved-change service

Known current limitations · 4 mapped

What is missing, broken or unverified

Future Spec 16 owns closure →

Critical Task Edit mode defect.
Long forms can be unwieldy.
Focus, keyboard, mobile and conflict behavior are not fully verified.
Unsaved-change protection unverified.

Future alignment

Required evolution

01Enforce dialog mode and record identity centrally.
02Use full-page editors for complex builders.
03Add consistent validation, saving, error, conflict and focus behavior.

Current baseline

Acceptance record

The dialog announces its purpose and target.
Edit never opens blank Create state.
Keyboard and screen-reader use is complete.
Cancel cannot silently discard dirty work.

Reverse-spec completeness

Documentation coverage

The interface is still changing, so visual evidence and repository tracing remain intentionally incomplete.

Purpose and user outcome

Documented

Roles and access

Documented

Routes and entry points

Documented

Page and component anatomy

Documented

Fields and displayed data

Documented

Primary actions

Documented

Forms and validation

Documented

States and transitions

Documented

Empty, loading and error states

Documented

Responsive behavior

Partial

Accessibility behavior

Partial

Activity and audit events

Partial

Data sources and persistence

Documented

Notifications and automation

Partial

Known defects and limitations

Documented

Reusable component dependencies

Documented

Future-spec conflicts

Partial

Visual and repository evidence

Deferred

Acceptance of current baseline

Documented