{
  "title": "Claim-to-source ledger",
  "accessed": "2026-09-07",
  "scope_note": "Apple guidance and Vercel IA are reference evidence, not endorsements. Proposed OpenClaw decisions are explicitly labeled in content-data.json.",
  "sources": [
    {
      "id": "apple:design-principles",
      "title": "Design principles",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/design-principles",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/design-principles.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Current principles emphasize purpose, agency, responsibility, familiarity, flexibility, simplicity, craft and delight; the page records a June 8, 2026 revision.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "69ea6425412bcb6410f8b6355e4d113c773731056e31b9ef730f07515045fa36"
    },
    {
      "id": "apple:designing-for-ios",
      "title": "Designing for iOS",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ios",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-ios.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Prioritize primary tasks, reachable controls, appearance adaptation and familiar device interactions.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "e347649ffc2cdcdb755c0222454046d389eb539ee8c8c6e395b6c79ccf327d4f"
    },
    {
      "id": "apple:designing-for-ipados",
      "title": "Designing for iPadOS",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-ipados.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Accommodate varied viewing distances, multiple input methods, large content areas and resizable multitasking layouts.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "da31fa0184109666e95208f23519452d3c7a6c8b3ddca8e444e1b2427e6151b1"
    },
    {
      "id": "apple:designing-for-macos",
      "title": "Designing for macOS",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-macos",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-macos.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Support resizable windows, menu commands, keyboard shortcuts, precise input and sustained work.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "0df69cf12d79dd46a6ecb28c01207dbd9137958decec405870cf0008730bb88e"
    },
    {
      "id": "apple:designing-for-watchos",
      "title": "Designing for watchOS",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-watchos.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Favor glanceable single-screen interactions, shallow navigation, timely notifications and independent utility.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "7f7a256f1c9fe359b43191fbaacf3418acf0473e7dcc64d6e6fff619a97d0212"
    },
    {
      "id": "apple:designing-for-visionos",
      "title": "Designing for visionOS",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-visionos.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Choose the least immersion that serves the task; support comfortable placement, indirect gestures and awareness of surroundings.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "1ac10b83d440922aa4033610dba9a9a0f18f14b80e49251ca1e8174491cde8cb"
    },
    {
      "id": "apple:generative-ai",
      "title": "Generative AI",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/generative-ai",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/generative-ai.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Identify AI use, communicate capabilities and data handling, preserve correction and reversal, and obtain confirmation before consequential agent actions. Generation feedback should describe actual work.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "90abe051464bf6cb2af92d0087b46ddc89946de16c1620c1a1d5edfbd647f004"
    },
    {
      "id": "apple:privacy",
      "title": "Privacy",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/privacy",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/privacy.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Ask for only the access needed, in the context of use. Explain purpose and respect system-provided privacy controls.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "df3a543792a763a141ccc6eae59e94615fb96d6e8eb6a65f2f1a92b4ec80ad2d"
    },
    {
      "id": "apple:accessibility",
      "title": "Accessibility",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/accessibility",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/accessibility.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Support alternative sensory and input paths, adjustable text, meaningful contrast, usable controls and accessibility settings. The defaults table distinguishes comfortable defaults from smaller minima.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "be49ec0b34397f356a1e3fd8c7ad323713198515523947097913cb9c57da699b"
    },
    {
      "id": "apple:typography",
      "title": "Typography",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/typography",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/typography.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Maintain readable text and hierarchy at large sizes. Use appropriate native text styles; custom typography must preserve accessibility behavior.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "85bf7dc78d41a6e5e16d4055f3bdadf7bac4f7d5cb2206514c8b82d5d24631ed"
    },
    {
      "id": "apple:color",
      "title": "Color",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/color",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/color.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use color consistently by semantic role; test light, dark and increased-contrast variants. Never make color the only carrier of information.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "262ce33cb88d41ac0238bf1e3f59b7957e8ddb030379c41b35a6cbdb9ab11a39"
    },
    {
      "id": "apple:materials",
      "title": "Materials",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/materials",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/materials.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Liquid Glass distinguishes the control/navigation layer from content. Apply it sparingly; use standard materials for content and retain adaptive legibility.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "597da170985715de4bd8446df12e3604595e634a790b5da0ce6673d2b2327ed5"
    },
    {
      "id": "apple:motion",
      "title": "Motion",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/motion",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/motion.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Motion should communicate, remain brief and interruptible, and have alternatives. Avoid distraction and uncomfortable peripheral movement.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "957268c323af4617dabb6c0449d0920248c995159d54f76c691aa180ceb72a61"
    },
    {
      "id": "apple:feedback",
      "title": "Feedback",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/feedback",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/feedback.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Keep routine status near its subject, match interruption to importance, and combine visual, auditory and tactile channels where supported.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "242973c86c0d632467b46aeee1ad59825b70e3e8893d190f16351d14097c872a"
    },
    {
      "id": "apple:layout",
      "title": "Layout",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/layout",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/layout.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Preserve recognizable relationships as size and context change. Respect safe areas and test different text sizes, directions and window configurations.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "2260d6577c610b494a60eb03165c8efa903f4adfa36d7ac4870c8ace55d677bb"
    },
    {
      "id": "apple:spatial-layout",
      "title": "Spatial layout",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/spatial-layout",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/spatial-layout.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Keep important content comfortable to view, avoid head-locked content and excessive windows, and provide sufficient separation between gaze targets.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "b8724b05b3ee7792309b2d58040dca210710112e205f793c2118689c54f8fbd0"
    },
    {
      "id": "apple:voiceover",
      "title": "VoiceOver",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/voiceover",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/voiceover.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Provide meaningful labels, headings, reading groups and change announcements. Hide decorative imagery from the accessibility tree.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "859dc02ab9ba87dc545952d8f8077cf94936cd9f49f491d2e765c2425a6c76e5"
    },
    {
      "id": "apple:managing-notifications",
      "title": "Managing notifications",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/managing-notifications",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/managing-notifications.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Respect permission, Focus and delivery scheduling. Assign urgency honestly; Critical interruptions require specific entitlement.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "fa6df9790a888d432270ad26524507ed9336035b30187c3449298ade05fed9dd"
    },
    {
      "id": "apple:notifications",
      "title": "Notifications",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/notifications",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/notifications.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Notifications should be concise, useful, nonduplicative and discreet. Provide beneficial actions and preserve privacy on visible surfaces.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "f08e0b107376688cec5d150cf66890bc519bf5b312facbbf4ff40fd450e389d1"
    },
    {
      "id": "apple:onboarding",
      "title": "Onboarding",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/onboarding",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/onboarding.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Prefer learning through interaction and contextual tips; keep tutorials brief and optional, with nonessential configuration deferred.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "9a85ebb1e3dd275d5f5dbfa1729a2e18429960fc26f5273921a68dc5b323dcda"
    },
    {
      "id": "apple:loading",
      "title": "Loading",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/loading",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/loading.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Show useful content promptly and permit other work during loading. Watch interactions should avoid prolonged loading screens.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "83c69df80cfafd72b1a317d82521f14dfdb415530cdf37c290462eb28673b901"
    },
    {
      "id": "apple:playing-haptics",
      "title": "Playing haptics",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/playing-haptics",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/playing-haptics.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use established haptic meanings consistently; keep feedback brief, optional and supplementary to other channels.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "68bab380a07eff7aa471d589565891bd904d4615bea3629766d4b7a11ab5c5ba"
    },
    {
      "id": "apple:playing-audio",
      "title": "Playing audio",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/playing-audio",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/playing-audio.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Respect system volume, audio routes, explicit playback and interruptions. Disconnecting headphones should pause playback to preserve expected privacy.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "9c63454e50a9ddc656891e9dccef1e889bfa8b8124dd3f27d00f4b2e6610dd76"
    },
    {
      "id": "apple:buttons",
      "title": "Buttons",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/buttons",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/buttons.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Give actions recognizable labels and press states. General hit-region guidance is 44\u00d744 pt, 60\u00d760 pt in visionOS; avoid excessive prominent actions.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "fb450f96dd7a201a0203852782252942ee6d72978e0baaec1cb4c400568fed91"
    },
    {
      "id": "apple:entering-data",
      "title": "Entering data",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/entering-data",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/entering-data.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Minimize entry, support paste and appropriate inputs, offer useful choices and validate data in context.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "0c430bb7e33382add2b6c602261f719b7b39b1406dfcedb653755ebcb1116a09"
    },
    {
      "id": "apple:branding",
      "title": "Branding",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/branding",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/branding.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Express a consistent voice and identity while letting content dominate. Repeated logos should not displace useful controls and content.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "91f437f8bc819d0994ba3c93a963e9905e8d30d9b21b2e229387e2cd9730a7c6"
    },
    {
      "id": "apple:dark-mode",
      "title": "Dark Mode",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/dark-mode",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/dark-mode.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Respect the system appearance and test contrast/transparency combinations. Dark appearance is not a simple inversion of light colors.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "cf352a73655e616568441efefb295802ade3e7f34980f33c35f0ee778cf4f3e7"
    },
    {
      "id": "apple:writing",
      "title": "Writing",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/writing",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/writing.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use plain, action-oriented, context-sensitive language. Give useful next steps in empty and error states, and keep terminology consistent.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "3c32e5d0b6dac0a2ccef96d96ea8a3eb62e425ef319fd065aa6e3010f93ea149"
    },
    {
      "id": "apple:inclusion",
      "title": "Inclusion",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/inclusion",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/inclusion.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Design for diverse situations and abilities, avoid assumptions and stereotypes, and use understandable language and relevant representation.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "ab94a3172d397f21973a34ef3bd80319dcf408e4aef13e509b2a99ad733aceb7"
    },
    {
      "id": "apple:right-to-left",
      "title": "Right to left",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/right-to-left",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/right-to-left.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Adapt layout and directional controls to reading direction, while preserving numerals, logos and universal marks appropriately.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "ccbe1722f775cb6633de33ada12dbae9053cb3cadd351b863907a05a69e89742"
    },
    {
      "id": "apple:alerts",
      "title": "Alerts",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/alerts",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/alerts.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Reserve alerts for essential actionable interruptions. Use explicit action labels, meaningful titles and a clear cancellation path.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "ca60f14c249290f1dcebe8bbaedde16183e3759f5a53238085915795e2e4dbdc"
    },
    {
      "id": "apple:modality",
      "title": "Modality",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/modality",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/modality.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use modal tasks only when they benefit focus; keep them contained, named and dismissible, preserving the surrounding context.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "79f76255705524952443c7ef0aaffaf6285142d0fdcd0a0ad9be4b1c3181e5be"
    },
    {
      "id": "apple:undo-and-redo",
      "title": "Undo and redo",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/undo-and-redo",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/undo-and-redo.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Make the target and effects of undo understandable, reveal the result, and support familiar platform mechanisms.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "f876432967988ac2cf71bd79af61d1240c7b9ea6fe856747382954921f70b4d2"
    },
    {
      "id": "apple:icloud",
      "title": "iCloud",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/icloud",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/icloud.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Preserve current content and meaningful app state across devices, handle unavailability discreetly, and make unresolved conflicts understandable.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "83608ee962bafe40a9fa6a92e2feffc2a9a11fae3bc4691c3e6de49778cfb94d"
    },
    {
      "id": "apple:multitasking",
      "title": "Multitasking",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/multitasking",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/multitasking.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Save and restore context, finish appropriate user-started work in the background, and avoid unnecessary completion notifications.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "99f9de79c8b404841960504490694c9064ad4aa3776488c8a8453cb41ccd5c7d"
    },
    {
      "id": "apple:app-shortcuts",
      "title": "App Shortcuts",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/app-shortcuts",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-shortcuts.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Expose frequent useful actions in system entry points, using familiar language and complete responses for audio-only contexts.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "26ffd9677b5c4e62efcb480d40e5748180ebf18755fdf9ee26295b7981ecf3df"
    },
    {
      "id": "apple:snippets",
      "title": "Snippets",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/snippets",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/snippets.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Distinguish confirmation from result in compact interactions; use concise content and descriptive primary actions.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "32af5833181b26681cfa8c4edd5559f94e995c1e6e870b264c97bbfe7a3eae5d"
    },
    {
      "id": "apple:eyes",
      "title": "Eyes",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/eyes",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/eyes.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "System gaze hover is not disclosure of where a person looks. Use stable targets, generous separation and multiple input methods.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "24ea98bb25cf2dcba31057d9da461e4cc7b4f206c03226bba5aa0852a63d6dab"
    },
    {
      "id": "apple:progress-indicators",
      "title": "Progress indicators",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/progress-indicators",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/progress-indicators.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use determinate progress only when the task can be quantified; report advancement accurately and offer safe cancellation where possible.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "76a299d47f154a13b38568a52054f96d5f784739a6aecfe1a82d6ff3a042aa7c"
    },
    {
      "id": "apple:text-fields",
      "title": "Text fields",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/text-fields",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/text-fields.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Keep labels and logical tab order; choose appropriate keyboard and validation timing. Avoid burdensome text entry on watches.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "18324cc7181a498b9324a1980231260785ee427eb9ae48f775bfa06a96153d40"
    },
    {
      "id": "apple:machine-learning",
      "title": "Machine learning",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/machine-learning",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/machine-learning.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Calibrate confidence against actual result quality before showing it. Provide useful corrections, grounded attribution and realistic limitations.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "a179227bcd89dda454c5d932b7e40c55b1c4a488595a1cacc883d1732a0ac1d7"
    },
    {
      "id": "apple:icons",
      "title": "Icons",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/icons",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/icons.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Use simple familiar metaphors, consistent weight and optical alignment, vector assets and accessible labels.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "d78ccab0375c72e7dc30d29e47f346fb3c2daef233dd7aee938ea66cc5220de5"
    },
    {
      "id": "apple:app-icons",
      "title": "App icons",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/app-icons",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-icons.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Maintain recognizable icon geometry across platform masks and appearance variants, leaving system effects to the platform.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "5f67bb7b1e2405ee03526ab83c3f75b63b28473ce39ebf10848655908e2712f7"
    },
    {
      "id": "apple:images",
      "title": "Images",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/images",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/images.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Embed appropriate color profiles and test images on actual devices.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "6d830ed0539367e21bf9b12e6c96e17ad5c3cdf551be5205ef0812e0fe22febb"
    },
    {
      "id": "apple:sf-symbols",
      "title": "SF Symbols",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/sf-symbols",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/sf-symbols.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Custom symbols need consistent weight, alignment and labels. Apple-product symbols carry specific modification and usage restrictions.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "d3ff4da7e459220e802db3aa6450c5b0163634975b01d6073f44e77e715a4ffe"
    },
    {
      "id": "apple:immersive-experiences",
      "title": "Immersive experiences",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/immersive-experiences",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/immersive-experiences.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Let people choose immersion and leave it clearly; maintain comfort and awareness of the physical environment.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "7d1f2b7baf9ebb65e82121c0e7d41160a3445d33cbcd7540ba1332e86531d2cb"
    },
    {
      "id": "apple:siri",
      "title": "Siri",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/siri",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/siri.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Provide short, specific, device-independent responses that make complete sense both audibly and visually.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "fe14c4b871727adb2d3014ddf9222b88057db7eb9bb8b688c23de3dee634f3b2"
    },
    {
      "id": "vercel:geist-introduction",
      "title": "Geist Design System",
      "publisher": "Vercel",
      "url": "https://vercel.com/geist/introduction",
      "accessed": "2026-09-07",
      "review_status": "introduction_and_navigation_reviewed",
      "claim": "The introduction groups navigation into Foundations, Brands and Components. Foundations include introduction, colors, typography and materials; components form an extensive mostly alphabetical catalog.",
      "evidence_type": "official design-system information architecture",
      "confidence": "high"
    },
    {
      "id": "openclaw:approved-identity",
      "title": "OpenClaw final identity / 1.0",
      "publisher": "Local project artifact",
      "accessed": "2026-09-07",
      "review_status": "read",
      "claim": "Approved Continuous flow symbol and selected custom wordmark; master sRGB palette #F70515, #000000, #FFFFFF. Keep geometry, spacing and clear space unchanged.",
      "evidence_type": "current local project specification",
      "confidence": "high for artifact contents; adoption outside this workspace not claimed"
    },
    {
      "id": "apple:always-on",
      "title": "Always On",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/always-on",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/always-on.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Hide sensitive information and retain a stable, legible layout as the device rests; quiet unnecessary motion and secondary detail.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "c2dc9fe1fbfd54a7a1eca1b763adb053e7895d3a486166c48c6d97b017b8fe9e"
    },
    {
      "id": "apple:controls",
      "title": "Controls",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/controls",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/controls.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "System entry controls should reflect current state, conceal private locked-screen content and require authentication for security-affecting actions.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "9a73e3f7abd7da7a8e6965933a3c32e009aa2c134d4376abd9fc2831bf5f80b7"
    },
    {
      "id": "apple:focus-and-selection",
      "title": "Focus and selection",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/focus-and-selection",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/focus-and-selection.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Keep focus predictable and avoid unsolicited focus changes; distinguish focus from selection and activation.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "376c122b5361748c0e51899ef0f75e46d143ebfd3a84308decd6bc09bb3b8872"
    },
    {
      "id": "apple:keyboards",
      "title": "Keyboards",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/keyboards",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/keyboards.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Support Full Keyboard Access and preserve familiar keyboard shortcuts; use descriptive names for custom frequent commands.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "ef81add8bc05d6f5d641814e936076fd44400b45334160841e83c16e12eb8dee"
    },
    {
      "id": "apple:designing-for-tvos",
      "title": "Designing for tvOS",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-tvos.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Distant, shared screens require legible content, familiar remote focus and correct current-viewer context.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "21d20292e6e002aabe0cfd69bb1485456fb3192f1d40cc355887c4999f6df497"
    },
    {
      "id": "apple:live-activities",
      "title": "Live Activities",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/live-activities",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/live-activities.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use Live Activities for tasks with a beginning and end, update only when content changes, protect sensitive information, and end them with the task.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "f9b894e9a5044d01fe2ffd100700eae14d4b6b672927e3af3b58ea47ca69a279"
    },
    {
      "id": "apple:widgets",
      "title": "Widgets",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/widgets",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/widgets.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Widgets refresh periodically rather than continuously. Match information density to context, provide relevant deep links, and indicate stale data when useful.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "59060ecb42e93f363b3d7caf61b7f3c4c9b49637eae5164f307b28398836576d"
    },
    {
      "id": "apple:settings",
      "title": "Settings",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/settings",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/settings.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Offer useful defaults and few settings; keep task-specific options in context and respect system-wide preferences.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "c17e9a542a806d828ef5bef1df044cee2c2c135f96e8d0c591d873c2507449cc"
    },
    {
      "id": "apple:windows",
      "title": "Windows",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/windows",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/windows.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Preserve native window behavior, support resizing and avoid putting critical actions only in a bottom bar.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "7edd460aec4419ce23f4965a260de2cc76571180018d2331d937af3e39c794e9"
    },
    {
      "id": "apple:action-button",
      "title": "Action button",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/action-button",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/action-button.json",
      "accessed": "2026-09-07",
      "review_status": "narrative_reviewed",
      "claim": "Use supported hardware entry points for essential functions with short action labels and platform-consistent behavior.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "0b5b8f0e68140d183a8dd670fd13e9ad97c89894b4525015445173ec76288299"
    },
    {
      "id": "apple:complications",
      "title": "Complications",
      "publisher": "Apple",
      "url": "https://developer.apple.com/design/human-interface-guidelines/complications",
      "data_url": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/complications.json",
      "accessed": "2026-09-07",
      "review_status": "selected_sections_reviewed",
      "claim": "Provide timely, relevant watch-face information with meaningful deep links, restrained data updates and private display behavior.",
      "evidence_type": "official design guidance",
      "confidence": "high for the recorded guidance; unvalidated as an OpenClaw implementation",
      "sha256": "2d95765f9ffc5e568559ae20cc5a043facba35cef12c964f4fb5fa99456d528e"
    }
  ],
  "important_distinctions": [
    {
      "topic": "Control sizes",
      "source_ids": [
        "apple:accessibility",
        "apple:buttons"
      ],
      "resolution": "Accessibility lists 44 pt iOS/watchOS default versus 28 pt minima; Buttons gives the practical general 44 pt hit-region rule, 60 pt in visionOS. Use comfortable defaults, and do not equate native points with CSS pixels."
    },
    {
      "topic": "Permissions versus approvals",
      "source_ids": [
        "apple:privacy",
        "apple:alerts",
        "apple:generative-ai"
      ],
      "resolution": "Privacy pre-alert single-Continue-button guidance applies to an explainer immediately preceding a system protected-resource dialog. An agent action approval is a different interaction and needs a clear cancel/decline path."
    },
    {
      "topic": "Motion versus progress",
      "source_ids": [
        "apple:progress-indicators",
        "apple:motion",
        "apple:accessibility"
      ],
      "resolution": "Keep ongoing work perceivable without forcing repetitive animation. In reduced motion use persistent state text and meaningful discrete updates."
    },
    {
      "topic": "Watch loading",
      "source_ids": [
        "apple:feedback",
        "apple:loading"
      ],
      "resolution": "Avoid a prolonged indeterminate watch waiting state. A brief indicator may be preferable to a blank screen for a one-to-two-second load; long work should permit dismissal and later checking."
    },
    {
      "topic": "Platform evidence",
      "source_ids": [
        "apple:designing-for-visionos",
        "apple:eyes"
      ],
      "resolution": "Apple Vision Pro/visionOS principles inform a future spatial adapter. They do not establish capabilities or ergonomic validation for unspecified smart glasses."
    },
    {
      "topic": "Ambient freshness",
      "source_ids": [
        "apple:widgets",
        "apple:live-activities",
        "apple:always-on"
      ],
      "resolution": "Widgets are not a continuous real-time status channel. Bounded Live Activities can provide frequent updates; resting displays must reduce motion and protect sensitive content. The design must say when shown state is stale."
    }
  ]
}