Browse documentation
Agent-first documentation · 2026-08-11.3 · Updated 2026-08-11 View as Markdown

Documentation changelog and current guidance

Use the newest documentation version and current generated schemas. Older examples are historical context, not authority when they conflict with the current corpus.

Current version: 2026-08-11.3

Expanded the agent-first corpus from basic task coverage to the full customer planning lifecycle:

  • direct and idea-based plan creation;
  • RSVP deadlines, tipping, capacity, delivery, active edits, roster management, plan progress, discard, and cancellation;
  • recipient authentication, invite claiming, RSVP changes, and calendar handoff;
  • Connected Friends, Friends in Mind, connection links, and availability boundaries;
  • complete My Dominos status and personal-inventory guidance;
  • detailed singular capture and roundup recovery;
  • recipient-side shared Ideas List copying and connection consequences;
  • created ideas, private places, account access, and security;
  • Agent Access token creation, least privilege, rotation, and revocation;
  • explicit ChatGPT, Claude, and static-bearer MCP compatibility checks;
  • SMS, MCP, and Capability API task recipes;
  • cross-surface support and current-limits references;
  • machine-readable documentation manifest, search, word counts, and token estimates;
  • semantic coverage assertions for representative support questions.

Preferred guidance:

  • Use task-specific pages rather than only /llms.txt.
  • Use /docs/manifest.json for catalog metadata and /docs/search.json?q=... for discovery.
  • Use authenticated MCP tools/list, /docs/mcp-tools.json, and /docs/openapi.json for current schemas.
  • Treat 2026-08-11.3 behavior as current unless a newer docs version is available.

Version 2026-08-11.2

Added complete provider-specific calendar guidance:

  • direct Google authorization and access levels;
  • Apple/iCloud public calendar publishing;
  • Microsoft Outlook/Microsoft 365 ICS publishing;
  • other ICS and webcal providers;
  • calendar privacy, secret-link handling, multiple calendars, management, and troubleshooting.

Preferred calendar guidance changed from “Google or a calendar URL” to explicit provider routing with accurate Apple and Microsoft limitations.

Version 2026-08-11

Created the initial agent-first documentation system:

  • stable Markdown task pages;
  • HTML/Markdown content negotiation;
  • global and surface-scoped llms.txt indexes;
  • llms-full.txt offline corpus;
  • generated OpenAPI and MCP tool catalogs;
  • generated capability reference;
  • cross-surface outcome and confirmation rules.

Deprecation policy

When guidance changes:

  1. update the task page and documentation version;
  2. update generated schema descriptions when the runtime contract changed;
  3. record the preferred replacement here;
  4. keep old behavior only when a real supported compatibility window exists;
  5. add a semantic documentation test for the user question that exposed the change.

Assistants should not follow a deprecated menu path, capability version, authentication mechanism, or confirmation rule merely because it appears in an older answer.

Machine checks

Use:

  • X-Domino-Docs-Version to identify the corpus version;
  • ETag to cache exact Markdown safely;
  • X-Domino-Docs-Words and X-Domino-Docs-Token-Estimate to budget retrieval;
  • documentation_fingerprint in generated machine references to detect contract changes.

LLM answering guidance

  • Prefer the newest fetched page over model memory.
  • When a user reports different visible controls, acknowledge possible rollout drift and reason from their screen without inventing hidden behavior.
  • Never combine an old confirmation rule with a new runtime contract.