This directory holds feature-specific references and design briefs that used to
live inline in docs/bugs.md.
Use docs/bugs.md for active bugs, known design limitations, and
small implementation follow-ups. Use the files here for feature behavior,
design decisions, and future plans.