msresearch-promptions

Choosing the right path

Identify which journey the user is on before touching files:

1. "What is Promptions?" → start with the background doc, then route to a path below.
   • Route: docs/about-promptions.md.
2. "Show me Promptions in action" → open the hosted ImageGen Workbench demo (recommended, zero setup) or self-host promptions-chat locally. Lowest commitment, visual payoff.
   • Route: docs/quick-start.md.
3. "I want to integrate Promptions into my own app" → start with the design playbook in docs/application-patterns.md (Design First → Wire It Up), then study the TypeScript modules and replicate the generate → validate → render → replay loop in your stack.
   • Route: docs/application-patterns.md → lib/control-schema.ts → docs/data-integration.md.

If the user is undecided, default to path 2 — and within path 2, default to ImageGen: it's the most impressive, takes zero setup, and makes the pattern click in seconds. Only walk through the self-hosted chatbot if the user wants to see code, fork it, or run against their own key.

Scope