Developer Messages

Report a Blocker Template

Report blockers clearly with next-step context.

Use this template to report a blocker in a way that is clear, calm, and actionable. It helps teammates understand what is blocked, who or what is needed, and what happens next.

Starting tone: Direct
Situation: Report Blocker

Before and after

Example message tuned with Tono

Example input

Blocked on API access from infra side.

Example output

I am currently blocked by missing API access from the infrastructure side. Once access is granted, I can proceed with implementation immediately.

When to use this template

Reporting blocked engineering or project work
Explaining what dependency is stopping progress
Asking for help without sounding vague or frustrated

Tips before you send

Name the blocker directly so the recipient can act on it.
Include the dependency or owner if you know who can unblock it.
Add the next step you can take once the blocker is resolved.

Tune this message in Tono

Tono will prefill the composer with this template's situation and tone. Replace the example with your own message, generate a few options, then copy the version that fits.

Try this template in Tono

Common questions

When should I use the Report a Blocker template?

Reporting blocked engineering or project work

Can I customize this developer messages message?

Yes. Start with the example, replace the details with your own context, then tune it in Tono before sending.

Does Tono send the message for me?

No. Tono only helps tune the wording. You should review, edit, copy, and send the final message yourself.

Related templates

Browse all templates

developerblockerstatus