processes/ -> playbooks/ (git mv preserves history; updated cross-refs in ROADMAP, README, subtitles playbook + scripts). playbooks/import-media/README.md v1.0 — 7-step import workflow: stage on onyx -> rsync to nullstone -> chmod -> verify scan -> Items/Counts bump -> optional subtitle pass -> run-log Cross-references docs/05/07/08, ADMIN-GUIDE, README. Mirrors the existing subtitles playbook structure (CHANGELOG + runs/_template). CHANGELOG v1.0 lists known gaps (bin/cleanup-import.sh and bin/normalize.py still doc-only, ROADMAP M6). First run logged: playbooks/import-media/runs/lilo-stitch-2002.md. Lilo & Stitch (2002) imported to /home/user/media/movies/, item c2f4aff133c1b9631500fadf293b0b2f, TMDb 11544, MovieCount 3 -> 4. LibraryMonitor didn't auto-fire — needed manual /Library/Refresh; playbook updated to make this an unconditional step. Source: 1080p BluRay HEVC 10-bit / EAC3 5.1 / 2x PGS embedded subs. Per quality bar (README.md:41) — passes.
29 lines
1.5 KiB
Markdown
29 lines
1.5 KiB
Markdown
# playbooks/ — repeatable acquisition workflows
|
|
|
|
Runbook-style playbooks for repeatable ARRFLIX ops — subtitles, importing
|
|
media, artwork, metadata, episode stills, and any other recurring acquisition
|
|
or maintenance procedure. Each playbook is a standalone recipe Claude Code
|
|
(or a human operator) can execute end-to-end.
|
|
|
|
This folder holds the canonical recipes for **acquiring external content** for
|
|
the ARRFLIX library: subtitles, artwork, metadata, episode stills, etc.
|
|
Internal ops (encoding, importing, theming) stay in `bin/` and `docs/`.
|
|
|
|
Each playbook is its own sub-folder with three files:
|
|
|
|
| File | Purpose |
|
|
|---|---|
|
|
| `README.md` | The canonical recipe. Step-by-step, executable by Claude Code. Always reflects the latest version. |
|
|
| `CHANGELOG.md` | Why the recipe changed, version-by-version. One entry per breakage that forced a revision. |
|
|
| `runs/<show>.md` | Evidence log: what happened when this recipe was applied to a specific show. |
|
|
|
|
Recipes evolve via the **iteration model**: apply to a show, succeed or break,
|
|
amend the recipe to handle the new case + every prior case, retry. A recipe
|
|
that "just works" is one that has survived every show in the library without
|
|
amendment for a full sweep.
|
|
|
|
## Children
|
|
|
|
| Playbook | Status | Last touched |
|
|
|---|---|---|
|
|
| [`subtitles/`](subtitles/) | v3.5 — YouTube auto-CC added as stop-gap for shows with no community subs anywhere (verified via 3-agent research run). AD 49/58 + Sassy 5/5. v4 WhisperX planned (ROADMAP H5) | 2026-05-10 |
|