Add git-bug distributed issue tracking documentation

Document git-bug installation, CLI usage, query language, and GitHub
sync workflow in DEVELOPMENT.md.  Add AI assistant hints for using
git-bug for issue context in CLAUDE.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: yarikoptic

CLAUDE.md

@@ -35,3 +35,15 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ## Documentation
 - Keep docstrings updated when changing function signatures
 - CLI help text should be clear and include examples where appropriate
+
+## Issue Tracking with git-bug
+This project has GitHub issues synced locally via git-bug.  Use these commands
+to get issue context without needing GitHub API access:
+- `git bug ls status:open` - list open issues
+- `git bug show <id-prefix>` - show issue details and comments
+- `git bug ls "title:keyword"` - search issues by title
+- `git bug ls "label:bug"` - filter by label
+- `git bug bridge pull` - sync latest issues from GitHub
+
+When working on a bug fix or feature, check `git bug ls` for related issues
+to understand context and prior discussion.

DEVELOPMENT.md

@@ -132,6 +132,73 @@ view code coverage information as follows:
    lines based on whether they are covered by tests or not.
 
 
+## Git-bug: Local Issue Tracking
+
+This project uses [git-bug](https://github.com/git-bug/git-bug) for distributed,
+offline-first issue tracking.  Issues from GitHub are synced and stored as native
+git objects under `refs/bugs/*`, so you can browse and search them without internet
+access or GitHub API calls.
+
+### Installation
+
+Install git-bug from [releases](https://github.com/git-bug/git-bug/releases)
+or via a package manager:
+
+    # macOS/Linux (Homebrew)
+    brew install git-bug
+
+    # Nix
+    nix profile install nixpkgs#git-bug
+
+    # Binary download (Linux amd64)
+    curl -L -o git-bug \
+        https://github.com/git-bug/git-bug/releases/latest/download/git-bug_linux_amd64
+    chmod +x git-bug && mv git-bug ~/.local/bin/
+
+### Fetching Issues
+
+After cloning, fetch the bug refs to get local issues:
+
+    git bug pull
+
+### Quick Reference
+
+    # List open issues
+    git bug ls status:open
+
+    # Show a specific issue (by ID prefix)
+    git bug show <id-prefix>
+
+    # Search issues by title keyword
+    git bug ls status:open "title:upload"
+
+    # Filter by label
+    git bug ls "label:bug"
+
+    # Filter by author
+    git bug ls "author:username"
+
+    # Newest first
+    git bug ls status:open sort:creation-desc
+
+### Syncing with GitHub
+
+    # Pull latest issues from GitHub
+    git bug bridge pull
+
+    # Push local bug refs to remote (for team access)
+    git bug push origin
+
+### Known Limitations
+
+- **Images/media**: Bridge importers preserve image URLs as markdown text but
+  do not download image blobs.  Images hosted on
+  `user-images.githubusercontent.com` are accessible only while GitHub hosts
+  them.
+- **Two-way sync**: While git-bug supports pushing changes back to GitHub,
+  the primary workflow is pull-from-GitHub for offline access.
+
+
 ## Releasing with GitHub Actions, auto, and pull requests
 
 New releases of dandi-cli are created via a GitHub Actions workflow built