docs/adapters/terminology-and-structure-gaps
Agent-Adapter Terminology & Structure Gaps guide
The adapters family has pervasive naming inconsistencies across 42 packages, 8 binaries, and 3,500+ source references. This directory documents every gap and the target naming convention.
Pages in this section
Start with the section hub, then move sideways into adjacent pages when you need more detail.
Binary Renames
Page8 CLI binaries need alignment to adapters-{feature} pattern.
wiki/docs/adapters/terminology-and-structure-gaps/binary-renames.md
3,500+ references to adapters in source code identifiers, file names, and paths.
wiki/docs/adapters/terminology-and-structure-gaps/code-identifier-renames.md
Directory Moves
Page5 top-level adapter packages + 12 hooks-adapter packages need to move under the packages/adapters/ umbrella.
wiki/docs/adapters/terminology-and-structure-gaps/directory-moves.md
348+ references to ADAPTER environment variables need renaming to AGENTMUX.
wiki/docs/adapters/terminology-and-structure-gaps/env-var-renames.md
Package Renames
Page42 adapter-related packages need naming alignment to @a5c-ai/adapters-{feature}.
wiki/docs/adapters/terminology-and-structure-gaps/package-renames.md
Agent-Adapter Terminology & Structure Gaps
The adapters family has pervasive naming inconsistencies across 42 packages, 8 binaries, and 3,500+ source references. This directory documents every gap and the target naming convention.
Target Convention
- **Package name**:
@a5c-ai/adapters-<feature>(e.g.,@a5c-ai/transport-adapter) - **Directory**:
packages/adapters/{feature}/(all under adapters umbrella) - **Binary**:
adapters-{feature}(e.g.,adapters-hooks) - **Env vars**:
AGENT_MUX_*(noADAPTER_*) - **Code identifiers**:
agentMux*camelCase (noadapters*) - **No "adapters" anywhere** — it's a bad abbreviation
Documents
1. **package-renames.md** — All 42 packages: current → target name + directory 2. **binary-renames.md** — All 8 binaries: current → target name 3. **env-var-renames.md** — All ADAPTER_* → AGENT_MUX_* mappings 4. **code-identifier-renames.md** — adapters* → agentMux* in source code 5. **directory-moves.md** — Top-level packages to move under adapters/