The embedded guide catches up on its own — creation-time parity for both apps, an open-time refresh for the phone

The card's frozen spec recommended Option C (install the agent guide at
board creation); the owner's follow-up comment extended that ruling to a
second axis — embedded guidelines should update whenever a board opens if
the on-disk version is older than Lanework's, which the Mac app already
does via BoardStore.refreshAgentGuide()/runScheduledHeals(). This card
implements both halves.

- BoardWriter.createBoard now calls AgentGuide.install(atBoardRoot:)
  right after seedGitignoreIfAbsent, so every board — Mac- or
  phone-created, since KanbanMobile.BoardIndexStore.createBoard calls
  this same method — is born with a current-version CLAUDE.md, with no
  dependency on a later open. Routed through AgentGuide.install itself
  rather than a hand-rolled write, so never-downgrade, the
  CLAUDE.user.md rescue, squatter displacement, and the EchoLedger
  heal-attribution exclusion all carry over unchanged.

- BoardSession (KanbanMobile) gains a private refreshAgentGuideOnce(),
  fired once from open() (already idempotent on the .idle phase),
  fire-and-forget through the same CoordinatedFileAccess.write bracket
  every phone write uses. Deliberately not a heal scheduler — a
  one-shot courtesy check at session open, silent on failure (logged,
  never surfaced to lastError or a banner), matching AgentGuide's own
  "nothing here is a user-facing event" posture. The type's doc comment
  now names this one exception while keeping "no heal scheduler" true.

- project.yml: lifted the KanbanMobile target's AgentGuide.swift build
  exclusion (dating to the original mobile MVP, "agents work where the
  Mac app runs") — both changes above fail to compile on the phone
  without it, since the type simply wasn't in that module. Verified
  safe: AgentGuide.swift imports only Foundation, and its one upward
  dependency touches only EchoLedger's unconditional recording API,
  never the #if os(macOS)-gated consumer surfaces.

Tests: KanbanTests/BoardWriterTests.swift gains
createBoardInstallsTheCurrentAgentGuide, calling createBoard directly
and asserting the guide lands at AgentGuide.version immediately — the
card's own Done-when, and also the phone's creation-time coverage since
it's the same call site. KanbanMobileUITests/AgentGuideUITests.swift
covers the open-time refresh itself, the one piece only reachable
end-to-end from a running KanbanMobile process (no mobile unit-test
target exists): the bundle's fixture board already carries no
CLAUDE.md, so tapping into it and polling disk proves the wiring with
no fixture changes needed.

Claude-Session: https://claude.ai/code/session_014PtZdPwqZuqEDLc6wZMtEy

project.yml

@@ -141,12 +141,14 @@ targets:
         buildPhase: resources
       # The shared storage engine — frontmatter, loader, writer, ranks, integrity. Pure
       # Foundation + Yams + swift-markdown; no AppKit anywhere in the directory, which is what
-      # makes this line possible. One exclusion: AgentGuide reaches up into LiveStore's
-      # EchoLedger (its bracketed-write seam), and the AGENTS.md guide it writes is a Mac
-      # feature — agents work where the Mac app runs.
+      # makes this line possible. **No exclusions as of 2026-08-09**: `AgentGuide` used to sit
+      # out of this list ("agents work where the Mac app runs"), but the owner's ruling that day
+      # extended the guide to every board-creation call site and to a one-shot refresh at
+      # `BoardSession.open()` — both phone-side — so it has to compile here too. It only reaches
+      # up into `LiveStore/EchoLedger.swift`'s unconditional recording API
+      # (`markHeal`/`recordMove`, below), never the `#if os(macOS)`-gated consumer surfaces, so
+      # nothing about "no FSEvents, no git on the phone" changes.
       - path: Kanban/Storage
-        excludes:
-          - AgentGuide.swift
       # The writer layer's one upward dependency: BoardWriter stamps every write into the
       # task-local receipt ledger so a store can tell its own echoes from foreign changes. The
       # recording side is pure CryptoKit + Foundation + Synchronization and compiles here; the