Triage Process
Step 1: Classify the Issue
Read the issue title and description to determine the category:
| Category |
Labels |
Indicators |
| Data Correction |
data-correction |
"wrong", "incorrect", "outdated", "fix coordinates" |
| Data Addition |
data-addition |
"add", "missing", "new city/state", "not in database" |
| Bug Report |
bug |
"error", "crash", "not working", "broken" |
| Feature Request |
enhancement |
"would be nice", "please add", "feature", "suggestion" |
| Question |
question |
"how to", "is it possible", "what is", "?" |
| Documentation |
documentation |
"docs", "readme", "instructions", "guide" |
Step 2: Add Entity Labels
If the issue involves specific data entities, add:
data:cities - for city-related issuesdata:states - for state-related issuesdata:countries - for country-related issues
Step 3: Assess Severity
| Severity |
Label |
Criteria |
| Critical |
critical |
Country/state deletion, widespread data corruption |
| High |
priority:high |
Many cities affected, coordinate errors for major cities |
| Normal |
(no label) |
Individual city corrections, small additions |
| Low |
priority:low |
Cosmetic changes, optional field additions |
Step 4: Determine Action
Auto-fixable issues (label auto-fix, assign to @copilot):
- Simple coordinate corrections with source provided
- Missing optional fields that can be looked up
- Formatting issues in existing data
- Single record corrections with clear correct values
Needs contributor (label help-wanted):
- Large data additions requiring local knowledge
- Corrections without source documentation
- Issues in regions/countries where verification is difficult
Needs maintainer (assign to @dr5hn):
- Schema changes
- API-related issues
- Infrastructure/tooling issues
- State or country level changes
- Policy decisions
Step 5: Respond to the Issue
For data corrections:
Thanks for reporting this! I've classified this as a data correction for [entity type].
[If auto-fixable]: I'll work on a fix for this. A PR will be opened shortly.
[If needs contributor]: Would you like to submit a PR with this fix? Here's how:
1. Edit the relevant file in `contributions/` directory
2. Submit a PR with a link to an official source
You can also use our [CSC Update Tool](https://manager.countrystatecity.in/) for a guided process.
For data additions:
Thanks for requesting this addition!
To help us process this, please provide:
- The data in JSON format with required fields
- A link to an official source
- The number of records
Refer to our [Contribution Guidelines](https://github.com/dr5hn/countries-states-cities-database/blob/master/.github/CONTRIBUTING.md) for the required fields.
For bug reports:
Thanks for reporting this bug. I've tagged it for review.
[If additional info needed]: Could you please provide:
- Steps to reproduce
- Expected vs actual behaviour
- Which platform/tool you're using (API, JSON files, npm package)
Important Rules
- Always be polite and welcoming
- Do not close issues without maintainer approval
- Do not make promises about timelines
- For API issues, direct users to api@countrystatecity.in
- For urgent data issues, apply the
priority:high label
1---2name: triage-issue3description: Triage and classify new issues for the CSC database repository. Use this skill whenever an issue is opened, assigned to you, or needs classification. Trigger on: new issue triage, "classify this issue", "what type of issue is this", labelling requests, issue assignment, data correction reports, data addition requests, bug reports, feature requests, or any time you need to categorise, label, prioritise, or respond to a GitHub issue. Also use when deciding whether an issue can be auto-fixed or needs human intervention.4---56## Triage Process78### Step 1: Classify the Issue910Read the issue title and description to determine the category:1112| Category | Labels | Indicators |13|----------|--------|------------|14| Data Correction | `data-correction` | "wrong", "incorrect", "outdated", "fix coordinates" |15| Data Addition | `data-addition` | "add", "missing", "new city/state", "not in database" |16| Bug Report | `bug` | "error", "crash", "not working", "broken" |17| Feature Request | `enhancement` | "would be nice", "please add", "feature", "suggestion" |18| Question | `question` | "how to", "is it possible", "what is", "?" |19| Documentation | `documentation` | "docs", "readme", "instructions", "guide" |2021### Step 2: Add Entity Labels2223If the issue involves specific data entities, add:24- `data:cities` - for city-related issues25- `data:states` - for state-related issues26- `data:countries` - for country-related issues2728### Step 3: Assess Severity2930| Severity | Label | Criteria |31|----------|-------|----------|32| Critical | `critical` | Country/state deletion, widespread data corruption |33| High | `priority:high` | Many cities affected, coordinate errors for major cities |34| Normal | (no label) | Individual city corrections, small additions |35| Low | `priority:low` | Cosmetic changes, optional field additions |3637### Step 4: Determine Action3839**Auto-fixable issues** (label `auto-fix`, assign to @copilot):40- Simple coordinate corrections with source provided41- Missing optional fields that can be looked up42- Formatting issues in existing data43- Single record corrections with clear correct values4445**Needs contributor** (label `help-wanted`):46- Large data additions requiring local knowledge47- Corrections without source documentation48- Issues in regions/countries where verification is difficult4950**Needs maintainer** (assign to @dr5hn):51- Schema changes52- API-related issues53- Infrastructure/tooling issues54- State or country level changes55- Policy decisions5657### Step 5: Respond to the Issue5859For data corrections:60```61Thanks for reporting this! I've classified this as a data correction for [entity type].6263[If auto-fixable]: I'll work on a fix for this. A PR will be opened shortly.64[If needs contributor]: Would you like to submit a PR with this fix? Here's how:651. Edit the relevant file in `contributions/` directory662. Submit a PR with a link to an official source6768You can also use our [CSC Update Tool](https://manager.countrystatecity.in/) for a guided process.69```7071For data additions:72```73Thanks for requesting this addition!7475To help us process this, please provide:76- The data in JSON format with required fields77- A link to an official source78- The number of records7980Refer to our [Contribution Guidelines](https://github.com/dr5hn/countries-states-cities-database/blob/master/.github/CONTRIBUTING.md) for the required fields.81```8283For bug reports:84```85Thanks for reporting this bug. I've tagged it for review.8687[If additional info needed]: Could you please provide:88- Steps to reproduce89- Expected vs actual behaviour90- Which platform/tool you're using (API, JSON files, npm package)91```9293## Important Rules9495- Always be polite and welcoming96- Do not close issues without maintainer approval97- Do not make promises about timelines98- For API issues, direct users to api@countrystatecity.in99- For urgent data issues, apply the `priority:high` label
dr5hn