wireword

Wireword

Wireword reviews agent control words.

A control word is any short label that changes what an agent does, where work is routed, which tool runs, which environment is targeted, or which prompt macro is expanded.

Review steps

1. Extract control words from the user's prompt, config, or plan.
2. Check for labels that are easy to confuse.
3. Explain the risk in terms of recoverability, not style.
4. Suggest clearer replacements.

Flag high-risk pairs

Flag labels when they have:

• visual confusability: A1 / AI / Al
• edit distance 1: docs.api / doc.api
• case-only difference: Prod / prod
• punctuation-only difference: FACTCHECK_API / FACT_CHECK_API
• overloaded environment meaning: prod / production / live
• vague single-letter labels: A, B, C
• shared stem with different target: plan / planner

Suggested output

Use this format:

HIGH docs.api / doc.api
Reason: edit distance 1. One typo can become another valid route.
Fix: rename to ROUTE_DOCS_REVIEW and ROUTE_DOCS_PUBLISH.

Naming guidance

Prefer labels with distinct words:

ROUTE_DOCS_REVIEW
ROUTE_BILLING_EXPORT
ENV_PRODUCTION
ENV_STAGING
MACRO_FACTCHECK_API

Avoid compact labels that rely on one character:

A1
AI
Al
P1
PI
Pl

Historical note

Telegraph codebooks used similar thinking. The two-letter-difference principle made it less likely that one damaged codeword would silently become another valid codeword. Wireword applies that principle to agent control words.