Skip to main content

Ticket & PR conventions

Tickets​

  • Prefer platform-specific issues on clubhouse-league-ios and clubhouse-league-android, or mirrored pairs when the feature is shared.
  • Every feature ticket should link the relevant Product journey / feature page (or embed the locked PRD).
  • Anthony reviews each feature with Morgan before tickets are filed; Remy holds tickets until ready to disburse.
  • Assignees on GitHub: Remy owns the queue. Kit/Dex receive work only via Remy’s disbursement.
  • File via the Feature / work ticket issue form (blank issues disabled). Title tip: [auth] … (or rely on feature:* labels).

Always (required on every Issue)​

Every open Issue on iOS and Android must have:

FieldRule
AssigneeActive worker. While held in queue → PL-Remy. After disbursement → Kit (iOS) / Dex (Android) (or other active worker).
Platform labelios or android
feature:* labelOne of feature:auth, feature:leagues, feature:draft, feature:roster, feature:matchups, feature:scoring, feature:waivers
type:* labelOne of type:feat, type:fix, type:chore, type:docs
OwnershipExactly one of held-by-remy or disbursed
Acceptance + runbook linksAcceptance checklist in the body; journey URL + feature page URL (runbook)
Linked PRsImplementation PRs linked to the Issue (Closing keywords or Development sidebar)

Usually (strongly preferred)​

FieldRule
MilestoneSprint / release milestone when one exists
PriorityP0 / P1 / P2
Blocked-byLinked blocker Issue/PR when blocked
Twin issueSibling platform Issue URL (ios ↔ android)

Issue forms on both mobile repos collect these fields. A small Actions workflow applies matching labels from the form dropdowns on open/edit.

Pull requests​

  • Conventional Commits.
  • Empty starters only until designs/PRDs exist for a feature.
  • Remy reviews before merge on mobile.
  • Runbook doc PRs: Remy reviews; Mira owns docs chrome/theme; Morgan owns product copy.
  • Delete the remote branch on merge (standing rule).

Repos​

RepoPurpose
pocket-labs-org/clubhouse-league-iosNative iOS (Swift/SwiftUI)
pocket-labs-org/clubhouse-league-androidNative Android (Kotlin/Compose)
pocket-labs-org/clubhouse-league-runbookThis Docusaurus runbook