Workflows
Maintainer workflow
The default posture is silence. You opt into context. The repo stays calm.
The mirrored loop
Each step on the right is what you see in the repo; the matching step on the left is what the contributor is doing privately via MCP at the same point.
Miner
What the contributor does
Maintainer
What the repo owner sees
- PlanThe contributor pulls a private decision pack via MCP — lane fit, repo targets, ranked next actions. Nothing is posted to your repo.What miners seePlanDefault posture is silence. No always-on public check runs, no score numbers, no labels on non-confirmed-miner PRs.Privacy boundary
- AnalyzeMetadata-only branch analysis runs locally. Source code stays on the contributor's machine.Branch analysis referenceAnalyzeOn confirmed-miner PRs, request the maintainer packet on demand — no background scanning of your repo.Maintainer packet API
httpGET /v1/repos/:owner/:repo/pulls/:number/maintainer-packet - PreflightThe contributor sees branch blockers, account/queue blockers, and maintainer-fit notes before opening the PR.Common blockersPreflightYou can ask for the same reviewability view in the PR thread.Upstream drift
@gittensory preflight @gittensory blockers @gittensory duplicate-check - PacketThe contributor opens the PR with a public-safe packet — clean description, no private scoring language.PR packet formatPacketAt most one sticky sanitized comment and one configured label per confirmed-miner PR. Pull richer context on demand via the API.Install the GitHub App
httpGET /v1/repos/:owner/:repo/pulls/:number/reviewability GET /v1/repos/:owner/:repo/registration-readiness
On-demand commands
Maintainers (and only maintainers) can trigger context with a comment. Output is scoped to maintainer-visible packets when appropriate.
@gittensory help
@gittensory preflight
@gittensory blockers
@gittensory duplicate-check
@gittensory miner-context
@gittensory next-actionPublic-facing comments are sanitized before they leave the Worker. Private scoring, reward, and risk language never appears in the PR thread.