Coding and Technical Work
A playbook, prompt starters, and disclosure statements for coding and technical work.
Playbook
- DEFINE: & pseudocode first. Write the problem statement, inputs/outputs, acceptance tests, and pseudocode before using AI.
- CHECK: with others. In a group, review the logic together before coding.
- GENERATE: from pseudocode. Use AI only to draft from your pseudocode or stubs. Be prepared to explain every line.
- TEST: & debug. Write unit tests (including edge cases), validate outputs, and remove hallucinated imports/functions.
- ITERATE: with understanding. Accept AI refactors/optimizations only if you can justify the trade-off (e.g., performance vs. readability).
- DOCUMENT: in your voice. Add comments/docstrings: purpose, assumptions, limitations. Tag AI-assisted blocks briefly.
- PACKAGE: & disclose. Submit pseudocode, final code, tests, run instructions, and an AI-use disclosure. Respect licensing/IP rules.
- DISCLOSE AI USE: add the AI-use disclosure before submitting.
Prompt Starters
Use these prompt starters to get more effective responses from AI.
Each follows the Role • Task • Requirement model:
- Role = the perspective you want AI to take,
- Task = what you want it to do,
- Requirement = limits, conditions, or style.
- Act as a software engineer (Role). Translate this pseudocode into Python (Task). Include type hints and inline comments (Requirement).
- Act as a QA tester (Role). Write unit tests for this function (Task). Include at least 3 edge cases in pytest format (Requirement).
- Act as a computer science tutor (Role). Explain the time and space complexity of this algorithm (Task). Keep the explanation under 150 words (Requirement).
- Act as a senior developer (Role). Refactor this function (Task) to improve readability and maintainability, without changing behavior (Requirement).
Disclosure Statements
When you use AI, always acknowledge it. Below are plug-and-play templates you can adapt depending on the type of assignment.
- I wrote pseudocode first and used [AI tool] to suggest improvements. I debugged, commented, and verified all code myself.
- I used [AI tool] to identify potential bugs. All fixes, explanations, and final code are my own.