usability enhancements

openspec/changes/p13-usability-enhancements/specs/share-and-contact-microinteractions/spec.md

@@ -0,0 +1,28 @@
+## ADDED Requirements
+
+### Requirement: Modal/footer exposes minimal icon-based share actions
+The system SHALL provide icon-only social share actions for article permalinks on supported providers.
+
+#### Scenario: Supported share providers
+- **WHEN** share controls are rendered
+- **THEN** icons for `X`, `WhatsApp`, and `LinkedIn` are displayed
+- **AND** activating an icon opens provider share flow with the article permalink
+
+### Requirement: Footer supports env-driven GitHub and contact links
+The system SHALL conditionally render GitHub and contact-email links from environment-backed configuration.
+
+#### Scenario: Config present
+- **WHEN** GitHub URL and contact email are configured
+- **THEN** footer renders both links as interactive controls
+
+#### Scenario: Config absent
+- **WHEN** either value is missing
+- **THEN** corresponding footer control is hidden without breaking layout
+
+### Requirement: Contact affordance provides randomized safe microcopy
+The contact link SHALL present randomized, policy-safe helper messages to encourage feedback.
+
+#### Scenario: Randomized helper tooltip
+- **WHEN** user hovers or nears the contact affordance
+- **THEN** a tooltip-style helper message is shown from a predefined safe message pool
+- **AND** message language avoids profanity/offensive/racist/sexist/misogynistic content