The Developer's AI Prompt Handbook: Code Refactoring, Unit Testing & Debugging

Software engineers using AI assistants can significantly accelerate boilerplate creation, code modernization, test coverage expansion, and legacy refactoring. However, sending unconstrained code snippets often results in subtle regressions and security vulnerabilities.

Below is a curated collection of developer prompts designed for strict type safety, clean architecture, and comprehensive test suite generation.

1. The Clean Code Refactoring Prompt

Act as a Staff Software Engineer. Refactor the following [Python / TypeScript] code to improve readability, maintainability, and performance:

[INSERT CODE]

Requirements:
Apply SOLID principles and clean architecture design patterns.
Ensure strict type annotations (Pydantic / TypeScript types).
Replace nested conditionals with early return guard clauses.
Add clear docstrings explaining arguments, return types, and potential raised exceptions.
Provide a summary of all architectural improvements made.

2. Comprehensive Unit Test Suite Generator (Pytest / Jest)

Act as a Senior QA Automation Engineer.
Write a comprehensive unit test suite using [pytest / Jest / Vitest] for the following function:

[INSERT FUNCTION]

Test Requirements:
Happy path test cases covering expected inputs and standard outputs.
Edge cases (empty arrays, null/None inputs, boundary numbers, Unicode strings).
Failure cases asserting proper exception handling and status codes.
Use parameterized tests / mocks where appropriate.
Maintain 100% branch and statement coverage.