# Instructions for Gemini

This file serves as a guide for future sessions working on this codebase.

1.  **Read Memory First**: Always read `MEMORY.md` at the start of a session to understand the project context and our working agreements.
2.  **Update Memory**: If we make significant architectural decisions or change our working patterns, update `MEMORY.md` to reflect this.
3.  **Check Documentation**: `README.md`, `docs/ARCHITECTURE.md`, and `docs/SETUP.md` are the sources of truth for the system. Keep them updated as code changes.
4.  **Task Tracking**: Use the `task.md` artifact to track progress on multi-step tasks.
5.  **Shopify API Reference**: When developing features involving Shopify, **ALWAYS** check the [Shopify API Reference](https://shopify.dev/docs/api/admin-graphql) for the specific version in use (check `shopifyApi.ts` for version). Do not guess field names or structure.