# AGENTS.md

## Theme conversion rules
- Treat every visual retheme as source replacement, not overlay styling.
- Never solve a retheme by stacking `!important`.
- Never append one giant override block as the main solution.
- Replace the old theme where it actually lives: variables, shared selectors, embedded styles, linked stylesheets, or theme JS.
- Remove or neutralize obsolete conflicting theme rules after replacement.
- Do not leave old and new theme systems active together.
- Avoid flash-of-old-theme on first load.
- Update all major components consistently.
- Preserve all text, images, links, metadata, and section order.
- Final result must feel fully converted, not painted over.
- Keep premium effects lightweight and smooth.

## Landing page constraints
- Never rewrite the whole landing page from scratch.
- Never change copywriting unless explicitly asked.
- Never change image sources, links, metadata, or section order unless explicitly asked.
- Keep text readability high on every section.
- Avoid generic scroll reveal effects.
- Prefer lightweight CSS-first effects.
- Use JS only for subtle premium effects when needed.
- Do not add unnecessary libraries.

## Done when
- Theme is replaced at the source
- No old-theme leftovers remain active
- No mass `!important` is used
- No flash of old theme appears on first paint
- Effects remain lightweight
- Final result feels integrated, not patched