Skip to content

Instantly share code, notes, and snippets.

@thehappybug

thehappybug/code-prompt-template.md

Created June 22, 2026 07:48
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save thehappybug/386fe5f39ce87720398209b8ca296abb to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save thehappybug/386fe5f39ce87720398209b8ca296abb to your computer and use it in GitHub Desktop.
Download ZIP
Raw
code-prompt-template.md

Task

[Single imperative sentence. e.g. "Add pagination to the GET /users endpoint."]

Intent

[One or two sentences on why. e.g. "To prevent timeouts when the users table is large."]

Relevant Context

  • [File or module to read first]
  • [Existing pattern to follow, e.g. "see how /posts handles this in routes/posts.ts"]

Constraints

  • [e.g. "Do not change the public API surface"]
  • [e.g. "No new dependencies"]
  • [e.g. "Follow the error-handling pattern in lib/errors.ts"]

Out of Scope

  • [Adjacent thing the agent might reasonably touch but shouldn't]

Testing

[e.g. "Write unit tests for new logic. All existing tests must continue to pass."]

Acceptance Criteria

  • [Specific, verifiable condition]
  • [e.g. "GET /users?page=2&limit=20 returns 200 with the correct slice and a total count"]

Ambiguity Protocol

[Either: "Stop and ask before proceeding if something is unclear." Or: "Proceed with the most conservative assumption and leave a TODO comment explaining it."]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment