usability enhancements

openspec/changes/p13-usability-enhancements/specs/article-permalinks-and-deep-link-modal/spec.md

@@ -0,0 +1,25 @@
+## ADDED Requirements
+
+### Requirement: Each news item exposes a permalink
+The system SHALL expose a stable, shareable permalink for each rendered news item.
+
+#### Scenario: Per-item permalink rendering
+- **WHEN** a news item is rendered in hero or feed context
+- **THEN** the UI provides a permalink target tied to that article context
+
+#### Scenario: Permalink copy/share usability
+- **WHEN** a user uses share/copy affordances for an item
+- **THEN** the resulting URL contains sufficient information to resolve that article on load
+
+### Requirement: Deep-link loads article modal in open state
+The system SHALL open the matching article modal when the page is loaded with a valid article permalink.
+
+#### Scenario: Valid permalink opens modal
+- **WHEN** a user lands on homepage with a permalink for an existing article
+- **THEN** the corresponding article modal is opened automatically
+- **AND** modal content matches the permalink target
+
+#### Scenario: Invalid permalink fails safely
+- **WHEN** a permalink references a missing or invalid article identifier
+- **THEN** the page remains usable without hard failure
+- **AND** modal is not opened with incorrect content