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.