# AGENTS — how to work in this repo

This file is auto-read at the start of every session. The project keeps its
memory as a linked map of markdown files — read it before doing anything.

## ⚠️ CRITICAL: The Good Dog Rule

BEFORE any planning or coding, follow this rule:

> ONE integration test per branch, ONE test per PR.

When the user asks for changes that would involve multiple integration tests:
1. Identify the ONE specific use case/test they want to work on
2. Do NOT create branches or PRs for multiple tests
3. Focus ONLY on the single use case until it's complete and tests pass

> *A good dog learns one trick perfectly before learning the next.*
>
> PRs that address multiple integration tests will be REJECTED.

MUST read the architecture guide before planning or modifying the codebase:
[`ai.md`](ai.md) (+ [`schema.md`](schema.md) for the memory-map conventions).

MUST read the coding guide before writing tests or code: the [Working
rules](#working-rules) in this file — this repo has no `CODING.md`;
conventions live here and in `ai.md`.

## Onboarding (in order)

1. [`schema.md`](schema.md) — the memory-map conventions (what lives where, how to keep it true).
2. [`ai.md`](ai.md) — the AI guide: architecture, patterns, decisions, current state.
3. [`TASKS.md`](TASKS.md) — the task queue + authoritative YouTube API research.
4. `<dir>/index.md` — the index for any directory you're about to touch.

## Working rules

- **Never work without the map.** If the map contradicts the code, the code wins
  and the map gets fixed in the same change (stale facts are corrected, not appended).
- **Every feature change ships with its memory update:** `ai.md` for
  architecture/patterns, `TASKS.md` for status, index files when layout changes.
- **Follow existing conventions** — MVVM, `RelayCommand` for actions,
  `ViewModelBase.SetProperty<T>()`, all styles in `Themes/Controls.xaml`
  (merged once in `App.xaml`; never duplicate per-window).
- **Do not add comments unless the code needs them; do not expand the task queue
  on your own** — work only what the user queues.
- **Response style: no default planning template.** Do the work, then report
  what changed and what's next. No "Plans & Pitfalls", pros/cons tables, or
  step-by-step plans unless the user asks for a plan first (see `ai.md`).
- **No-Fluff Mode is available on request** — unpadded, ruthless review that
  argues rather than reassures (see `ai.md`). Optional, never the default.

## Build

```bash
dotnet build   # Windows-only WPF; builds from WSL via EnableWindowsTargeting
```

Keep it at **0 warnings**. Running requires Windows. On a silent startup crash,
read `%APPDATA%\ytLlive\startup.log` (`Helpers/AppLog.cs` writes checkpoints and
unhandled exceptions there).