docs: add glossary of canonical bot-bottle terminology #475

Merged
didericis merged 1 commits from docs/474-glossary into main 2026-07-24 00:14:29 -04:00
Collaborator

Summary

  • Adds docs/glossary.md with canonical definitions for the seven key terms identified in #474: Agent Provider, Agent Runtime, Agent/Agent Definition, Bottle/Bottle Definition, Sealed Bottle, Bottled Agent (with active/frozen substates), and Active Bottle.
  • Updates docs/README.md to include the glossary in the artifact table.
  • Adds a pointer to the glossary in AGENTS.md for future agent session discoverability.

Test plan

  • Read docs/glossary.md and verify all seven terms from the issue are defined clearly and consistently with current code/docs usage.
  • Confirm docs/README.md links the glossary correctly.
  • Confirm AGENTS.md references the glossary file.

Closes #474

🤖 Generated with Claude Code

## Summary - Adds `docs/glossary.md` with canonical definitions for the seven key terms identified in #474: Agent Provider, Agent Runtime, Agent/Agent Definition, Bottle/Bottle Definition, Sealed Bottle, Bottled Agent (with active/frozen substates), and Active Bottle. - Updates `docs/README.md` to include the glossary in the artifact table. - Adds a pointer to the glossary in `AGENTS.md` for future agent session discoverability. ## Test plan - [x] Read `docs/glossary.md` and verify all seven terms from the issue are defined clearly and consistently with current code/docs usage. - [x] Confirm `docs/README.md` links the glossary correctly. - [x] Confirm `AGENTS.md` references the glossary file. Closes #474 🤖 Generated with [Claude Code](https://claude.com/claude-code)
didericis added 1 commit 2026-07-24 00:12:35 -04:00
docs: add glossary of canonical bot-bottle terminology
lint / lint (push) Successful in 56s
tracker-policy-pr / check-pr (pull_request) Successful in 15s
1972c8c6e9
Defines Agent Provider, Agent Runtime, Agent/Agent Definition,
Bottle/Bottle Definition, Sealed Bottle, Bottled Agent, and Active Bottle.
Links from docs/README.md and AGENTS.md for discoverability.

Closes #474

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
didericis force-pushed docs/474-glossary from f11c5e1d86 to 1972c8c6e9 2026-07-24 00:12:35 -04:00 Compare
didericis merged commit 1972c8c6e9 into main 2026-07-24 00:14:29 -04:00
didericis deleted branch docs/474-glossary 2026-07-24 00:14:29 -04:00
Sign in to join this conversation.