Slim memory files — move reference content to in-repo docs #7

Closed
opened 2026-03-22 19:05:15 +01:00 by timothy · 2 comments
Owner

Problem

ErsatzTV memory loads 42 lines (MEMORY.md) + 59 lines (ci-cd.md) = ~100 lines per session. The ci-cd.md file is pure reference documentation that belongs in the in-repo docs/ folder, and MEMORY.md duplicates tech stack info already in CLAUDE.md.

Changes

Move ci-cd.md (59 lines) → docs/ci-cd.md

This is reference documentation about upstream GitHub Actions workflows, Gitea Actions compatibility, build steps, and registry options. It belongs alongside the existing docs/fork-strategy.md, docs/channels.md, and docs/m3u-xmltv.md.

Update MEMORY.md to point to docs/ci-cd.md instead of the memory file.

Remove from MEMORY.md

  • Tech Stack Quick Ref (~4 lines) — duplicates CLAUDE.md which already has the full tech stack
  • Key Patterns (~4 lines) — duplicates CLAUDE.md architecture section

Keep in MEMORY.md

  • Fork status and Gitea repo link
  • FFmpeg base image details (active dependency)
  • CI/CD summary (pointer to docs/ci-cd.md)

Target: ~20 lines (down from 42 + 59 = 101)

No vault involvement

ErsatzTV is a fork with its own in-repo docs. Content stays in-repo, not in the homelab vault.

## Problem ErsatzTV memory loads 42 lines (MEMORY.md) + 59 lines (ci-cd.md) = ~100 lines per session. The ci-cd.md file is pure reference documentation that belongs in the in-repo `docs/` folder, and MEMORY.md duplicates tech stack info already in CLAUDE.md. ## Changes ### Move `ci-cd.md` (59 lines) → `docs/ci-cd.md` This is reference documentation about upstream GitHub Actions workflows, Gitea Actions compatibility, build steps, and registry options. It belongs alongside the existing `docs/fork-strategy.md`, `docs/channels.md`, and `docs/m3u-xmltv.md`. Update MEMORY.md to point to `docs/ci-cd.md` instead of the memory file. ### Remove from MEMORY.md - **Tech Stack Quick Ref** (~4 lines) — duplicates CLAUDE.md which already has the full tech stack - **Key Patterns** (~4 lines) — duplicates CLAUDE.md architecture section ### Keep in MEMORY.md - Fork status and Gitea repo link - FFmpeg base image details (active dependency) - CI/CD summary (pointer to docs/ci-cd.md) Target: ~20 lines (down from 42 + 59 = 101) ## No vault involvement ErsatzTV is a fork with its own in-repo docs. Content stays in-repo, not in the homelab vault.
Author
Owner

Starting work on this. Plan:

  1. Move ci-cd.md from memory → docs/ci-cd.md (in-repo)
  2. Remove "Tech Stack Quick Ref" and "Key Patterns" sections from MEMORY.md (duplicated in CLAUDE.md)
  3. Update MEMORY.md CI/CD pointer to reference docs/ci-cd.md
  4. Remove "Architecture Docs" section (just a TOC of docs/ — discoverable from the directory itself)
  5. Delete the old memory ci-cd.md file
Starting work on this. Plan: 1. Move `ci-cd.md` from memory → `docs/ci-cd.md` (in-repo) 2. Remove "Tech Stack Quick Ref" and "Key Patterns" sections from MEMORY.md (duplicated in CLAUDE.md) 3. Update MEMORY.md CI/CD pointer to reference `docs/ci-cd.md` 4. Remove "Architecture Docs" section (just a TOC of docs/ — discoverable from the directory itself) 5. Delete the old memory `ci-cd.md` file
Author
Owner

Done. Changes:

Moved to in-repo docs:

  • ci-cd.md (59 lines) → docs/ci-cd.md — joins existing fork-strategy.md, channels.md, m3u-xmltv.md

Removed from MEMORY.md (duplicated in CLAUDE.md):

  • "Tech Stack Quick Ref" section (~4 lines)
  • "Key Patterns" section (~4 lines)
  • "Architecture Docs" index (~4 lines) — discoverable from docs/ directly

Kept in MEMORY.md:

  • Fork status + Gitea repo link
  • FFmpeg base image details
  • CI/CD summary (pointer to docs/ci-cd.md + issue refs + env ports)

Result: 101 lines → 18 lines of memory loaded per session (82% reduction).

Files changed:

  • docs/ci-cd.md (new, in-repo)
  • ~/.claude/projects/.../memory/MEMORY.md (slimmed)
  • ~/.claude/projects/.../memory/ci-cd.md (deleted)
Done. Changes: **Moved to in-repo docs:** - `ci-cd.md` (59 lines) → `docs/ci-cd.md` — joins existing `fork-strategy.md`, `channels.md`, `m3u-xmltv.md` **Removed from MEMORY.md (duplicated in CLAUDE.md):** - "Tech Stack Quick Ref" section (~4 lines) - "Key Patterns" section (~4 lines) - "Architecture Docs" index (~4 lines) — discoverable from `docs/` directly **Kept in MEMORY.md:** - Fork status + Gitea repo link - FFmpeg base image details - CI/CD summary (pointer to `docs/ci-cd.md` + issue refs + env ports) **Result:** 101 lines → 18 lines of memory loaded per session (82% reduction). **Files changed:** - `docs/ci-cd.md` (new, in-repo) - `~/.claude/projects/.../memory/MEMORY.md` (slimmed) - `~/.claude/projects/.../memory/ci-cd.md` (deleted)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: timothy/ersatztv#7