{"name":"Agentry","version":"2026-05-20","contract_version":"2026-05-20","deploy_sha":null,"docs":"/agentry.md","install_docs":"/install.md","reference_docs":"/agentry.md","install_contract":"/v1/install/contract","api_schema":"/v1/openapi.json","capabilities":"/v1/capabilities","setup_manifest":"/v1/setup/manifest","install_plan":"/v1/install/plan","quick_start":[{"when":"installing","action":"Fetch /install.md first, resolve auth/project state, then plan from the repo's important business question and funnel/business logic flow before editing code.","urls":["/install.md","/v1/setup/manifest","/v1/install/contract","/v1/install/plan"]},{"when":"day_to_day_use","action":"Fetch /agentry.md, then start from the saved signal map, latest verify report, answer contracts, event names, and property keys before query blueprints or HogQL.","urls":["/agentry.md","/v1/projects/:project_id/signal-map","/v1/projects/:project_id/verify-report","/v1/projects/:project_id/answer-contracts","/v1/projects/:project_id/event-names","/v1/projects/:project_id/event-property-keys","/v1/projects/:project_id/cases","/v1/projects/:project_id/analytics/query","/v1/projects/:project_id/deploys","/v1/query-blueprints"]},{"when":"exact_payload_shape","action":"Fetch a filtered OpenAPI operation schema before mutating calls; do not infer request bodies from prose examples.","urls":["/v1/openapi.json?index=true","/v1/openapi.json?flow=install"]}],"mental_model":{"write":[{"concept":"logs","endpoint":"POST /v1/logs/","use_when":"errors, exceptions, operational failures"},{"concept":"analytics","endpoint":"POST /v1/analytics/","use_when":"product, user, funnel, and business events"},{"concept":"deploys","endpoint":"POST /v1/deploys/","use_when":"CI/provider post-deploy release attribution after a successful deploy"}],"read":[{"concept":"cases","endpoint":"GET /v1/projects/:project_id/cases","use_when":"what broke"},{"concept":"analytics","endpoint":"POST /v1/projects/:project_id/analytics/query","use_when":"what users did; start from signal-map, verify report, event names, and property keys before query blueprints or custom HogQL"},{"concept":"deploys","endpoint":"GET /v1/projects/:project_id/deploys","use_when":"what changed"}],"helpers":"Query blueprints, event names, public queries, health, and next-steps are helpers around the three read concepts; they do not replace signal-map and verify proof."},"proof_contract":{"install":"Start from the repo's important business question and funnel/business logic flow; let POST /v1/install/plan derive events, properties, failure surfaces, and deploy proof before editing code.","answering":"Before query blueprints or custom HogQL, read the saved signal map, latest verify report, answer contracts, event names, and property keys. If telemetry is missing, name the missing event/property and wire or trigger that product flow."},"response_shapes":{"tabular_query_data":"Consume `rows` first. Agentry query endpoints return object-shaped rows; `columns` is display/order metadata; `results` is intentionally absent.","raw_posthog_shape":"PostHog internally returns array rows as `results`, but Agentry normalizes those before they cross agent-facing query endpoints. If a helper reads `response.results`, fix it to read `response.rows`.","non_tabular_reads":"Typed resources keep domain names such as cases, deploys, analytics_events, keys, publications, or next_steps."},"signal_map":"/v1/projects/:project_id/signal-map","implementation_report":"/v1/projects/:project_id/implementation-report","verify_install":"/v1/projects/:project_id/install/verify","verify_report":"/v1/projects/:project_id/verify-report","skill":"/skill/agentry/SKILL.md","adapters":"/adapters","next_action":"Choose a quick_start entry. Installing: fetch /install.md and let the planner derive signals from the business flow. Answering: fetch /agentry.md and prove coverage from signal-map/verify/event metadata before blueprints or HogQL. Use filtered /v1/openapi.json before mutating calls."}