Imported from aktky/toss (
packages/web/AGENTS.md). Install upstream withnpx skills add aktky/toss --skill web. Copyright stays with the author.
Web Rules
Scope
- Applies to
packages/web/**.
Stack
- This package uses Astro. Prefer Astro pages/layouts/components over client-side JS unless interaction requires it.
- Keep route structure file-based under
src/pages/**. - Reuse helpers in
src/lib/**and shared layout pieces insrc/layouts/**andsrc/components/**. - Use Bun-first tooling for scripts and local execution (
bun run ...).
Styling
- Keep styling consistent with existing global styles and Tailwind usage.
- Prefer shared tokens and variables over page-local hardcoded values.
- Keep user-facing text in English.
Content and SEO
- Preserve metadata, canonical links, and OG generation behavior when touching page structure.
- Keep static asset references stable (
public/**) unless a migration is part of the task.
Verification
- Run
bun run --cwd packages/web typecheckfor all code changes. - Run
bun run --cwd packages/web buildwhen pages, Astro config, or rendering behavior changes.