Useful ways to work with AI

Keep the context you need. Choose how to explain the task. Take a practical template into your next session.

Choose how to give an instruction

Compare input methods, understand tool boundaries, and combine spoken context with exact text.

How can I tell whether dictation helps my actual coding requests rather than just producing more words?

Typing or Dictation? Compare the Whole AI Request Workflow

Compare typing and dictation with a task-matched worksheet that includes preparation, correction, review and a consistent ready-to-send finish line.

Should I use typing, system dictation, a text-entry app or a conversation companion on Mac?

Choose a Dictation Route for AI Work on Mac

Choose typing, macOS Dictation or a supported conversation companion by destination, review needs and processing stages.

Understand the code or investigate a problem

Trace unfamiliar code and give an agent the relevant evidence for a focused investigation.

How do I turn one failing test into a repair request without blessing a wrong assertion?

Turn One Failing Test into a Bounded Agent Request

Connect a failing assertion to its requirement, distinguish implementation and expectation errors, and bound a small repair with meaningful cases.

Define the change you need

Turn interface feedback and data requirements into behavior you can check.

A product builder consolidates several people's observations and suggestions before authorizing one implementation request.

Turn Conflicting Spoken Feedback into One Agent Brief

Keep three feedback sources separate, record decisions and one unresolved conflict, then build an agent brief from settled constraints.

How do I describe an API change so old and new consumers can be checked?

Describe an API Change as a Contract the Agent Can Check

Turn an API change into a checkable contract with request and response examples, compatibility boundaries and an OpenAPI 3.1.1 teaching document.

Who may read or change each record, and what happens when access changes?

Specify Who Can Read and Change a Record

Define record-level read and change permissions with a role matrix, adverse cases, membership withdrawal history and a bounded agent brief.

Continue and coordinate the work

Resume a task, define dependencies, and bring separate changes together with clear ownership.

What should I preserve so I can return to an AI coding task after an interruption?

Resume an AI Coding Task with a Useful Handoff Card

Keep a compact handoff card with the task, artifacts, decisions and next action, plus two filled examples for resuming AI coding work.

Review and document a change

Match a change to its request and evidence, then explain it in a review, pull request, or developer guide.

How should I explain partial batch outcomes before deciding what to repeat?

Explain a Partly Successful Batch Before Repeating It

Use a five-item outcome ledger to separate success, skipped, failed and unknown effects, then define a bounded correction and reconciliation plan.