Skip to main contentJobWhat the prompt should accomplishState the task in terms another author could reuse without reinterpretation.
Source factsWhat the assistant should rely onName the inputs or evidence the prompt is allowed to use.
ContractWhich schema or artifact family appliesKeep the prompt anchored to the right versioned family and terminology.
Output constraintsWhat success should look likeSeparate required content, optional content, and forbidden shortcuts.
If the rules belong in the schema, move them there instead of hiding them in the prompt.
Reusable prompts work best when they describe the task, the expected input shape, and the output constraints without forcing the reader to guess.
Recommended Approach
- Start with the job the prompt should accomplish.
- Name the source facts the assistant should use.
- State which schema or artifact family the prompt belongs to.
- Keep the instructions concrete enough that another author could reuse them without reinterpreting them.
- Match the prompt to the versioned domain or artifact family it supports.
Good Prompt Traits
- The prompt says what success looks like.
- The prompt separates required content from optional content.
- The prompt uses the same terminology as the public standards pages.
- The prompt does not smuggle in rules that belong in the schema or specification.