Mach

Developer workflow

A practical voice-dictation workflow for coding

Use voice to give coding agents context, think through bugs, and draft technical updates without trying to dictate punctuation-heavy code.

5 minute read

Use voice for intent, not syntax

Voice is strongest when the hard part is explaining a system: what is happening, what should happen, which constraints matter, and how you will know the work is correct. That maps naturally to prompts for coding agents, issue reports, review notes, and implementation plans.

The keyboard still wins for symbol-heavy code, tiny edits, exact identifiers, and anything where one character changes the meaning. A useful workflow switches between both inputs instead of treating voice as a total keyboard replacement.

A repeatable agent brief

Before opening Cursor, Claude Code, Codex, or another coding agent, put the cursor in the prompt field and dictate four things in order: the outcome, the relevant context, the constraints, and the verification.

“Fix the reconnect bug in the Mac client. Start with the lifecycle controller and WebSocket manager. Do not add a background retry loop. Preserve cancellation while connecting, then run the focused lifecycle tests.”

Three high-leverage uses

Long prompts are only one use. Voice also removes friction from the smaller communication jobs surrounding development.

  • Debugging notes: describe observed behavior, expected behavior, reproduction steps, and the strongest log clue.
  • Pull-request context: explain why the change exists, which trade-offs you chose, and what reviewers should inspect closely.
  • Async updates: turn rough progress into a clear Slack message without interrupting the coding flow.

Keep sensitive material out of prompts

Do not dictate passwords, API keys, access tokens, private customer data, or production secrets. Voice input does not change the security boundary of the text field receiving the result. Treat dictated prompts exactly like typed prompts.

For identifiers that are safe but unusual, add them to your vocabulary or correct them once before sending. Read any destructive command, migration, billing change, or security-sensitive instruction before an agent acts on it.

Try the ten-minute test

For one coding session, use voice only for prompts longer than two sentences and for your final status update. Keep the keyboard for code and precise edits. If the agent receives better context and you spend less time polishing the surrounding prose, the workflow is already paying for itself.