Skip to content

Conversation

@kronosapiens
Copy link
Collaborator

Summary

  • Adds comprehensive specification for pairwise-preference judging system for Dojo game jams
  • Judges authenticate via Discord OAuth, must have Sensei role
  • Entries sourced from GitHub (dojoengine/game-jams repo)
  • Active ranking algorithm using Beta distribution uncertainty sampling
  • PageRank-style spectral ranking for final results
  • Minimal architecture: 1 database table, 6 API endpoints

Key Design Decisions

  • GitHub as source of truth: No local entries table, fetch entries.yaml from game-jams repo with 5-min cache
  • Stateless OAuth state: HMAC-signed tokens with 24-hour TTL, no database storage
  • Score encoding: REAL type allows future preference strength (currently binary 0.0/1.0)
  • Canonical ordering: Entry pairs stored with smaller ID first for UNIQUE constraint

Test plan

  • Review spec for completeness and clarity
  • Validate against existing REPUTATION.md and BLOCKCHAIN.md patterns

🤖 Generated with Claude Code

Comprehensive specification for pairwise-preference judging system:
- Discord OAuth with Sensei role verification
- GitHub as source of truth for entries (entries.yaml)
- Active ranking with Beta distribution uncertainty sampling
- Spectral (PageRank-style) ranking algorithm
- Minimal schema: single jam_comparisons table
- 6 API endpoints total

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@kronosapiens kronosapiens merged commit 44f2402 into main Jan 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants