Core concepts
Scoreability
Gittensory projects how scoreable your branch is under several scenarios. These are estimates, never guarantees.
The six scenarios
- Current gated — what's scoreable right now, given all current gates.
- Underlying potential — the upper bound implied by the work itself, ignoring gates.
- Clean-gate — what becomes scoreable if branch hygiene issues are resolved.
- After-pending-merges — projection assuming pending related PRs merge.
- Linked-issue-fixed — projection assuming the linked issue is closed cleanly.
- Best reasonable case — the realistic upper bound across known cleanups.
Language rules
Use scoreability, estimated score, underlying potential, and risk-adjusted priority. Never say guaranteed payout, guaranteed reward, or anything implying outcome guarantees.
Example shape
{
"scoreability": {
"current_gated": 0.42,
"underlying_potential": 0.83,
"clean_gate": 0.71,
"after_pending_merges": 0.66,
"linked_issue_fixed": 0.78,
"best_reasonable": 0.83
},
"blockers": ["unsquashed-commits", "missing-issue-link"],
"risk_adjusted_priority": 0.61
}jsonScoreability numbers and risk language are private. They appear only in MCP/API responses. They are never written to public GitHub surfaces.