Documentation Index
Fetch the complete documentation index at: https://docs.signalrooms.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Repo rules for agents
Status: Current repo-native rules. The Warmr repo files (⚠ Read this first
These pages are for AI agents editing files inside the private Warmr repo, not for agents using SignalRoom. If you got here because someone said “Claude, drive my morning posting run” or “GPT, check whether Lane 2 finished”. you’re in the wrong section. Go to Driving Warmr (for agents) instead. That page coverswarmrctlusage, pre-flight, action commands, and recovery. Nothing here applies to live operations. Stop here if any of the following are true:The cost of getting this wrong is real. Warmr is a live product running on operator hardware. Bad edits to app code, signing certs, release artifacts, or CI configuration can break posting runs in production, invalidate signed builds, or hand operators a broken update. Read these rules before any file edit. When unsure, stop and ask.
- You are not editing files in
github.com/dylanpakd-cyber/warmr(the private app repo).- You were not given an explicit task scope by the repo operator.
- You are working in the canonical checkout instead of a fresh worktree (see Worktree protocol).
STATUS.md, CLAUDE.md, AGENTS.md, CONTEXT.md) are the source of truth and override anything here on conflict.
SignalRoom is the public product name. Warmr is the macOS app + control-plane repo that powers it. These rules govern how AI agents work inside the Warmr repo, what to read first, where to make changes, what to commit, what to leave alone.
Source order
Read in this order before changing anything in the Warmr repo:STATUS.md: current state, what’s shipped, what’s in flight.CLAUDE.md. Claude-specific protocol and the worktree workflow.AGENTS.md. Codex / other-agent protocol and repo rules.CONTEXT.md: the project’s domain language.- Existing docs under
docs/agents,docs/plans,docs/prd,docs/release,docs/adr, anddocs/handoffs.
Work style
- Inspect before changing. Read the file, run a freshness check, understand the surrounding code or copy.
- Prefer small docs and code changes with clear, runnable verification.
- Do not assume unfinished features are current. Anything labeled In progress or Planned is not shipped.
- Use Current, In progress, and Planned labels in repo docs to mirror this discipline.
- Keep Mintlify as a mirror of curated repo-native docs, not the source of truth.
Audience boundary
This section answers “I’m editing Warmr’s source, what are the rules?” If your question is one of:- “How do I use SignalRoom?” → SignalRoom product overview.
- “How do I set it up?” → Your first 30 minutes.
- “How do I drive Warmr via
warmrctl?” → Driving Warmr (for agents). - “What command does X?” → warmrctl reference or Control-plane reference.
Continue reading
- Repo rules, required read order, safety rules, reporting rules.
- Worktree protocol, fresh-worktree workflow, freshness gates, canonical-checkout policy.
- Safe agent actions, what you can do without escalation.
- Forbidden agent actions, what you must not do, and the cost of doing it anyway.