Cline rules

1# Project Context
2 
3This repository is a Python Twitch chat bot.
4 
5The bot listens to Twitch chat through TwitchIO EventSub and generates short public replies through the OpenAI Responses API.
6 
7## Core Files
8 
9- `main.py` contains the bot runtime, Twitch EventSub subscription, reply decision logic, OpenAI calls, cooldowns, and logging.
10- `.env.example` documents configuration variables. Do not add real secrets to it.
11- `prompt/system_prompt.txt.example` is the committed prompt template.
12- `prompt/system_prompt.txt` is local-only and may contain private behavior instructions.
13- `.github/workflows/pr-agent.yml` configures PR-Agent for GitHub pull requests.
14- `.pr_agent.toml` configures PR-Agent behavior.
15 
16## Project Constraints
17 
18- Keep implementation simple unless a change clearly benefits from splitting modules.
19- Preserve TwitchIO EventSub behavior unless the task explicitly changes how chat messages are received.
20- Treat Twitch chat replies as public user-facing output.
21- Keep replies short, bounded, and appropriate for live chat.
22- When adding or changing environment variables, update `.env.example` and `README.md`.
23- When changing user-visible behavior, update `README.md`.
24 
25## Security
26 
27- Never read, print, commit, or expose values from `.env`, `prompt/system_prompt.txt`, `.tio.tokens.json`, or API token files.
28- Do not log `OPENAI_API_KEY`, `TWITCH_TOKEN`, `TWITCH_CLIENT_SECRET`, or OAuth validation responses containing sensitive data.
29- Do not weaken checks around Twitch token scopes or `TWITCH_BOT_ID` ownership without a specific reason.
30 
31