App Intents and Spotlight — field guides

The distinct field guides record for App Intents and Spotlight. This page is proposal-only.

Status: proposedLifecycle: candidate

Record status

Record ID: job:tim:app-intents-and-spotlight
Parent lifecycle: candidate
Page lane: docs_urls
Lane lifecycle: proposed
Owner: Tim
Owner role: Apple platform specialist
Owner status: PACKAGING
Qualification result: NOT RUN · held for evidence and human review

Working browser surface: Agent jobs — builder overview — Inspect the package and stage a local project. This route is local-only; provider, credential, database, customer, publication, deployment, and production effects remain held.

Related field-guide records

/app/notebook/field-guides/

Source-proposed guide paths are references, not proof that those paths resolve.

Operating sequence

Create or link the source-labelled job, project, and field-guide records.
Define the authorized Apple files, target platforms, and target OS versions; record all exclusions.
Review the supplied Apple capability index and record source locator, revision, and hash evidence.
Separate observed native concepts from proposed web or app behavior; mark unverified availability as unknown.
Draft App Intent contracts with explicit parameters, outputs, errors, confirmations, and side-effect boundaries.
Draft Core Spotlight indexing contracts with visibility, freshness, revision, deep-link, and removal rules.
Assess iPhone, iPad, and Mac differences for interaction, accessibility, and unsupported states.
Record Apple intelligence or contextual-assistance opportunities only as proposals with held claims where evidence is absent.
Create entitlement, credential, Store submission, and production-effect gates as Held or Needs review.
Link each proposed change to an approval record and preserve agent receipts and revisions.
Create deadline workbacks for technical review, accessibility review, entitlement review, and approval.
Run deterministic acceptance tests; leave lifecycle proposed until an authorized reviewer changes it.

Handoff boundary

A named native surface may be mistaken for an available or connected Guth web feature.
App Intents may be drafted with broader authority than the owning app or user has granted.
Spotlight proposals may expose private, stale, deleted, or unauthorized records if visibility and removal rules are incomplete.
Search indexing may be confused with publication, customer indexing, or production search.
Apple intelligence or contextual claims may exceed the supplied evidence or imply an unavailable API.
Entitlement, credential, Store submission, and production gates may be crossed without approval.
Cross-platform designs may ignore pointer, keyboard, focus, screen-reader, scaling, or platform-specific interaction needs.
Duplicate or competing work may be created if the job is not linked to the project and agent log.
External messages, schedules, files, or other side effects may be mistaken for completed actions.
Erroneous or stale source revisions may be treated as current without source hash and revision tracking.

Sources and evidence

These pointers bind the page to evidence. They do not grant authority or collapse verification into deployment.

agents/index.html#tim
source_record:job:tim:app-intents-and-spotlight
Observed native contract: project_and_field_guide_collections
Observed native contract: deadlines
Observed native contract: records
Observed native contract: pointguard
App route: /app/pointguard/
App route: /app/notebook/projects/
App route: /app/notebook/field-guides/
App route: /app/notebook/agent-logs/
App route: /app/notebook/approvals/
App route: /app/notebook/search/
App route: /app/notebook/notes/
App route: /app/notebook/files/
App route: /app/notebook/to-dos/
App route: /app/notebook/agenda/
App route: /app/notebook/messages/
App route: /app/notebook/paper/
source_record.job:tim:app-intents-and-spotlight
Observed native contract: web_boundary
Observed app route: /app/pointguard/
Observed app route: /app/notebook/field-guides/
Observed app route: /app/notebook/agent-logs/
Observed app route: /app/notebook/approvals/
Observed app route: /app/notebook/projects/
Observed app route: /app/notebook/search/