# Diagram Prompt Bank

Use this index to decide which diagram-generation prompt assets should feed the
master prompt and which should remain only as experiment history.

## Keep In Prompt Bank

- `diagram-master-prompt.md`: canonical source-free prompt for diagram
  generation, target selection, layout reflow, connector routing, validation,
  evidence, and final artifact hygiene.
- `mermaid-target-strategy.md`: target-selection guidance for when Mermaid is
  acceptable and when draw.io/Lucid-style editable geometry is needed.
- `v14-stress-test/README.md` and `v14-stress-test/stress-test.svg`: source-free
  validation fixture for checking whether the prompt rules catch bounded text,
  label lanes, containment, and connector route problems.

## Keep As Visual Examples, Not Prompt Rules

- `enterprise-set/*.svg`: source-free diagram candidates useful for visual QA
  practice. Do not copy their business labels into the master prompt.
- `payment-gateway/*`: architecture example useful for visual regression checks.
  Do not promote payment-domain wording into the master prompt.
- `salesforce-integration/*`: architecture example useful for target-format
  comparison. Do not promote platform-specific wording into the master prompt.

## Keep As Experiment Archive Only

- `state-uml-recreated.prompt.md` through `state-uml-recreated.prompt.v11.md`:
  historical deltas from a specific recreation exercise. Extract only generic
  rules already represented in v12/v14.
- `state-uml-recreated.prompt.v12.md` and `state-uml-recreated.prompt.v14.md`:
  reusable deltas that have been consolidated into `diagram-master-prompt.md`.
  Keep them only as provenance until the master prompt is accepted.
- `experiments/**/experiment.md` and `source-fidelity-review.md`: these contain
  downloaded-source observations and PDF/page-specific analysis. Keep them for
  traceability, but exclude their source text from the prompt bank.
- `experiments/**/*.mmd` and `experiments/**/*.svg`: rendered experiment outputs.
  Useful for manual comparison, not for master-prompt wording.

## Promotion Criteria

- Promote only rules that are domain-agnostic and apply to any diagram type.
- Exclude source text, platform names, business labels, PDF wording, and
  one-off coordinates from reusable prompt guidance.
- A prompt-bank candidate must include a validation rule, not only a drawing
  instruction.
- If two regenerated versions preserve the same visual error, the rule is not
  strong enough. Add a geometry-change requirement before keeping it.