From 7c7546f1daef86da75ee9a5b8123000e9d77d065 Mon Sep 17 00:00:00 2001 From: Eric Bell Date: Mon, 31 Aug 2026 16:17:08 -0400 Subject: [PATCH] added build-watcher; updated README --- README.md | 18 ++++++++++++++++++ build-watcher.md | 31 +++++++++++++++++++++++++++++++ 2 files changed, 49 insertions(+) create mode 100644 build-watcher.md diff --git a/README.md b/README.md index 3886e35..33d3587 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ This README catalogs the tools and resources in this directory. It is intended f | `sources/xpon-squeeze-2026-08-24.md` | XPON Short Squeeze — Premarket signal reconstruction (2026-08-24) with volume spike and squeeze mechanics. | `xpon-squeeze-2026-08-24.md` | Use for studying a micro-cap short squeeze setup and premarket signals. | | `tos-short-squeeze/` | Contains a TSV file for short squeeze scanning. | `ShortSqueezeScanner.tsv` | Use for scanning short squeeze opportunities using the provided TSV data. | | `backtest-workflow-PLAN.md` | Draft plan for a backtesting workflow (approved and built) describing architecture and stages. | `backtest-workflow-PLAN.md` | Use for understanding the design of the backtest-strategy workspace. | +| `build-watcher.md` | Build spec/prompt for a scheduled 9EMA×VWAP cross alert watcher on MESU6 futures. | `build-watcher.md` | Use when building, reviewing, or resuming the MESU6 9EMA/VWAP cross scheduled-alert watcher (or as a template for a similar cross-based futures alert). | ## Tools @@ -250,6 +251,23 @@ Understanding the design of the `backtest-strategy` workspace or as a reference **Setup / dependencies:** None noted. +### `build-watcher.md` + +**Purpose:** +Prompt/spec for building a scheduled-alert watcher that fires on a 9EMA×VWAP cross for MESU6 (MES Sep 2026 front month). Signal: 9EMA on 3-minute bar closes (built from 1-minute bars) crossing session VWAP anchored at the 9:30 AM ET open. Cross up = long trigger, cross down = short trigger. Explicitly scoped as a scheduled-alert build, not a Holy Grail analysis. + +**Contents:** +- `build-watcher.md` — signal definition, data-source rules, alert discipline, schedule parameters, and credit-cost note. + +**Use when:** +Building, reviewing, or resuming work on the MESU6 9EMA/VWAP cross scheduled alert, or as a template for a similar cross-based futures alert watcher. + +**Setup / dependencies:** +Requires the TTG futures MCP server (`futures_aggs` for bars, `futures_snapshot` for last price) and a Scheduled job runner. The SCHEDULE section (active window, hard stop, fire cap) contains bracketed placeholders in the current draft — these must be filled in before a job is created, and the confirm card must be reviewed and approved before creation. + +**Notes:** +Fires only on an actual state change (no re-alerts); permanently silent after the watch ends or the fire cap is hit. Job pause/delete is user-owned via the Scheduled sidebar — the agent must never pause/delete it itself. Each fired alert costs ~50 Active Trader credits; polls are free. + ## Maintenance Notes When adding or updating a tool folder, update this README with: diff --git a/build-watcher.md b/build-watcher.md new file mode 100644 index 0000000..d321b46 --- /dev/null +++ b/build-watcher.md @@ -0,0 +1,31 @@ +Build and implement a 9EMA×VWAP cross watcher for MESU6 (MES Sep 2026 front month). +Do not run a Holy Grail analysis — this is a scheduled-alert build. Plan it, show me +the confirm card, and I approve before anything is created. + +SIGNAL +- Compute 9EMA (my TL) on 3-minute bar closes, built from 1-minute MESU6 bars. +- Compute session VWAP anchored at the 9:30 AM ET day-session open. +- Cross UP (9EMA above VWAP, was below) = long trigger. Cross DOWN = short trigger. +- Use the TL×VWAP crossover as the signal, exactly as drawn on my 3-min MES charts. + +DATA RULES +- All market data from TTG futures MCP only: futures_aggs for bars, futures_snapshot + for the exact last price ({ticker: "MESU6"}). Never estimate or approximate prices. + +ALERT DISCIPLINE +- Alert only on an actual cross (state change). No re-alerts while state is unchanged. +- First-match-only, no redundant snapshot calls when nothing changed. +- Alert text: under 3 sentences, exact price, e.g. "MESU6 9EMA crossed UP over VWAP + @ 7691.25 (long trigger) — 3:42 PM ET." +- Once the watch ends, it goes permanently silent — every later run is a no-op. +- Job pause/delete is owned by me via the Scheduled sidebar; you never pause it yourself. + +SCHEDULE +- Poll every 1 minute. +- Active window: [START — e.g., "tomorrow 9:30 AM ET" or "now, evening session"] +- Hard stop: [DEADLINE — e.g., "8:45 PM ET" / "4:00 PM ET"], after which permanent silence. +- Fire cap: [MAX ALERTS — e.g., "4 per session", then silent until next session]. + +CREDITS +- Each fired alert costs ~50 Active Trader credits; polls are free. Confirm no + per-run billing on the confirm card before creating.