[Child of #650] Audit: Issue Fields Configuration vs. GitHub API

[ashleyshaw]

Overview

Validate that issue-fields.yml configuration is complete, correct, and aligns with GitHub's issue fields API.

Scope

• Review .github/issue-fields.yml configuration
• Verify custom fields are properly defined
• Check field mappings to GitHub API
• Verify field values match what GitHub supports
• Test field creation/update via automation

Audit Checklist

• Extract all custom fields from issue-fields.yml
• Verify field naming conventions
• Check field types (single_select, date, text, etc.)
• Verify field values are valid GitHub options
• Check field descriptions are clear and complete
• Verify required field configurations
• Test field creation via API or workflow
• Identify any deprecated or unsupported fields

Deliverables

• Issue fields validation report
• Field configuration checklist
• Any identified GitHub API misalignments
• Test results and recommendations
• Documentation updates (if needed)

Related Files

• .github/issue-fields.yml
• docs/ISSUE-FIELDS.md
• docs/ISSUE_TYPES.md

Related Documentation

• Issue Fields Guide
• GitHub API - Issue Fields
• Canonical Issue Fields

[linear-code]

LS-834