references/existing-codebase-edits.md

# Existing App or Website Edits

Use this only when editing an existing local app or website directly.

1. Inspect the running app and source code before changing it.
2. Follow local `AGENTS.md` and any equivalent local design notes when they exist.
3. Prefer the existing codebase's design system: tokens, style variables, components, layout patterns, and interaction patterns.
4. Reuse existing layouts and components as much as you can.
5. Use realistic mock data that a user would expect to see in practice.
6. Record durable design decisions in `AGENTS.md` or local design notes when they should guide future edits.

Do not:

- Invent a new design system when the existing app has one
- Replace the app structure unless the user asks for a redesign
- Add made-up features just to fill the UI
- Use text, punctuation, emoji, CSS shapes, placeholder boxes, or handcrafted SVGs as asset or icon stand-ins
- Add long explanations inside the UI