Treat prompts and source media as user-owned inputs, keep MediaHub credentials/config/execution in one reusable middle block, and reserve outputs for Preview/Save nodes.
Constraint: Samples must show users exactly which block to copy into an existing workflow.
Rejected: Classifying API Key and execution nodes as inputs or outputs | exposes internal mechanics and weakens sample readability.
Confidence: high
Scope-risk: narrow
Directive: Keep sample responsibilities separated and all connections flowing left to right.
Tested: 124 pytest tests; JavaScript syntax; Python compilation; JSON validation; live ComfyUI accepted all eight prompt structures.
Not-tested: Manual visual import of all eight revised examples.
Separate user-facing layout from API fixtures, keep provider menus scalable, and lock media-family boundaries before more integrations are delegated.
Constraint: User workflows must remain readable as providers and media families grow.
Rejected: Mechanical row-major workflow layout | valid but obscures data flow and wastes space.
Confidence: high
Scope-risk: narrow
Directive: Add new providers under MediaHub/Provider and add new media families as independent vertical slices.
Tested: 123 pytest tests; JavaScript syntax; Python compilation; JSON validation; restarted ComfyUI object_info; all eight prompt smoke workflows.
Not-tested: Manual visual import of all eight updated user workflows.
Van/攻城狮鹿鸣君