Dictation Instructions

Dictation Instructions

Technical Context

GitHub Agentic Workflows (gh-aw) is a CLI tool for writing agentic workflows in natural language using markdown files and running them as GitHub Actions. When fixing dictated text, use these project-specific terms and conventions.

Project Glossary

actions activation add-comment add-labels add-reviewer admin agent-task agentic-workflow agentic-workflows allowed-domains allowed-exts allowed-labels allowed-repos api-key api-url app-id args array assign-milestone assign-to-agent assign-to-user assignees attestations audit auto-close auto-merge auto-triage automation base-branch bash body boolean branch branch-name branch-protection-rule branches bug cache cache-memory campaign-id campaigns cancel-in-progress chatops check-run check-suite checkout checks choice-param claude claude-sonnet close-discussion close-issue close-pull-request code-review code-scanning-alert codex command-line command-triggered command-triggers comment-triggered commit commit-sha compile concurrency config config-stdin container containers contents context-aware copilot copilot-cli create-agent-task create-code-scanning-alert create-discussion create-issue create-pull-request create-pull-request-review-comment credentials cross-repo cross-repository custom custom-agent custom-agents custom-memory custom-safe-outputs custom-tool dailyops debug-mode default-deny dependencies deployment deployment-status description disable discussion-comment discussions dispatchops docker-container downstream-fork dry-run edit enable endpoint engine engine-id environment-variables error-patterns event event-triggered event-type expression fail-fast fail-on-cache-miss false-positive feature-flag fetch-depth filter fork format frontmatter gh-aw github-script github-token glob grep head-ref http-mcp id-token import inline input issue-comment issue-number issue-tracker issueops issues job job-name json key label labelops latest limit lint local lock-yml lockfile log logs main-branch markdown matrix max-parallel mcp-gateway mcp-server mcp-servers merge-commit metadata metrics milestone milestone-number missing-tool multi-repo multirepoops network network-access network-permissions no-cache npm-install npx on-demand org-admin org-level output output-dir packages permissions pip-install playwright pr-number pre-commit private-key private-repo projectops pull-request pull-request-review-comment pull-requests push read recompile remote remote-repo repo-name repo-owner repository-dispatch researchplanassign reviewer run-id run-name runs-on safe-input safe-inputs safe-output safe-outputs sandbox scheduled secret-name secrets security-events server-url setup-node setup-python sha siderepoops sse-server status-check step-id strict-mode sub-task sync-repo tag team-members template timeout-minutes token-permissions tool-name toolset toolsets tools triage-analysis trialops trigger-workflow ubuntu-latest unix-timestamp update-discussion update-issue update-pull-request upstream-repo use-cache user-agent view web-fetch web-search webhook webhook-url windows-latest workflow-dispatch workflow-file workflow-id workflow-name workflow-run workflow-run-id write yaml

Fix Speech-to-Text Errors

Common speech-to-text misrecognitions and their corrections:

Safe Outputs/Inputs

• "safe output" → safe-output
• "safe outputs" → safe-outputs
• "safe input" → safe-input
• "safe inputs" → safe-inputs
• "save outputs" → safe-outputs
• "save output" → safe-output

Workflow Terms

• "agent ic workflows" → agentic workflows
• "agent tick workflows" → agentic workflows
• "work flow" → workflow
• "work flows" → workflows
• "G H A W" → gh-aw
• "G age A W" → gh-aw

Configuration

• "front matter" → frontmatter
• "tool set" → toolset
• "tool sets" → toolsets
• "M C P servers" → MCP servers
• "M C P server" → MCP server
• "lock file" → lockfile

Commands & Operations

• "re compile" → recompile
• "runs on" → runs-on
• "time out minutes" → timeout-minutes
• "work flow dispatch" → workflow-dispatch
• "pull request" → pull-request (in YAML contexts)

GitHub Actions

• "add comment" → add-comment
• "add labels" → add-labels
• "close issue" → close-issue
• "create issue" → create-issue
• "pull request review" → pull-request-review

AI Engines

• "co-pilot" → copilot
• "Co-Pilot" → Copilot
• "code X" → codex
• "Code X" → Codex

Spacing/Hyphenation Ambiguity

When context suggests a GitHub Actions key or CLI flag:

• Use hyphens: timeout-minutes, runs-on, cache-memory
• In YAML: prefer hyphenated form
• In prose: either form acceptable, prefer hyphenated for consistency

Guidelines

You do not have enough background information to plan or provide code examples.

• Do NOT generate code examples
• Do NOT plan steps or provide implementation guidance
• Focus ONLY on fixing speech-to-text errors (misrecognized words, spacing, hyphenation)
• When unsure, prefer the hyphenated form for technical terms
• Preserve the user's intended meaning while correcting transcription errors