create-issues

# Create GitHub Issues Execute automated GitHub issue creation workflow for $ARGUMENTS following TDD principles and conventional commit standards. ## Context - Current git status: !`git status` - Current branch: !`git branch --show-current` - Open issues: !`gh issue list --state open --limit 10` - GitHub authentication: !`gh auth status` ## Requirements Summary Follow TDD principles, conventional commits, and protected branch workflows. Use proper labels, auto-closing keywords, and atomic commits. See `references/requirements.md` for complete standards. ## Phase 1: Repository Analysis **Goal**: Assess repository state, detect templates, and determine issue scope and type. **Actions**: 1. Analyze current branch from context (main/develop vs PR branch) 2. Review open issues to identify duplicates or related work 3. Check for contributing guidelines (`CONTRIBUTING.md`) and follow its requirements 4. Detect issue templates in `.github/ISSUE_TEMPLATE/` directory 5. If templates exist: select appropriate template using `gh issue create --list` 6. Determine issue type (epic, PR-scoped, or review) based on `$ARGUMENTS` complexity 7. Apply branch-based decision logic from `references/decision-logic.md` See `references/repository-templates.md` for template detection and compliance details. ## Phase 2: Issue Creation **Goal**: Create GitHub issue with proper structure, labels, and links. **Actions**: 1. Create or verify required priority labels exist (see `references/decision-logic.md` for commands) 2. Draft issue following structure requirements in `references/issue-structure.md` 3. Apply appropriate labels (priority, type) using `--label` - Assign owners using `--assignee` - Link milestones using `--milestone` or projects using `--project` if requested 4. Add auto-closing keywords if PR-scoped issue (NOT for epics) - **CRITICAL: auto-closing keywords only fire when the PR merges into the repository's default branch.** If the issue will be resolved by a PR targeting a non-default branch, warn the user that the issue will NOT close automatically and must be closed manually — see `references/auto-closing-keywords.md` for the full rule and keyword table. 5. Link to related issues or epics if applicable ## Phase 3: Documentation and Handoff **Goal**: Document decisions and communicate follow-up actions. **Actions**: 1. Document branch strategy decision and rationale 2. Report created issue number and URL to user 3. If on PR branch and blocking: add detailed comment to PR instead of creating issue 4. Share next steps (create PR, assign to team member, etc.) ## References - **Requirements**: `references/requirements.md` - Full TDD and commit standards - **Decision Logic**: `references/decision-logic.md` - Branch-based decisions and issue types - **Issue Structure**: `references/issue-structure.md` - Title, labels, body, auto-closing - **Auto-Closing Keywords**: `references/auto-closing-keywords.md` - Default-branch limitation and keyword table - **Repository Templates**: `references/repository-templates.md` - Contributing guidelines and issue templates - **Examples**: `references/examples.md` - Commit message examples