marketing: build public product evidence and demo system

[eybersjp]

Purpose

Create a professional, evidence-first marketing system for Development Kit aimed at public users, developers, technical evaluators, and potential investors.

What this draft adds

• Canonical media/ structure for screenshots, short demonstrations, social-preview artwork, and video thumbnails.
• Authenticity, privacy, naming, sizing, and publication standards for product evidence.
• A five-capture evidence plan covering npm installation, OpenCode startup, Autopilot lifecycle state, approval gates, and release validation.
• A concrete capture-and-publish checklist with asset specifications, privacy review, documentation activation, and final merge gates.
• A repeatable neutral demo project brief.
• A 75 to 90 second public product video storyboard and narration.
• A two to three minute investor and strategic-partner demonstration narrative.
• A README showcase template that must remain inactive until real media exists.
• A recording, privacy, and accuracy checklist.
• A long-form product showcase structure.
• Documentation-home navigation to the new marketing/ workspace.

Evidence policy

Only real Development Kit execution may be presented as product evidence. Mock interfaces, fabricated terminal output, staged validation results, and AI-generated product UI must not be described as screenshots or execution proof.

Current validation

The complete CI suite passes on the planning branch, including framework, plugin, documentation, OpenCode, Autopilot, and evaluation gates.

Do not merge yet

This pull request should remain a draft until the following real assets exist and have been reviewed:

• media/screenshots/npm-installation.png
• media/screenshots/opencode-startup-menu.png
• media/screenshots/autopilot-lifecycle-status.png
• media/screenshots/approval-gate.png
• media/screenshots/release-validation.png
• media/demos/quick-install.webp
• media/demos/autopilot-overview.webp
• media/social/repository-preview.png
• media/social/product-demo-thumbnail.png
• A stable public URL for the captioned full product demonstration

Final activation work

Follow the capture-and-publish checklist. In summary:

1. Capture and independently review the real evidence.
2. Add the canonical media files and evidence metadata.
3. Replace planning language in marketing/product-showcase.md with real evidence captions.
4. Activate the prepared See Development Kit in action section in the root README.
5. Verify the documentation-home link to marketing/README.md.
6. Verify every image, animation, documentation, npm, GitHub, and public-video link.
7. Run npm run release:validate against the final asset commit.
8. Merge only after all links, privacy checks, evidence claims, and validation results are verified.

Release impact

No package version change is required while this remains planning and documentation work. A patch release should be considered only if media or packaging changes affect the published npm artifact.