Resources

Master prompts

Investigate and fix a bug — master prompt

Turn a vague failure into a reproducible case and a focused regression fix.

CodexClaude CodeCursor
Pristren originalFree1.0.0 · original authored template; documentation reviewed 2026-11-17

A supported root-cause explanation, a minimal fix, and a check that fails before and passes after.

Use this prompt after supplying a concrete project or task and the constraints that determine success. Select your AI tool in the workflow for host-specific setup. Review the prerequisites and choose only relevant resources; the prompt does not automatically include an entire directory.

Reproduce the reported behavior and record evidence before editing the implementation.

After execution, check the workflow’s acceptance criteria against observed behavior. Treat illustrative examples as examples, and record anything not actually verified. Project details stay in your browser when you tailor this template.

Make the prompt yours.

Master prompt

Complete project or task to copy your tailored prompt.

Investigate and fix the bug in [Describe the project, audience, and useful result.]. Respect Use existing project conventions. State assumptions and verify the result..

Start from the reported behavior and expected result. Inspect applicable project guidance and identify a minimal reproduction using safe data. Record the affected environment and the exact observable failure. If you cannot reproduce it, state what is missing and narrow the uncertainty; do not invent a root cause.

Trace the failing data or control flow to the smallest responsible boundary. Separate evidence from hypotheses. Check nearby callers and state transitions so the proposed fix addresses the cause rather than hiding the symptom. Implement a focused change consistent with existing conventions. Avoid opportunistic refactors and unrelated formatting.

Add or adapt a meaningful regression check at the appropriate level. Where feasible, demonstrate that the check fails against the prior behavior and passes after the fix. Run the relevant existing checks, inspect the diff, and describe the root cause, changed behavior, and any remaining cases. Do not claim the whole application is verified from one successful test.

Execution environment: Codex. Follow applicable project instructions and verify the requested result.

Use it with your tool.

Documentation reviewedChecked 2026-11-17

Tool setup checked against official documentation. Pristren has not executed this workflow through this tool.

  1. Start Codex in the repository and read applicable AGENTS.md guidance. Include only the files this task needs.
  2. Reproduce the reported behavior and record evidence before editing the implementation.
  3. Use the acceptance checks below to assess the result; an agent completion message is not evidence that the task passed.
Official setup documentation

License and access: MIT for this Pristren-authored prompt or instruction text.

Part of a bigger picture.

Workflow

Investigate and fix a bug

Turn a vague failure into a reproducible case and a focused regression fix.

Prompt, setup & checksCodex / Claude Code / Cursor

Sources and review notes