🧭 TOPICS

Prompt engineering

Contracts, examples, and evaluation rather than slogans.

Prompt engineering for API work begins with defining the job. An extraction prompt needs a record contract and an unknown-value policy. An answer prompt needs evidence and a clear expectation for missing information. A library becomes useful when these responsibilities can be reviewed and tested separately.

The two guides below form a practical pair. One develops a compact reusable extraction pattern. The other builds a fixture suite for evaluating grounded answers, version conflicts, unsupported claims, and trust boundaries. Both use fictional examples so the expected behavior is visible to the reviewer.

Keep prompts beside their tests and source-record revisions. When behavior changes, the team should be able to identify which layer changed rather than repeatedly rewriting the whole instruction. The prompts and evaluation collection provides the reading order, and the sample catalog supplies a companion data structure for extraction work.

2 field notes in this topic