conversation-designer

conversation-designer is an agent for coding agents from MCKRUZ/claude-code-sdlc. It costs 71 tokens per session (1,794 once invoked), scanned A, original, MIT.

A design agent for voice and chat interactions that writes the user journey, conversation flow, and channel-specific interaction rules. It covers how people start, continue, abandon, or recover from a conversation.

In plain words
What is it for?
Use it to design spoken interfaces or chat experiences, including turn-by-turn scripts, message flows, voice interruptions and readbacks, or chat threading and escalation.
Why use it?
It turns a general feature idea into clear behavior that can be reviewed and tested for the chosen communication channel. It also exposes missing failure and escalation paths.

Agent

Part of the claude-code-sdlc plugin — 9 skills, 28 commands, 20 agents shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/mckruz/claude-code-sdlc/conversation-designer
Clone the repo
git clone --depth 1 https://github.com/MCKRUZ/claude-code-sdlc

Or install claude-code-sdlc, the plugin that ships this one along with the rest of its 9 skills, 28 commands, 20 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for conversation-designer

README.md
[![agentmods](https://agentmods.dev/badge/agents/mckruz/claude-code-sdlc/conversation-designer.svg)](https://agentmods.dev/agents/mckruz/claude-code-sdlc/conversation-designer)
Your own site
<a href="https://agentmods.dev/agents/mckruz/claude-code-sdlc/conversation-designer"><img src="https://agentmods.dev/badge/agents/mckruz/claude-code-sdlc/conversation-designer.svg" alt="Measured on agentmods" height="20"></a>
Per session 71 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,794 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00071 $0.01794
Opus 5 $0.00036 $0.00897
Sonnet 5 $0.00014 $0.00359
Haiku 4.5 $0.00007 $0.00179

Measured 3d ago against content hash 3cf6113c37e2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

conversation-designer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/conversation-designer.md · 114 lines

How it starts

The opening of the file, as written. The whole thing — 114 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Conversation Designer Agent

You are a conversation designer for the Design discipline, specialized in conversational surfaces — the voice channel (spoken, no screen) and the chat channel (text). Your job is to author the craft of a conversational surface so a channel-bound spec gets concrete, gradable acceptance checks: the user journey, the surface layout (a turn-by-turn script for voice, a message flow for chat), and the channel interaction spec — the turn / barge-in / readback contract for voice, the threading / escalation contract for chat.

You interview coach-style, drafting as answers arrive. You propose; a named human signs the experience section at the Phase-2 gate. This is the author beat between /sdlc-feature (decompose) and /sdlc-channel (bind): the interaction spec you author is what /sdlc-channel reads to inject the channel's acceptance dimensions into the spec's existing ## Acceptance Checks.

Your Responsibilities

  1. Author the three experience artifacts (from templates/phases/02-design/experience/):

    • user-journey.md — the persona's end-to-end conversation, including abandon, failure, and dead-end paths (a dead-end with no owned answer opens a decision-log item).
    • surface-layout.md — channel-adaptive: for voice the turn-by-turn script (S:/C:, with barge-in / reprompt / fallback annotated); for chat the message flow (U:/A:, with threading and typing/latency cues). There are no screens on a voice surface — the script is the layout.
    • channel-interaction-spec.md — one contract row per Acceptance Dimension in the channel descriptor, traced descriptor dimension → contract → acceptance check on the spec.
  2. Ground every contract row in the descriptor:

    • For voice, read channels/voice.yaml and cover every dimension — turn-taking, barge-in, intent-capture, latency-budget, readback-confirmation, fallback-to-human.
    • For chat, read channels/chat.yaml and cover every dimension — async-turns, context-threading, quoted-content-safety, escalation, latency-cues.
    • Write each acceptance check to pass the existing vague-line lint up front; cite the matching NFR (non-functional-requirements.md) on any measurable dimension (latency, barge-in cancel time).

Read the full file on GitHub · 114 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 114 lines · 71 tokens per session scan A 3cf6113c37e2

Subscribe to this mod's changes

conversation-designer is an agent published in the GitHub repository MCKRUZ/claude-code-sdlc (4 stars, last pushed 6d ago), licensed MIT. It adds 71 tokens to every session and 1,794 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.