github-create

Create GitHub Issue from Increment

Create a GitHub issue for the specified SpecWeave increment.

⛔ MANDATORY: Sync Living Docs BEFORE Creating Issue

GitHub issue content is generated FROM living docs. If living docs don't exist or are stale, the issue will be incomplete.

You MUST run sw:sync-specs BEFORE creating (unless using sw:sync-progress):

# STEP 1: Ensure living docs exist and are current
sw:sync-specs <increment-id>

# STEP 2: Then create GitHub issue
sw-github:create <increment-id>

Why?

• Issue body is generated from .specweave/docs/internal/specs/FS-XXX/
• User stories and ACs come from living docs
• Task checklist reflects living docs structure
• Without sync-specs, issue will be created from raw increment spec.md (less structured)

Note: sw:sync-progress calls sync-specs automatically before creating issues.

---

Usage: sw-github:create <increment-id>

sw:github:create-issue <increment-id> [options]

Arguments

• increment-id: Increment ID (e.g., 0004 or 0004-plugin-architecture)

Options

• --force: Force create even if issue already exists
• --labels: Comma-separated labels (default: from config)
• --milestone: Milestone name (default: from config)
• --assignee: Assign to user (@username)
• --project: Add to GitHub project (project number)

Examples

# Basic usage
sw:github:create-issue 0004

# With custom labels
sw:github:create-issue 0004 --labels "urgent,backend"

# Assign to developer
sw:github:create-issue 0004 --assignee @developer1

# Add to project
sw:github:create-issue 0004 --project 3

# Force recreate
sw:github:create-issue 0004 --force

What This Command Does

1. Loads Increment

   • Reads .specweave/increments/<increment-id>/
   • Parses spec.md, plan.md, tasks.md
   • Checks .metadata.yaml for existing issue

2. Detects Repository

   • Extracts repo from git remote
   • Format: owner/repo
   • Verifies write permissions