Skip to content

GDR-0026 to 0028: the Watch, the word of the day's bar, Wiktionary; University modules 12–14 - #64

Open
ChaliceForAuri wants to merge 1 commit into
mainfrom
companion-records
Open

ChaliceForAuri wants to merge 1 commit into
mainfrom
companion-records

Conversation

@ChaliceForAuri

@ChaliceForAuri ChaliceForAuri commented Oct 18, 2026 •

Copy link
Copy Markdown
Owner

Renumbered on 2026-10-21: main took GDR-0024 and GDR-0025 in #74 and #75 while this stack was open, so the three records here are 0026 to 0028 and the stack is rebased on main.

What this is

The records for what was decided on 2026-10-18, on top of GDR-0023 (the Library), plus the University modules those records rest on. No code: the engine (TimbreCore, the Library, the daily pick, Spell it) is the next PR, with its ADR, as GDR-0023 decision 4 says.

Records

  • GDR-0026 — Apple Watch: the to-do key on the wrist, the Library at a glance, and no model needed there. Extends GDR-0023's companion to the wrist. Records what the watchOS 27 SDK on the dev Mac actually contains (EventKit yes; Speech and SpeechAnalyzer no; FoundationModels present, eligibility unproven on hardware) and two rules: deterministic on the wrist, the model elsewhere; an iPhone without Apple Intelligence shows the Library and the word and says so. Four test devices named.
  • GDR-0027 — The word of the day: the bar is Vocabulary.com and the widget apps, and the word is yours first. Four properties that must hold at launch: the pick is yours first and deterministic; practice is spoken; it is ambient (menu bar, Lock Screen, complication) and marks itself met from polished text without storing the sentence; the entry is deep, with facts labelled by source and model-written lines labelled as the model's.
  • GDR-0028 — Bundled word content from a Wiktionary extract, under CC BY-SA 4.0; the model writes only examples. Attribution in the app, the extract and its scripts published as data under the same licence, the app's code under GDR-0005's terms. The lists in order: tier-two general English; software and product; healthcare, law, finance, design; phrases and idioms.

Index: GDR-0002's row now reads "no iOS app" superseded by 0023 and 0026; dictation stays macOS-only. The record itself is untouched.

Product map

Status line points at the new records; a Watch row joins §2; §5 and §7 reference GDR-0026–0028.

University

Three modules, in the existing fragment format, listed in manifest.json before the glossary (now module 15):

  • 12 · Spaced repetition and the Library — the forgetting curve, SM-2 then FSRS, strength as retrievability, events not numbers, met in the wild, what Vocabulary.com does and why Timbre need not, open data and share-alike.
  • 13 · iCloud and CloudKit — the claim and the daemon, the three iCloud mechanisms, CloudKit's shapes and CKSyncEngine, designing for a union merge with tombstones, entitlements and the schema that is forever, Advanced Data Protection, testing without a server.
  • 14 · The other Apple platforms — one language, three sandboxes; what iOS gives (App Intents, WidgetKit Controls, ActivityKit, share extensions); watchOS checked against the SDK; gestures and text input on the Watch; packages and platform floors; App Store versus Developer ID.

docs/learning/README.md and the layout block in CLAUDE.md now say the University's living home is web/src/lib/university.

Verified

  • pnpm run sync:docs regenerated records.json (38 records) and design.json; the three new records parse with status note implementation pending and their Builds on relations resolved.
  • pnpm run check: 0 errors. pnpm run build: clean.
  • Run with pnpm 9 explicitly, so the lockfile is untouched (see Pin pnpm 9 for web/ so installs cannot drift the lockfile #61).

🤖 Generated with Claude Code

@vercel

vercel Bot commented Oct 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
timbre Ignored Ignored Preview Oct 21, 2026 8:59pm UTC

Request Review

…y; three University modules

GDR-0023 took the product map's five decisions. These three extend it with
what was decided on 2026-10-18:

- GDR-0026 — Apple Watch: the to-do key on the wrist, the Library at a
  glance, and nothing on the wrist needs the model. Records what the
  watchOS 27 SDK actually contains (EventKit yes, Speech no,
  FoundationModels present but eligibility unproven) and the rules for an
  iPhone without Apple Intelligence.
- GDR-0027 — The word of the day's bar: Vocabulary.com for substance, the
  iPhone widget apps for presence, and four properties that must hold at
  launch: the word is yours first, practice is spoken, it is ambient and
  marks itself met, and the entry is deep with facts labelled by source.
- GDR-0028 — Bundled word content comes from a curated Wiktionary extract
  under CC BY-SA 4.0, attributed in the app and published as data; the
  model writes only example sentences and the "why today" line, labelled.

The index annotates GDR-0002 ("no iOS app" superseded by 0023 and 0026;
dictation stays macOS-only). The product map gains the Watch surface and
points at the new records. Backstage's JSON is regenerated.

Timbre University gains modules 12–14, the foundations these records rest
on: spaced repetition and the Library (the forgetting curve, FSRS, events
not numbers, met in the wild, open data); iCloud and CloudKit (the claim
and the daemon, the three mechanisms, designing for a union merge, the
schema that is forever); the other Apple platforms (what iOS and watchOS
give and withhold, checked against the SDKs, packages and platform
floors, App Store versus Developer ID). The glossary becomes module 15.
docs/learning/README.md and CLAUDE.md say where the University now lives.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@ChaliceForAuri ChaliceForAuri changed the title GDR-0024 to 0026: the Watch, the word of the day's bar, Wiktionary; University modules 12–14 GDR-0026 to 0028: the Watch, the word of the day's bar, Wiktionary; University modules 12–14 Oct 21, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant