Risk Assessment - Gravity Toy

Version: 0.1.0
Date: 2026-04-13
Status: Active visual

1. Purpose

Capture the main implementation, usability, and delivery risks for the Gravity Toy visual.

2. Key Risks

R-01 Simulation instability risk

Extreme orbital interactions or repeated merges may create chaotic velocities that reduce readability or push bodies off-screen too quickly.

Mitigation:

• softened gravity term
• capped launch mass
• escape-margin cleanup for runaway bodies
• preset tuning for stable starting conditions

R-02 Touch interaction risk

Drag-to-launch may behave inconsistently across mobile touch flows if move/end handling is incomplete or hard to discover.

Mitigation:

• explicit touch start/move/end/cancel handling
• visible ghost circle and launch arrow
• simple bottom hint text on load

R-03 Reduced-motion regression risk

Visual effects may continue animating or the page may not pause correctly when reduced motion is requested.

Mitigation:

• central reduced-motion gating for trails and transient effects
• auto-paused reduced-motion state
• manual smoke verification in browser

R-04 Documentation drift risk

The visual page and its local docset may diverge as the toy evolves quickly.

Mitigation:

• local URS, FS, DS, TEST_PLAN, IQ, and OQ set
• render public HTML mirrors with npm run docs:render
• update CHANGELOG.md and docs hub in the same change

R-05 Performance risk

Too many active bodies or expensive render effects may reduce responsiveness on mid-range mobile devices.

Mitigation:

• orb cap
• bounded trail length
• light 2D canvas rendering only
• no external runtime dependencies

3. Delivery Position

The current residual risk is acceptable for a static experimental visual, provided the visual remains lightweight, documented, and manually smoke-tested after behavior changes.