project

# GitHub Project Sync Bridge between Claude Code sessions and GitHub Issues/Projects. Issues are the plan — agents read them for context and update them with progress. ## Core Concept GitHub Issues replace local PLAN.md files. Each issue contains: - Scope and constraints - Task breakdown (checkboxes) - Design decisions and rationale - Implementation notes (via comments) - Linked commits and PRs This means project context is **shared, versioned, and visible** to every team member and their agents — not locked in local handoff files. ## Actions ### Check current issue (auto on session start) Detect the current branch and find its linked issue: ```bash # Get current branch BRANCH=$(git branch --show-current) # Extract issue number from branch name (e.g., feat/123-description, fix/42-title) ISSUE_NUM=$(echo "$BRANCH" | grep -oE '[0-9]+' | head -1) # Read the issue for context if [[ -n "$ISSUE_NUM" ]]; then gh issue view "$ISSUE_NUM" --comments fi ``` If an issue is found, present a brief summary: - Issue title and status - Task checklist progress (X/Y completed) - Most recent comment (latest context) - Assigned labels and milestone ### Update issue with progress After completing work or at session end: ```bash # Add a progress comment gh issue comment ISSUE_NUM --body "## Progress Update ### Completed - [x] Task description - [x] Another task ### Files Modified - \`path/to/file.ts\` — description of change ### Notes Any decisions made or context for next sessio...