feat: add GitHub Issues Integration extension

## Summary

  Adds a community extension that generates spec artifacts from GitHub Issues, eliminating
  duplicate work between issue tracking and Specification-Driven Development (SDD).

  Resolves [#2175](github/spec-kit#2175)

  ## Problem

  Developers already document requirements in GitHub Issues (user stories, acceptance criteria,
  labels, discussions) but then rewrite everything from scratch in `spec.md` when starting SDD.
  This creates:

  - **Duplicate work** - Writing the same information twice
  - **Context loss** - Losing valuable discussion and rationale from issues
  - **Sync drift** - Issues and specs diverge over time
  - **Manual overhead** - Copying and reformatting content manually

  ## Solution

  This extension provides three commands that bridge GitHub Issues and Spec Kit:

  ### Commands

  1. **`/speckit.github-issues.import`** - Import a GitHub Issue and generate structured `spec.md`     - Fetches issue title, body, labels, and comments
     - Parses structured sections (problem, solution, alternatives)
     - Generates spec with requirements and acceptance criteria
     - Creates metadata for tracking

  2. **`/speckit.github-issues.sync`** - Keep specs updated when source issues change
     - Detects changes in linked issues
     - Updates spec with latest issue data
     - Appends new comments to Discussion Notes
     - Maintains sync timestamps

  3. **`/speckit.github-issues.link`** - Add bidirectional traceability
     - Links spec to source issue
     - Posts comment on GitHub Issue linking back to spec
     - Creates metadata file for tracking

  ## Features

  - ✅ Import GitHub Issues to structured spec.md files
  - ✅ Structured parsing of problem statements, solutions, acceptance criteria
  - ✅ Preserve valuable comments and context
  - ✅ Bidirectional links between issues and specs
  - ✅ Automatic sync when issues change
  - ✅ Label integration as spec tags
  - ✅ Issue state tracking (open/closed)

  ## Extension Details

  - **Extension ID:** `github-issues`
  - **Version:** 1.0.0
  - **Category:** `integration`
  - **Effect:** Read+Write
  - **License:** MIT
  - **Author:** @Fatima367

Author: Fatima367

.extensionignore

@@ -0,0 +1,43 @@
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Test files
+tests/
+test_*.py
+*_test.py
+
+# Development files
+.git/
+.github/
+.gitignore
+
+# Build artifacts
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+dist/
+build/
+*.egg-info/
+
+# Documentation source
+docs/source/
+docs/drafts/
+
+# Local config (users should use the template)
+*-config.yml
+!*-config.template.yml
+
+# Temporary files
+*.tmp
+*.bak
+.*.swp

CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to the GitHub Issues Integration extension will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-04-12
+
+### Added
+
+- Initial release of GitHub Issues Integration extension
+- `/speckit.github-issues.import` command to import GitHub Issues and generate spec.md
+- `/speckit.github-issues.sync` command to sync spec artifacts with issue updates
+- `/speckit.github-issues.link` command to add bidirectional traceability
+- Configuration file support for customizing behavior
+- Automatic parsing of issue sections (problem, solution, alternatives)
+- Comment preservation in spec Discussion Notes
+- Label integration as spec tags
+- Issue state tracking (open/closed)
+- Metadata file (`.issue-link`) for tracking linked issues
+- Comprehensive documentation and examples
+
+### Features
+
+- Import issues from any GitHub repository
+- Support for both `owner/repo#123` and `#123` formats
+- Automatic detection of current repository
+- Bidirectional linking between specs and issues
+- Sync detection based on issue update timestamps
+- Batch sync for all linked issues
+- Selective sync for specific features or issues
+- User confirmation before applying updates
+- Graceful error handling and permission checks
+
+[1.0.0]: https://github.com/Fatima367/spec-kit-github-issues/releases/tag/v1.0.0

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fatima367
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.