From 6900d54cfa71e933e981c9286df1de28b06477b2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ivett=20=C3=96rd=C3=B6g?= Date: Wed, 29 Jul 2026 16:50:52 +0200 Subject: [PATCH 1/3] Add Speak to Me pattern Co-Authored-By: Claude Opus 5 --- documents/patterns/speak-to-me.md | 22 ++++++++++++++++++++++ documents/relationships.mmd | 2 ++ 2 files changed, 24 insertions(+) create mode 100644 documents/patterns/speak-to-me.md diff --git a/documents/patterns/speak-to-me.md b/documents/patterns/speak-to-me.md new file mode 100644 index 0000000..fe20187 --- /dev/null +++ b/documents/patterns/speak-to-me.md @@ -0,0 +1,22 @@ +--- +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. + +Where Mind Dump uses voice as the input channel, Speak to Me uses it as the output channel. + +## Example +Add to the prompt or ground rules: "While working, announce your progress with the `say` command — one short sentence per milestone or blocker." + +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. + +A narrower variant appears in the Ground Rules example: "use ./speak.sh to talk to me out loud when you warn me about issues" — voice reserved for warnings only. diff --git a/documents/relationships.mmd b/documents/relationships.mmd index b4046f6..1058323 100644 --- a/documents/relationships.mmd +++ b/documents/relationships.mmd @@ -110,6 +110,8 @@ 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 -->|extends| patterns/polyglot-ai + patterns/speak-to-me -->|related| patterns/background-agent %% Anti-pattern → Obstacle relationships (causes) anti-patterns/distracted-agent -->|causes| obstacles/limited-focus From 3e789dbeacc968bef0cb4a8815e55078cd3ae335 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ivett=20=C3=96rd=C3=B6g?= Date: Wed, 29 Jul 2026 21:31:41 +0200 Subject: [PATCH 2/3] Drop the Speak to Me to Polyglot AI edge Co-Authored-By: Claude Opus 5 --- documents/relationships.mmd | 1 - 1 file changed, 1 deletion(-) diff --git a/documents/relationships.mmd b/documents/relationships.mmd index 1058323..9739d7d 100644 --- a/documents/relationships.mmd +++ b/documents/relationships.mmd @@ -110,7 +110,6 @@ 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 -->|extends| patterns/polyglot-ai patterns/speak-to-me -->|related| patterns/background-agent %% Anti-pattern → Obstacle relationships (causes) From c3432a4205c75316d04ab2c3a121b4110b4ec30b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ivett=20=C3=96rd=C3=B6g?= Date: Wed, 29 Jul 2026 21:32:25 +0200 Subject: [PATCH 3/3] Sharpen the Speak to Me example prompt Co-Authored-By: Claude Opus 5 --- documents/patterns/speak-to-me.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/documents/patterns/speak-to-me.md b/documents/patterns/speak-to-me.md index fe20187..4c2946a 100644 --- a/documents/patterns/speak-to-me.md +++ b/documents/patterns/speak-to-me.md @@ -12,11 +12,7 @@ Ask the agent to speak short progress updates out loud as it works, using a text 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. -Where Mind Dump uses voice as the input channel, Speak to Me uses it as the output channel. - ## Example -Add to the prompt or ground rules: "While working, announce your progress with the `say` command — one short sentence per milestone or blocker." +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. - -A narrower variant appears in the Ground Rules example: "use ./speak.sh to talk to me out loud when you warn me about issues" — voice reserved for warnings only.