Nxs Gh Create Epic

GitHub Epic Issue Creator

Create a GitHub issue from an Epic document's content and link it back to the epic.

Prerequisites

• GitHub CLI (gh) installed and authenticated
• Running within a git repository connected to GitHub

Workflow

1. Locate the Epic document from user reference, open file, or argument
2. Run the script to create the issue and update frontmatter:

python ./scripts/nxs_gh_create_epic.py "<path-to-epic.md>"

Optional Flags

Examples

# Basic usage (auto-discovers project from repo)
python ./scripts/nxs_gh_create_epic.py "<path-to-epic.md>"

# Specify target project explicitly
python ./scripts/nxs_gh_create_epic.py --project "acme-corp/backend-roadmap" "<path-to-epic.md>"

# Skip confirmation for existing links
python ./scripts/nxs_gh_create_epic.py -y "<path-to-epic.md>"

# Create issue without adding to any project
python ./scripts/nxs_gh_create_epic.py --no-project "<path-to-epic.md>"

Script Behavior

The script (./scripts/nxs_gh_create_epic.py):

1. Parses YAML frontmatter for epic (title) and type (label, defaults to "epic")
2. Creates temp file with markdown body (frontmatter stripped)
3. Executes gh issue create --title "<epic>" --label "<type>" --body-file <temp>
4. Extracts issue number from returned URL
5. Adds the issue to the specified project (or auto-discovered project)
6. Updates frontmatter with link: "#<issue-number>"
7. Cleans up temp file

Expected Frontmatter

---
feature: "Feature Name"
epic: "Epic Title" # Required - becomes issue title
created: 2025-01-02
status: draft
type: enhancement # Optional - becomes GitHub label (default: "epic")
---

After execution, link: "#123" is added to frontmatter.

Error Handling