Llm Prompt

# LLM prompt reference

Canonical description of **what platform-ui ships for LLM-assisted skin generation + refinement**. If you integrate an external LLM (not via `semitexa/llm`), use this as the reference for output contract, prompt template, and validation rules.

## Shipped artifacts

All under `packages/semitexa-platform-ui/resources/llm/`:

- **`skin-resolve-prompt.md`** — system prompt template for **generation**. Contains a `{{ALGORITHM_SECTIONS}}` placeholder replaced at runtime by `PromptResolverFactory` with a markdown block describing every registered algorithm (id, description, knob schema). Adding a new algorithm requires zero edits to this file.
- **`skin-resolve-fewshot.json`** — 9 labeled examples covering all three algorithms (balanced / glass / brutalist) and mood categories. Each example is validated against the output contract before shipping.
- **`skin-resolve-schema.json`** — JSON Schema draft 2020-12 defining the strict output contract.

Refinement (`skin:refine`) uses a **different** system prompt, built dynamically from the target skin's algorithm knob schema in `Semitexa\PlatformUi\Llm\RefinementResolver::buildSystemPrompt()`. It is not loaded from a file because the prompt must reflect the current knob values of the skin being refined.

## Generation output contract (enforced by `OutputValidator`)