agentic automation, yay!

marker-context.md

@@ -0,0 +1,113 @@
+# Premiere / OBS marker types
+
+Reference for tagging streams in Premiere and writing `editDesc` chapters.  
+Companion to [`prompts.txt`](prompts.txt) (editDesc cleanup rules).
+
+## Deliverable vs internal
+
+| Category | In YouTube chapters / `editDesc`? |
+|----------|-----------------------------------|
+| Descriptive location & activity markers | Yes |
+| Deliverable tangent pairs (tag in / tag out) | Yes |
+| Pipeline stamps (`gamign`, `env`, raw `SEG`) | No |
+| `FUNI`, `FUNI(INT)`, `funi`, `INT:`, `LORE:` | No |
+| `AFK` / `UNAFK` | Usually yes (viewer-facing breaks) |
+| `starting soon` / `preramble` / `postramble` / `goodbye` (renamed from Start, BEGIN, last env, END) | Yes (stream bookends) |
+| Raw `BEGIN` / `END` / `AFK` / `UNAFK` | Yes (or folded into longer chapter titles) |
+
+---
+
+## OBS pipeline stamps (purple)
+
+Hotkey stamps from the streaming layout. **Not chapter titles** — they mark OBS scene/layout switches and get stripped from `editDesc` (see `prompts.txt`).
+
+| Marker | Purpose |
+|--------|---------|
+| **gamign** | Gaming layout / game capture active (intentional typo). |
+| **env** | Environment / desktop / non-game layout. The **last** `env` of the stream (desktop at wrap-up) is usually relabeled **`postramble`** in `editDesc` — same timestamp, different chapter title. |
+| **SEG** | Orange OBS chapter stamp for “new topic segment.” Often replaced in post with a descriptive deliverable label, or converted to `INT:` if the tangent is editor-only. |
+
+These align to OBS marker times, not transcript guesses. When adding deliverable chapters, use the **marker timestamp**, not speech alone.
+
+---
+
+## Internal editor notes
+
+Never front-facing. Strip from `editDesc`.
+
+| Prefix | Purpose |
+|--------|---------|
+| **INT:** | Internal note to editor — excluded from delivery. **White** in Premiere. Example: `INT: desktop` (alt-tab too fast to matter on VOD). Not the same as “interruption”; non-deliverable tangents get `INT:`, deliverable ones get descriptive tag in/out. |
+| **FUNI** | **“Clip that”** — flag a moment to save for **TikTok, Reels, and YouTube Shorts**. **Blue** — OBS hotkey stamp during stream. May include a short label (e.g. `FUNI cozy awoo`). |
+| **FUNI(INT)** | Was **FUNI** originally; relabeled **`FUNI(INT)`** manually when the clip note is internal/editor-only rather than a straight short. Stays **blue** (FUNI lineage). Strip from `editDesc` like other internal markers. |
+| **funi** | Same purpose as **FUNI**, but **lowercase** and **aquamarine** — added manually in post (not an OBS marker). Example: `funi ubear gift`. |
+| **LORE:** | Lore / callback note for editor or future reference, not a public chapter. |
+
+---
+
+## Stream structure — hard tags (yellow/tan)
+
+Predefined stamps from the OBS/py pipeline. **Yellow/tan** in Premiere (`4281049552` in [`0csv_to_xml.py`](2026/0csv_to_xml.py); muted tan-yellow in the UI). `setColorByIndex(4)` — not index 5 (that is **white**, used for `INT:`).
+
+| Raw marker | Purpose |
+|------------|---------|
+| **Start** | Pre-stream hold. **Green** (default color when no `pproColor` is set — from `0csv_to_xml.py`). |
+| **BEGIN** | Stream proper begins (hard tag). |
+| **AFK** | Stepping away — break starts. |
+| **UNAFK** | Back from break. |
+| **END** | Stream over (hard tag). |
+
+### `editDesc` rename conventions
+
+Premiere keeps the raw stamp names; chapters use friendlier labels at the **same timestamps**:
+
+| Raw stamp | `editDesc` chapter title |
+|-----------|--------------------------|
+| **Start** | **starting soon** (always) |
+| **BEGIN** | **preramble**, **setup + rambling**, or similar (often) |
+| last **env** | **postramble** (often) |
+| **END** | **goodbye** (always) |
+
+`prompts.txt` still strips raw `env` lines — you replace that slot with `postramble` when writing chapters. `BEGIN` / `END` / `AFK` / `UNAFK` stay as chapter lines (or get merged into longer titles like `chatting + goodbye`).
+
+---
+
+## Deliverable content markers (red / descriptive)
+
+Added during tagging (MCP or manual). Short labels: locations, bosses, setup beats, tangents worth skipping or revisiting.
+
+### Gameplay & exploration
+Examples: `Bellhart`, `far fields arena`, `goo beast defeated`, `first sinner fight`.
+
+### Deliverable tangents — tag in / tag out
+For skippable or revisit-worthy segments (gift popups, detours, downloads):
+
+1. **Tag in** — descriptive name at segment start (e.g. `Subnautica 2 gift`).
+2. **Tag out** — descriptive name where main content resumes (e.g. `far fields arena` after gift ends).
+
+Both bounds are deliverable chapter candidates. Do **not** use `gamign` or `env` as tag-out labels.
+
+---
+
+## `editDesc` workflow
+
+- Chapters in `editDesc/*.txt` are **semi-manual** (JSyntax Workflows + cursor edit prompt).
+- Agent tagging work targets **Premiere markers**; do not auto-fill `editDesc` with `INT:`, `FUNI`/`funi`, or pipeline stamps.
+- `prompts.txt` rules still apply: remove `FUNI`, `INT`, `LORE`, `gamign`, and `env` lines (treat lowercase `funi` the same as `FUNI`); normalize YouTube timestamps.
+
+---
+
+## Premiere marker colors (`0csv_to_xml.py`)
+
+| Marker family | Color | `setColorByIndex` |
+|---------------|-------|-------------------|
+| Start | Green (default) | 0 |
+| Deliverable tags (locations, tag in/out, bosses) | Red | 1 |
+| gamign, env | Purple | 2 |
+| SEG | Orange | 3 |
+| BEGIN, END, AFK, UNAFK | Yellow/tan | 4 |
+| INT: | White | 5 |
+| FUNI, FUNI(INT) | Blue | 6 |
+| funi | Aquamarine / turquoise | 7 |
+
+When adding markers via MCP: red = 1, white (`INT:`) = 5. Hard tags share the same yellow/tan as each other, not white.

prompts.txt

@@ -1,3 +1,3 @@
-rm all FUNI, INT, LORE, 'gamign', and 'env' timestamps
+rm all FUNI, funi, INT, LORE, 'gamign', and 'env' timestamps
 
 fix timestamps for youtube (truncate extra zeros, e.g. 0:00, 7:21, etc)