Source: https://guthlabs.ai/docs/jobs/tim-app-intents-and-spotlight/field-guides/

job / candidate

# App Intents and Spotlight — field guides

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

Status: **proposed**Lifecycle: **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](<https://guthlabs.ai/guth.html#builder>) — 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/`