Dev Conventions — firstsun-blog

Core rules always in effect. For domain-specific detail, read the relevant reference file before writing code.

Situation	Read
Writing DB mutations / Astro Actions	`references/database.md`
Adding or changing actions / updating OpenAPI spec	`references/api.md`
Adding SEO tags, RSS, or sitemap changes	`references/seo-rss.md`
Adding images, tools (mini-apps), or content queries	`references/tools-images.md`
Writing or planning e2e tests	`references/testing.md`
Creating or modifying tool pages under `src/apps/tools/`	`references/tool-pages.md`

Code Quality

No eslint-disable comments. Fix the root cause. If the file is dependency-emitted and you truly can't touch it, document why in a comment.