[r3dbars]

Stacked on #1947 (AGENTS.md everywhere). Once that merges this retargets to main.

Docs only. No code, scripts or tests change.

What changed

• New AGENTS.md for Sources/Writing/, Sources/TranscriptedWriting/ and Sources/TranscriptedKeyboard/: what each owns, entry points, rules, tests. Written from the code.
• Sources/AGENTS.md, Sources/TranscriptedCore/AGENTS.md and Sources/UI/Settings/AGENTS.md now cover files they were missing (Writing views, SpeechSegmentPacking, TranscriptFileRewrite, unheard-playback, etc.). Fixed a stale "Nemotron removed" line.
• docs/README.md indexes every live doc by job. docs/repo-layout.md points at it instead of keeping a second list, adds Sources/Writing/, refreshes hotspots (as of 2026-10-01) and .claude/.
• docs/archive/ + README: the July speaker-eval JSON output. Everything else dated stays put because code, scripts or tests cite it.
• README: Writing shipped in 1.1.67, so the "coming in 1.1.67" notes are gone; the download is ~700 MB now (1.1.68 DMG).
• docs/writing-plan.md says it shipped and points at current docs. Settings spec, meeting-language doc and route-recovery QA doc match today's Settings layout. CONTRIBUTING lists Writing and check.sh; WORKFLOW step 10 uses check.sh.

Left alone on purpose

• Sources/Support/AGENTS.md, Sources/UI/AGENTS.md (Notch island is the only dictation window #1946) and Sources/Observability/AGENTS.md (Keep runtime heartbeat preference reads off the main thread #1941) are being edited by open PRs.
• Release-flow docs untouched.

Checks

• python3 scripts/dev/check-doc-paths.py: OK (136 files)
• python3 scripts/dev/check-known-traps.py: OK
• bash check.sh quick: 59/60. The one failure was scripts/vm/test-transcripted-vm.sh (supervise.py SIGINT timing self-test) under heavy parallel load; it passed 63/63 on a rerun. Unrelated to docs.

Review level: docs-only, so check.sh per AGENTS.md.

🤖 Generated with Claude Code

[r3dbars]

Review verdict: docs only, no code touched. Two review passes. The first found nothing. The second found three doc errors. I checked all three against the code and fixed them in 42b20de.

1. Fixed. Sources/UI/Settings/AGENTS.md said Nemotron is Core's default. It's only the app's default (Sources/Support/DiarizationBackendPreferences.swift). Core still defaults to pyannote (DiarizationService.swift:82, DiarizationBackend.swift). The line now says that.
2. Fixed. docs/qa-audio-route-notification-recovery.md pointed testers at a Mac mic recorder switch in Settings, and there isn't one. The recorder ships on (PinnedMicrophoneCapturePreferences.shipsOnByDefault = true). The doc now says the base pass covers it, then gives the defaults write ... pinned-microphone-capture -bool false / TRANSCRIPTED_PINNED_MIC_CAPTURE=0 off pass, run once with Faster Bluetooth dictation off and once on. It also says how to restore the default afterward.
3. Fixed (low). docs/ui-settings-menubar-spec.md now also lists the second "Transcribe audio file" entry point, the secondary action on the Meetings page's empty state (HomeSettingsPage.swift:176).

Checks: bash check.sh passed everything except build.sh. That failed only because the fresh worktree had no deps yet. build-deps.sh --force then ran in the same pass, and a rerun of bash build.sh --no-open passed. check-doc-paths.py is OK (136 files).

🤖 Generated with Claude Code