All categories/Code and debugging
Writing code and tests · Level Advanced · Coding Coding Generation
Code generation: templates that are easy to change
Generating many similar modules by hand is too slow.
Prompt
Three defaults: define the input-output contract, then the error branches, then the happy path. An implementation without error handling is not finished.
Task: Generating many similar modules by hand is too slow.
[Before you start, do three things]
1. Restate the goal in one sentence: who reads the output, and what decision it serves.
2. If I have not given you the following, ask me. Do not assume:
- what differs between modules
- will generated code be maintained
- who maintains the template
3. Say how you plan to do it (at most 5 steps) and wait for my go-ahead.
[Go through each of these]
- extract the common shape; differences become parameters
- generated code must be editable; no 'do not edit' banner
- an example generating three modules with diffs
- state how to regenerate after a template change
[Process]
1. State the contract: inputs, outputs, errors, side effects
2. List every error branch and boundary first
3. Then the happy path, one responsibility per function
4. Test key paths: one normal, two failure cases
5. State when this code would fail
[Output]
Contract, errors, happy path, tests, failure conditions.
[Do not]
- Never ignore an error return
- Never swallow exceptions
- No magic numbers; name them
- Do not log-and-continue instead of returning an errorWhat to state before it starts
Leave these unsaid and the model fills them with an assumption. Most 'wrong answers' start here.
- what differs between modules
- will generated code be maintained
- who maintains the template
Go through each of these
Where this kind of work most often goes wrong. Already in the prompt, so you do not have to remember it.
- extract the common shape; differences become parameters
- generated code must be editable; no 'do not edit' banner
- an example generating three modules with diffs
- state how to regenerate after a template change