# Yoker: Naming Documentation

## The Name

**yoker** (noun): One who yokes. A person or device that joins or attaches things together.

## Etymology

The word "yoker" derives from:

- **yoke** (noun): A device for joining draft animals together for coordinated work
- **-er** (suffix): Agent noun suffix indicating "one who does"
- **PIE root \*yeug-**: Proto-Indo-European root meaning "to join"

This same root connects to many related words:
- **yoga** (Sanskrit): Union
- **join, joint, junction**: Connection words
- **conjugate**: Joined together
- **subjugate**: Literally "bring under the yoke"
- **zygote**: Biological fusion

## Why "Yoker"?

### The Meaning Fits

A yoker is literally "one who yokes" - the agent noun from "yoke". In the context of an agent harness:

- **Yoking agents together**: The harness coordinates multiple agents for coordinated work
- **The joining metaphor**: Just as a yoke joins draft animals, yoker joins agents
- **Active role**: The "-er" suffix emphasizes the active, agentive nature

### Pairs with "Clitic"

"clitic" is a linguistic term for a word that cannot stand alone and must attach to another word (like the 's in "it's"). This is clever naming for a CLI tool.

"yoker" pairs beautifully with "clitic":
- Both are joining tools
- clitic joins words; yoker joins agents
- Both are short, memorable names

## Dictionary Meanings

1. **Primary meaning**: One who yokes - an occupational term for someone who yokes animals. Historical example: "the Buzygae (yokers of oxen)" from 1871.

2. **Dialect meaning**: A British dialect word (Northern English) meaning "to spit" - pronounced /jəʊkə/. This is obscure and unlikely to cause confusion.

3. **Place name**: Yoker is a district in Glasgow, Scotland (Gaelic: An Eochair, meaning "river bank"). No negative connotations.

## Decision

**"yoker"** was selected as the package name because:

1. **Agent noun**: "one who yokes" - fits the agent harness concept
2. **Etymology**: Strong PIE root meaning "to join"
3. **Pairs with clitic**: Both are joining tools
4. **No conflicts**: No negative connotations or trademark issues
5. **Short and memorable**: Five letters, two syllables

---

**Research Date**: 2026-04-14