GitHub Sync — BMAD to GitHub Projects v2

Bidirectional sync between BMAD planning artifacts (epics, stories, sprint plan) stored as markdown files and GitHub Projects v2 for visual project tracking.

Quick navigation

• gh CLI commands, GraphQL queries → references/gh-commands.md
• Issue body template, field mapping, labels, milestones → references/content-mapping.md
• Config file format → references/config-schema.md
• Artifact parser script → scripts/parse-artifacts.py

Four Rules (Never Break These)

1. Never sync automatically. Every mutating operation (create issues, update fields, modify files) requires generating a sync report first, presenting it to the user, and waiting for explicit approval before executing. The user must see exactly what will change.