Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions documents/patterns/speak-to-me.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
authors: [ivett_ordog]
---

# Speak to Me

## Problem
You hand the agent a longer task and turn to something else. Watching the terminal defeats the purpose of delegating — but ignoring it means you discover problems late and miss the moments where a quick answer from you would unblock it.

## Pattern
Ask the agent to speak short progress updates out loud as it works, using a text-to-speech command (`say` on macOS). One short sentence per update: milestones reached, direction changes, blockers, questions for you.

Voice becomes an ambient status channel: you follow the work without looking at it, and it claims your attention only when something actually needs it.

## Example
Add to the prompt or ground rules: "While working on long tasks, use the `say` command to get my attention. Use it when you hit a blocker, change direction or reach a major milestone. Keep the announcements short, fewer than 10 words."

You review another PR or cook dinner. In the background you hear: "Tests are green, starting the refactor." … "The migration is failing, I need your input." You come back exactly when you're needed — not before, not too late.
1 change: 1 addition & 0 deletions documents/relationships.mmd
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,7 @@ graph LR
patterns/ai-first-responder -->|uses| patterns/background-agent
patterns/ai-first-responder -->|uses| patterns/focused-agent
patterns/ai-first-responder -->|uses| patterns/orchestrator
patterns/speak-to-me -->|related| patterns/background-agent

%% Anti-pattern → Obstacle relationships (causes)
anti-patterns/distracted-agent -->|causes| obstacles/limited-focus
Expand Down
Loading