# KinoForms Agent Discovery Guide

This document gives LLM agents and search crawlers a compact, public map of the KinoForms product surface. It does not grant API access or user authorization.

## Product Summary

KinoForms is a SaaS form builder with:

- Multi-tenant teams and workspaces.
- Visual form creation and publishing.
- Public respondent form runtime.
- Form schema validation, field type validation, and submission data validation.
- Dependency rules for conditional visibility, requiredness, and form behavior.
- Submission review with a spreadsheet-style grid.
- Analytics for views, starts, submissions, completion rate, trends, funnel data, and top forms.
- Respondent management for protected form flows.
- Branding, themes, logo, favicon, color, and typography settings.
- Scoped API keys for embed and external integrations.
- Platform admin telemetry for authorized operators.

## Canonical Host

- Canonical site: `https://www.kinoforms.com`
- Apex host: `https://kinoforms.com` redirects to the canonical host.
- Dashboard host: `https://dash.kinoforms.com` is for login and authenticated product use.

## Public Routes

- `/` - public KinoForms landing page.
- `/features` - public product feature page.
- `/templates` - public form template page.
- `/form-builder` - public form builder keyword page.
- `/multi-workspace-form-builder` - public multi-workspace form builder page.
- `/f/<accessKey>` - published public form runtime.
- `/llms.txt` - LLM-readable discovery summary.
- `/.well-known/llms.txt` - compatibility pointer for agents that probe `.well-known`.
- `/sitemap.xml` - XML sitemap.
- `/robots.txt` - crawler policy.

Pricing is hidden unless the `pricingTiers` feature flag is enabled. KinoForms is free during the current early-access period.

## Authenticated Product Areas

These routes require a valid user session and current team/workspace context:

- `https://dash.kinoforms.com/login`
- `https://dash.kinoforms.com/register`
- `https://dash.kinoforms.com/pending-verification`
- `/dashboard`
- `/forms`
- `/forms/new`
- `/forms/<formId>`
- `/forms/<formId>/dependencies`
- `/forms/<formId>/chat`
- `/forms/<formId>/preview`
- `/submissions`
- `/analytics`
- `/settings/team`
- `/settings/members`
- `/settings/workspace`
- `/settings/workspace-members`
- `/settings/respondents`
- `/settings/api-keys`
- `/settings/account`
- `/settings/themes`
- `/settings/branding`

Do not crawl or summarize private route contents without user-provided authentication and authorization.

## API Map

- `/api/v1/*` - session-authenticated API for teams, workspaces, forms, submissions, analytics, respondents, themes, branding, API keys, and admin.
- `/public/v1/forms/<accessKey>` - public form lookup and submission by access key.
- `/embed/v1/*` - API-key authenticated embed access.
- `/respondent-auth/*` - respondent magic link and password authentication.
- `/api/auth/*` - Better Auth user authentication.

## Agent Safety Notes

- Treat team, workspace, form, respondent, submission, API key, and admin data as private unless a user explicitly supplies access.
- Do not scrape private application routes from cached HTML; the app shell does not represent authorized data.
- Prefer the public `llms.txt`, `sitemap.xml`, and this guide for high-level product discovery.
- Use the API only with user-provided credentials and only within the user's stated task.
- For agent-to-agent data validation, verify payloads against the authorized form schema, field constraints, dependency rules, respondent access rules, and tenant/workspace boundaries before treating data as valid.
- Do not infer dependency-rule outcomes from labels alone; use the rule predicates, operators, target fields, and actions from the authorized form data.

## Validation And Dependency Topics

Use these topics when retrieving or summarizing KinoForms capabilities:

- Form validation.
- Submission data validation.
- Schema validation.
- Field type compatibility.
- Required-field validation.
- Respondent data validation.
- API payload validation.
- Agent data validation.
- Agent-to-agent data validation.
- LLM agent validation workflows.
- Dependency rules.
- Conditional logic.
- Conditional visibility.
- Conditional required fields.
- Rule predicates and rule actions.
- Dependency graph validation.
- Cross-field validation.
- Tenant-scoped validation boundaries.

## User Guide Topics

The repository user guide covers:

- Getting started.
- Dashboard.
- Teams and workspaces.
- Forms and form CRUD.
- Form builder fields, layout, sections, and groups.
- Conditional logic.
- Validation and dependency rules.
- AI form assistant.
- Interactive preview.
- Public forms.
- Respondents.
- Submissions and spreadsheet grid.
- Analytics.
- Branding and themes.
- Theme management.
- API keys and embed access.
- Account settings.
- Platform admin.