Skip to content

Docs: glossary of key domain concepts - #56

Merged
mforce merged 1 commit into
mainfrom
docs/glossary
Jul 16, 2026
Merged

mforce merged 1 commit into
mainfrom
docs/glossary

Conversation

@mforce

@mforce mforce commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Adds specs/product/GLOSSARY.md — one-page definitions of the domain language (flock lifecycle, bird ledger, daily entry states, grades, lots/FIFO/withdrawal, orders, money, tenancy/idempotency/Version/date conventions), linked from README and AGENTS.md. Docs-only. Includes the bird-ledger terms landing in #55.

specs/product/GLOSSARY.md defines the domain language in one place —
flock lifecycle (active/depleted/archived, backfill rules), the bird
ledger (mortality vs cull vs adjustment, append-only corrections),
daily entry states and what submit generates, grades and saleability,
egg lots / FIFO allocation / withdrawal restrictions, order lifecycle,
money-as-minor-units, and the cross-cutting concepts (tenancy,
idempotency keys, Version tokens, operational dates).

Linked from README (Specs & roadmap) and AGENTS.md (phase context) so
both humans and agents find it before renaming or modeling anything.
@mforce
mforce merged commit 2c3c2e5 into main Jul 16, 2026
2 checks passed
@mforce
mforce deleted the docs/glossary branch July 26, 2026 02:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant