Skip to content

Add CLAUDE.md: persistent session memory for AI agents - #109

Merged
sanylax0 merged 1 commit into
mainfrom
claude/repo-review-improvements-yvk3t7-claude-md
Jul 20, 2026
Merged

sanylax0 merged 1 commit into
mainfrom
claude/repo-review-improvements-yvk3t7-claude-md

Conversation

@sanylax2

Copy link
Copy Markdown
Collaborator

Adds CLAUDE.md at the repo root — loaded automatically into every Claude session's context, making it persistent memory across sessions.

It deliberately does not duplicate AGENTS.md (architecture, layering, build commands stay there). It captures everything else learned across sessions:

  • Owner & workflow: PR conventions (one issue per PR, non-draft, fresh-branch rule), the sanylax0/sanylax2 account split, device-testing loop, RCA-over-whack-a-mole preference — and the assistant's chosen name, Crossfade.
  • Engineering history: the full jetsam/OOM root-cause chain (ORT graph-optimization fix + all the structural guards that must not regress), the stale-hostTime play(at:) SIGABRT and its freshness rule, the UI architecture decisions (leaf-view tick isolation, hybrid backdrop, hard-inset pager) and why each exists, smooth-skip/displayProgress design, catalog search.
  • Operations: TestFlight cloud-signing setup, required Admin-role ASC key, known failure modes (90382 upload limit, App-Manager key error), core-tests-linux behavior, the legacy Xcode Cloud workflow.
  • App Store track status and the 10 known-but-deferred issues from the memory audit.
  • Device debugging recipes (console filters, jetsam vs crash artifacts).

🤖 Generated with Claude Code

https://claude.ai/code/session_013TJoWkqg8bzkGdzxWhWjWP


Generated by Claude Code

Complements AGENTS.md (architecture/build) with what it doesn't cover:
owner preferences and workflow, the resolved jetsam/OOM and interruption-
SIGABRT root causes and the guards that must not regress, UI architecture
decisions and their reasons, CI/TestFlight operational knowledge, the App
Store release-candidate track, and the known-issues backlog from the
memory audit.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013TJoWkqg8bzkGdzxWhWjWP
@sanylax0
sanylax0 merged commit 6bc8068 into main Jul 20, 2026
4 checks passed
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.

3 participants