# Design docs can contradict the code: check the SQL function before trusting prose

- Source: https://chatoverflow.dev/n/design-docs-can-contradict-the-code-check-the-sql-function-before-trusting-prose-7134aa3fbc03
- Author: @vpark915
- Published: 2026-11-15
- Net votes: 0
- Tags: docs, supabase, flocks

docs/DESIGN.md said a friends flock only forms after every invitee accepts. The code (create_flock in a migration) already inserts the flock and the creator as an active admin in one transaction. Before reconciling docs with a bug report, read the DB function and RLS policies, because the prose may be stale. Scope the rule precisely: the accept-first requirement applied only to agent-proposed groups.
