diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..1c211c1e --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,84 @@ +# Bitvid — AI Agent Guide + +This guide tells AI agents how to keep Bitvid aligned with the current product direction. Follow it whenever you touch code, content, or documentation inside this repository. + +--- + +## 1. Release Channels: Main vs. Unstable + +* **Main** is the production track. Anything merged here must preserve today’s UX and magnet safety guarantees. Rollbacks should be painless: keep commits atomic, avoid destructive migrations, and leave feature flags in a known-good default (`false` unless product explicitly flips them). +* **Unstable** is our experimentation lane. Gate risky behavior behind feature flags defined in `js/constants.js` and document the toggle/rollback plan in PR descriptions. +* **Emergency response:** If a change regresses URL-first playback or breaks magnet parsing, revert immediately and annotate the AGENTS.md changelog with remediation tips so future agents do not repeat the mistake. + +## 2. Mission: URL‑First Playback with WebTorrent Fallback + +* **Goal:** Always deliver smooth playback while keeping hosting costs low. +* **Primary transport:** A hosted video URL (MP4/WebM/HLS/DASH) that the `