Promptles
Clarity

Name the Services

Name the service, the version, and the endpoint.

When connecting to external APIs or SaaS tools, name the exact service, its API version, and the specific endpoint or resource. 'Connect to Stripe' is vague. Claude might use a deprecated API or the wrong endpoint. 'Use the Stripe API v2023-10-16 POST /v1/customers endpoint' is actionable. Precision here prevents subtle integration bugs that only surface in production.

Where you'll practice this

2 Promptles scenarios teach this principle directly. Each one drops you into a real engineering ticket and asks you to write the prompt you'd send to Claude Code.

  • The Stripe Webhook Handler

    You need a Node.js Express endpoint in a file called `webhook.js` that listens for Stripe `checkout.session.completed` webhooks. The endpoint should verify the webhook signature using the Stripe library, extract the customer email and amount paid from the event, and insert a row…

  • The Collection Scaffold

    Your team is integrating with a payments service called Lattice Pay (REST API, version 2024-08). It exposes five endpoints: `POST /v1/tokens` (exchange card details for a token), `GET /v1/charges` (list charges), `POST /v1/charges` (create a charge), `GET /v1/customers/:id`…

Other principles in Clarity