App Development
For application development tasks, refer to the reference files that match the current task before designing or editing code.
Core References
For naming variables, fields, functions, components, stores, API data, or operational state, refer to references/naming.md.
For frontend code, especially React, MobX, component structure, package imports, icons, editable UI, or visual stability, refer to references/frontend-design.md.
For backend APIs, HTTP response format, request handling, or backend data shape, refer to references/backend-design.md.
For timestamps, timezone fields, time serialization, database time columns, or time-based display, refer to references/time-format.md.
For IDs, database primary keys, random IDs, or time-based IDs, refer to references/id-format.md.
UI Feature References
For in-place editing, inline renaming, contenteditable behavior, submit or cancel behavior, locked edit state, or IME-sensitive editing, refer to references/renaming.md.
For selector UI, choosing one or more resources, searchable dropdowns, selected tags, cached search results, selector state, or selector-backed MobX stores, refer to references/selector.md.
Deployment Reference
For apps deployed behind CloudFront, reverse proxy, URL prefix, Vite base path, prefixed API URL, forwarded auth, or WebSocket through proxy, refer to references/deploy-cloudfront.md.
When Writing Documents
For explaining an overall implementation plan, such as architecture choices or semantic model of core concepts, refer to references/doc-design.md.
For summarizing debug experience, refer to references/doc-tech-guide.md.
Working Rules
For project-specific choices, prefer the referenced guidance over generic defaults.
For tasks where multiple references apply, read all relevant files before making changes.
For old relative paths inside reference files, resolve them within the references/ folder.