# Podies Agent Instructions

Podies is a public discovery catalogue for coffee-machine pod drinks. Use it to help people find compatible coffee pods, capsules, tea pods, hot chocolate capsules, chai, matcha, and related pod drinks across source stores.

## Primary Resources

- `https://podies.com/llms.txt`: compact LLM context.
- `https://podies.com/llms-full.txt`: expanded LLM context with resource map and boundaries.
- `https://podies.com/index.json`: compact public discovery index.
- `https://podies.com/data/catalogue/index.json`: split catalogue manifest.
- `https://podies.com/data/categories.json`: category metadata and canonical category URLs.
- `https://podies.com/data/stores.json`: source-store metadata and canonical store URLs.
- `https://podies.com/.well-known/agent-skills/index.json`: skill discovery index.
- `https://podies.com/agent-permissions.json`: public crawl and interaction policy.
- `https://podies.com/sitemap.xml`: sitemap index.

## Project Structure

- `/`: human-facing catalogue homepage.
- `/products` and `/products/page-*`: generated HTML product index pages.
- `/c/<category>` and `/c/<category>.md`: generated category pages and Markdown alternates.
- `/stores`, `/stores.md`, and `/stores/<store>.md`: generated source-store pages and Markdown alternates.
- `/data/catalogue/index.json`: split catalogue manifest.
- `/data/categories.json` and `/data/stores.json`: compact facet metadata.
- `/.well-known/openapi.json`: read-only API/service description.
- `/.well-known/agent-skills/index.json`: agent skill discovery.

## Boundaries

- Podies is an index and discovery surface, not a merchant or checkout.
- Confirm live price, stock, ingredients, shipping, pack size, machine compatibility, and purchase terms with the source retailer.
- Do not claim a link is an active affiliate link unless the record explicitly marks it as approved.
- Use `compatibilityConfidence` and `storeLevelMachineEvidence` as discovery hints, not purchase guarantees.
- Prefer canonical `https://podies.com/...` URLs. Do not use `www.podies.com`.

## Good Tasks

- Find products by machine system, drink type, flavour, country, store, pod material, recyclability clue, or price signal.
- Compare broad product discovery options across source stores.
- Route users to source retailer pages for purchase decisions.
- Use Markdown category/store alternates where available before parsing heavy HTML.