doomscrum

name	doomscrum
description	Operate DoomScrum from this repo: run the swipe-feed server, generate local feed renders, check dispatch readiness, and garbage-collect generated state. Use when asked to operate, diagnose, or clean up DoomScrum itself. Trigger: /doomscrum.

DoomScrum

DoomScrum turns repo backlog specs into a swipeable video feed. Right swipes launch real coding agents and can open real PRs, so preserve the consent model: do not dispatch on the operator's behalf unless the task explicitly authorizes it. Left swipe is skip-first and must not mutate the source spec.

Read VISION.md, AGENTS.md, and docs/FIVE_FACES.md before changing product direction. Use the Rust CLI as the control surface; assets/index.html is the only sanctioned non-Rust product surface.

Core verbs

Serve

cargo run --release -- serve

Default URL: http://127.0.0.1:4173. Bind a non-loopback host only on a trusted network; the feed can dispatch real agents and spend render budget.

Generate

cargo run --release -- generate --provider fake

Use fake for normal iteration: it is offline, free, and does not egress. Anything that spends fal.ai money or uses --profile content belongs to the project render-feed skill and needs explicit operator approval.

Doctor

cargo run --release -- doctor

Run this before claiming dispatch readiness. It checks agent auth, GitHub auth, repo git state, origin remote, and configured keys.

Garbage collect

cargo run --release -- gc --dry-run
cargo run --release -- gc

Use --dry-run first. GC preserves source specs and render provenance, prunes terminal dispatch worktrees by policy, and rotates the events ledger.

Useful reads

cargo run --release -- report
cargo run --release -- egress

report summarizes specs, renders, dispatch receipts, failures, and spend. egress prints the runtime data-egress disclosure.

Gate

cargo run --bin doomscrum-ci

Behavior changes need a failing test first. Do not lower fmt, clippy, tests, or wallet/consent gates to get green.