GitHub Tracker

Configuration

• Repository: arttttt/CMIDCABot
• Project: CMI DCA Bot

Content Contract (MUST follow)

All content sent to GitHub MUST comply with these rules:

Body Format

<summary in English, max 200 chars>

---
_Artifacts attached as comments below_
_Source: `<filepath>` (local, not yet in main)_

Comment Format

## Brief | Specification

<full artifact content, translated to English>

---
_Source: `<filepath>`_

Stage Flow

stage:brief  → Backlog     → /brief created
stage:spec   → Todo        → /spec created
stage:impl   → In Progress → /implement started
stage:review → Review      → /review created
(closed)     → Done        → PR merged

When to Use

• Creating GitHub Issues from artifacts
• Updating issue labels (stage transitions)
• Adding issues to Project board
• Moving issues between columns
• Querying project status

Quick Reference

Link Format

Tracker item link in artifact files:

<!-- GitHub Issue: #123 -->

Auto-close Syntax

To automatically close tracker item when PR is merged:

Closes #<number>

Status Mapping

Create Issue

Use github:issue_write with method: "create":

• owner: from Configuration
• repo: from Configuration
• title: issue title
• body: issue body
• labels: array of label names

Get Issue

Use github:issue_read with method: "get":

• owner: from Configuration
• repo: from Configuration
• issue_number: issue number

Update Labels

Use github:issue_write with method: "update":

• owner: from Configuration
• repo: from Configuration
• issue_number: issue number
• labels: new array of label names

Update Status

To update tracker item status:

1. Update label: remove old stage:*, add new stage:*
2. Move to corresponding Project column

See Status Mapping table for label/column correspondence.

Add to Project

1. list_projects to find project ID
2. get_project_fields to get Status field ID
3. add_issue_to_project to add issue
4. update_project_item_field to set column

Move Column

Use move_item_to_column with project and column name.

Detailed References

• See references/issues.md for issue operations
• See references/projects.md for project board operations