# Wishmode — Agent Guide

## What this product does

Wishmode turns a pasted family wishlist (loose ideas, weekend plans, "we should do that" lists) into a visual board of idea cards. Each card has an image, a priority tag (this weekend / soon / someday), and a detail sheet with planning actions (open in Google Maps, draft a calendar hold).

## Key routes

- `https://wishmode.co/` — landing page.
- `https://wishmode.co/wishboard` — the interactive board. Paste text, click "Generate Board", filter cards, open a card's plan sheet.
- `https://wishmode.co/wishboard?board=<id>` — a previously saved board (when persistence is configured).
- `https://wishmode.co/llms.txt` — LLM-readable site summary.
- `https://wishmode.co/.well-known/agent-card.json` — A2A-style agent card.
- `https://wishmode.co/.well-known/ai-agent.json` — agent manifest including guardrails.

## How agents should interact

- Read-only browsing of all pages is safe.
- The primary user flow is: go to `/wishboard`, paste wishlist text into the textarea (`data-testid="wishlist-input"`), and activate the "Generate Board" button (`data-agent-action="generate-board"`). This calls `/api/ingest` and renders cards; it does not purchase anything or create an account.
- There is no signup, login, pricing, or checkout flow. Do not attempt payments or account creation.
- The "Clear" button on the board discards the pasted text in the textarea. It is marked `data-agent-danger`; only use it when explicitly asked, and expect a confirmation (`data-agent-confirm`).
- Filter buttons ("All", "This weekend", "Soon", "Someday") only change which cards are shown; they are safe.
- Card buttons open a detail dialog ("plan sheet"); its external links go to Google Maps and Google Calendar draft URLs.
- The primary CTAs on the landing page ("Build Your Wishboard", "Open Wishboard") navigate to `/wishboard`.