Spin guard: derivative-work rule (AGENTS.md) + rationale (ai.md) — proactive external scan cites in commit msg; 2nd failed fix = STOP and research externally, never a 3rd guess

Project lesson cited (the 2026-08 web-box saga, 9 commits): browser sources are fixed canvases
per OBS convention — the 'gap' was a widget CSS glow, not a bug.
This commit is contained in:
2026-08-28 12:30:00 -07:00
parent e75059a795
commit 1e633f9bd9
3 changed files with 30 additions and 0 deletions
+11
View File
@@ -58,6 +58,17 @@ at a problem.
(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.
- **Derivative work / spin guard.** Every problem here is derivative — OBS, other
overlay tools, and the WPF/WebView2 ecosystems already solved it. Both sides are
mandatory, not advisory:
- **Proactive (new features):** before writing code, do a quick external scan
(websearch: how do OBS/CEV/overlay tools do this?) and cite the reference in the
commit message.
- **Spin guard (objectively triggered):** a SECOND failed remedy for the same
symptom = STOP. No third guess over the same code. Research the established
answer externally, cite its URL in the commit message AND in `MyMistakes.md`,
then code it. You do not know everything — repeated failure is a research
trigger, not a persistence trigger.
- **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`).
+5
View File
@@ -43,6 +43,11 @@ auto-fit sized to the crop (`ab29ec8`, reverted).
## Key facts / landmines
- **Why the web-box saga spun (2026-08):** nine commits of in-head theorizing for a problem
OBS already solved (browser source = fixed canvas, box = user-sized, content clips at the
edge). The apparent gap was the widget's CSS glow, not a bug. → AGENTS.md now mandates
external research on the second failed fix and proactive scans for new features.
- **App running locks `ytLive.exe`** → build fails MSB3027 until creator exits the app.
- **Startup diagnostics:** unhandled exceptions + checkpoints go to `%APPDATA%\ytLlive\startup.log`
(`Helpers/AppLog.cs`). On a silent startup crash, read that.
+14
View File
@@ -14,6 +14,20 @@ Skip feature pitch, step-by-step implementation plans, pros/cons tables, and
"potential pitfalls" sections unless the user explicitly asks for a plan first.
A short diff-style summary beats a proposal document every time.
## Derivative work (spin guard mandated in AGENTS.md)
Nothing we build is novel — streaming/overlay/WebView2 problems were solved by
OBS, CEV, and WPF ecosystems long before us. Two consequences:
1. **Proactive:** new features start with a quick external scan, not head-first
design (citation goes in the commit message).
2. **Objectively triggered spin guard:** a second failed fix for the same symptom
means STOP theorizing and research the established answer externally; there is
no unique bug in this repo that the wider ecosystem hasn't hit.
This project's hard lesson: the web-source bounding saga (2026-08) burned 9
commits rediscovering that a browser source is a *fixed canvas* — OBS keeps it at
a stable page size, crops/hugs content via the box, and clips at the edge. The
apparent "gap" that ended the saga was a widget's own CSS glow effect, not a bug.
## LAN infrastructure (192.168.50.x)
All LAN credentials live in `CREDENTIALS.md` (gitignored). Server IPs and roles: