Ticket & PR conventions
Tickets
- Prefer platform-specific issues on
clubhouse-league-iosandclubhouse-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 onfeature:*labels).
Always (required on every Issue)
Every open Issue on iOS and Android must have:
| Field | Rule |
|---|---|
| Assignee | Active worker. While held in queue → PL-Remy. After disbursement → Kit (iOS) / Dex (Android) (or other active worker). |
| Platform label | ios or android |
| feature:* label | One of feature:auth, feature:leagues, feature:draft, feature:roster, feature:matchups, feature:scoring, feature:waivers |
| type:* label | One of type:feat, type:fix, type:chore, type:docs |
| Ownership | Exactly one of held-by-remy or disbursed |
| Acceptance + runbook links | Acceptance checklist in the body; journey URL + feature page URL (runbook) |
| Linked PRs | Implementation PRs linked to the Issue (Closing keywords or Development sidebar) |
Usually (strongly preferred)
| Field | Rule |
|---|---|
| Milestone | Sprint / release milestone when one exists |
| Priority | P0 / P1 / P2 |
| Blocked-by | Linked blocker Issue/PR when blocked |
| Twin issue | Sibling 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
| Repo | Purpose |
|---|---|
pocket-labs-org/clubhouse-league-ios | Native iOS (Swift/SwiftUI) |
pocket-labs-org/clubhouse-league-android | Native Android (Kotlin/Compose) |
pocket-labs-org/clubhouse-league-runbook | This Docusaurus runbook |