github-issue-state-management

What problem does it solve?

This Skill provides a robust, centralized system for managing the state of development environments across different contexts (container-use, worktree, host) by leveraging GitHub Issues as a Single Source of Truth, thereby resolving issues with cross-environment file access and state synchronization.

Core Features & Use Cases

• Centralized State Management: Uses GitHub Issue labels and metadata to track environment status, phase, and configuration.
• Cross-Environment Consistency: Ensures a unified view of environment state accessible from any context.
• Atomic Operations: Leverages GitHub's atomic label operations to prevent race conditions.
• Use Case: When working on a feature across multiple worktrees or within a container, this Skill ensures that the status of each development environment (e.g., 'active', 'blocked', 'PR created') is consistently tracked and visible via a GitHub Issue, allowing for seamless resumption and coordination.

Quick Start

Use the github-issue-state-management skill to register a new environment for issue number 42 with ID 'abc-123', branch 'feature/auth', and type 'container-use'.