# Clipcade — Agent Guide

## What Clipcade does

Clipcade is a TikTok-style feed for mini-apps. Users discover small AI-powered apps in a vertical feed, try them inline, save them to a library, share them, and remix them into their own versions. Apps run with the user's own AI provider API keys (BYOK); keys are stored encrypted and users set daily/per-run spend caps.

## Key routes

- `/feed` — main app feed (the `/` root redirects here)
- `/search` — search apps; `?tag=<tag>` filters by tag
- `/app/<id>` — public per-app landing page (SEO, no login required to view)
- `/how-it-works`, `/faq`, `/docs`, `/guide`, `/resources`, `/about`, `/contact` — public info pages
- `/privacy`, `/terms` — policies
- `/publish`, `/library`, `/profile`, `/secrets`, `/me/*` — authenticated areas (Clerk sign-in required)

## How agents should interact

- Public pages (`/feed`, `/app/<id>`, info pages) are safe to read and cite.
- Interactive controls carry `data-testid` and `data-agent-action` attributes identifying their purpose (e.g. `try-app`, `remix-app`, `sign-in`, `sign-up`).
- Buttons marked `data-agent-danger` perform destructive actions and require the confirmation described in their `data-agent-confirm` attribute. Do not trigger them without explicit user instruction.
- Do not attempt sign-up, sign-in, publishing, key management, or any purchase/payment step autonomously; those require a human account holder.
- Machine-readable manifests: `/.well-known/agent-card.json` and `/.well-known/ai-agent.json` (guardrails). Site overview: `/llms.txt`.

## Contact

- Privacy: privacy@clipcade.com
- Legal: legal@clipcade.com