Enforce actionable and trackable `TODO` comments

In Patrol, I have accumulated many TODO comments, and I'm not happy with their quality. I would like to be able enforce "good TODOs" - TODOs that have a link to a GitHub issue so the team doesn't lose track of them.

Examples

BAD

// TODO: set reasonable duration or create new exception for this case

// TODO(bartekpacia): set reasonable duration or create new exception for this case

// TODO(bartekpacia): set reasonable duration or create new exception for this case. See #2137

The last is wrong because it makes no sense to include username in the TODO since the person responsible for the issue will very likely be the author of the issue.

GOOD

// TODO: set reasonable duration or create new exception for this case. See https://github.com/leancodepl/patrol/issues/2137

or we could go full-minimalism style - just require the issue number:

// TODO: set reasonable duration or create new exception for this case. See #2137

To paraphrase:

• GOAL: Enforce every TODO comment to have See #<github-issue-number at the end
• GOAL: Enforce every TODO comment to not have username (e.g. `// TODO(bartekpacia): ...)
• NON GOAL: Check if the provided issue link/number is valid/exists/is really an issue (and not a PR or a discussion)

Question

I'm not sure how multiline TODOs should be treated. Should it be:

// TODO(bartekpacia): set reasonable duration or create new exception for this case
// See https://github.com/leancodepl/patrol/issues/2137

or:

// TODO(bartekpacia): set reasonable duration or create new exception for this case
// TODO(bartekpacia): See https://github.com/leancodepl/patrol/issues/2137

?

Start by reviewing the TODO examples and the stated GOAL and NON GOAL requirements. Decide how multiline TODOs should be treated, then identify the project's existing TODO enforcement entry point; done means the rules reject usernames and require an issue number or link without validating that the referenced issue exists.