clawfort/openspec/specs/summary-modal-experience/spec.md

Purpose

Canonical specification for summary-modal-experience requirements synced from OpenSpec change deltas.

Requirements

Requirement: Summary is rendered in a modal dialog using standard template

The system SHALL render article summary content in a modal dialog using the required structure.

Scenario: Open summary modal

• WHEN a user triggers summary view for an article
• THEN a modal dialog opens and displays content in this order: relevant image, TL;DR bullets, summary body, source and citation, and "Powered by Perplexity"
• AND modal content corresponds to the selected article

Scenario: Close summary modal

• WHEN a user closes the modal via close control or backdrop interaction
• THEN the modal is dismissed cleanly
• AND user returns to previous feed context without page navigation

Scenario: Permalink-driven modal open

• WHEN page is loaded with a valid article permalink state
• THEN the modal opens for the linked article without requiring manual click

Requirement: Modal content preserves source link-out behavior

The system SHALL provide source link-outs from the summary modal.

Scenario: Source link-out from modal

• WHEN a user clicks source/citation link in the modal
• THEN the original source opens in a new tab/window
• AND modal behavior remains stable for continued browsing

Scenario: Modal exposes share entry points

• WHEN a summary modal is open for an article
• THEN share controls for the article permalink are available from modal/footer share area