Skip to content

docs: document voice and language blocks in AGENT_SCRIPT rules - #124

Closed
alexandramartinez wants to merge 1 commit into
trailheadapps:mainfrom
alexandramartinez:alexandramartinez/agent-script-voice-rules
Closed

docs: document voice and language blocks in AGENT_SCRIPT rules#124
alexandramartinez wants to merge 1 commit into
trailheadapps:mainfrom
alexandramartinez:alexandramartinez/agent-script-voice-rules

Conversation

@alexandramartinez

@alexandramartinez alexandramartinez commented Aug 7, 2026

Copy link
Copy Markdown

What does this PR do?

Extends the Agent Script ruleset (.airules/AGENT_SCRIPT.md) to document voice and language configuration — the syntax introduced by the RubberDuckDebuggerSpokenStyle bundle in #123. The change is purely additive documentation:

  • Adds a Language Block section (default_locale, additional_locales).
  • Adds a Voice Blocks section documenting connection telephony and modality voice, including a requirements/gotchas list (voice-provisioned org, voice-supported locale, org-specific voice_id, ear-tuned instructions).
  • Adds a Voice Blocks entry to the top-level block-ordering reference (as the last block, after subagents).
  • Adds three voice-agent items to the Validation Checklist.

What issues does this PR fix or reference?

Relates to #95. Follow-up to #123 (the rubberDuckDebugger recipe) — this documents the ruleset side of the voice syntax that recipe demonstrates. Best reviewed/merged after #123.

The PR fulfills these requirements:

  • Tests for the proposed changes have been added/updated.
  • Code linting and formatting was performed.

Functionality Before

Ruleset had no documentation for language, connection telephony, or modality voice blocks.

Functionality After

Contributors have documented syntax, ordering, and a validation checklist for building voice-enabled agents.

🤖 Generated with Claude Code

Adds Language Block and Voice Blocks sections to the Agent Script ruleset,
covering connection telephony and modality voice configuration, the block
ordering for voice blocks, and voice-agent items in the validation
checklist. Documents the syntax used by the RubberDuckDebuggerSpokenStyle
recipe.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alexandramartinez
alexandramartinez requested a review from a team as a code owner August 7, 2026 18:31
@alexandramartinez

Copy link
Copy Markdown
Author

Superseded by #127, recreated as a non-fork branch (alexandramartinez/agent-script-voice-rules) off main so CI can run with secrets.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants