# Issue Tracker: GitHub

Issues and PRDs for this repo live in GitHub Issues for `tidbcloud/controlplane9`. Use the `gh` CLI from inside this repository so it can infer the repo from `git remote -v`.

## Conventions

- Create an issue: `gh issue create --title "..." --body "..."`
- Read an issue: `gh issue view <number> --comments`
- List issues: `gh issue list --state open --json number,title,body,labels,comments`
- Comment on an issue: `gh issue comment <number> --body "..."`
- Apply or remove labels: `gh issue edit <number> --add-label "..."` or `--remove-label "..."`
- Close an issue: `gh issue close <number> --comment "..."`

## Skill Contract

When a skill says "publish to the issue tracker", create a GitHub issue. When a skill says "fetch the relevant ticket", use `gh issue view <number> --comments`.