Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions .claude/command-templates/create-issue.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
name: create-issue
description: Create GitHub issue with intelligent type detection and template selection
---

# Create GitHub Issue

I'll help you create a GitHub issue with the appropriate template and context.

{{ INJECT:procedures/github-issue-creation.md }}

## Request Analysis

Please provide:
1. **What you want to create an issue for**
2. **Any specific details or context**
3. **Whether this is for dotfiles or another repository**

I'll:
- Auto-detect the issue type
- Suggest the best template
- Link relevant procedures
- Include appropriate labels

What would you like to create an issue for?
1 change: 1 addition & 0 deletions knowledge/ai-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Your starting point for understanding and working with this dotfiles repository.
- Apply [Tracer Bullets](principles/tracer-bullets.md) - Iterative development

### Handle GitHub Tasks
- Create issues with [GitHub Issue Creation](procedures/github-issue-creation.md) - Smart template selection
- See [Issue to PR Workflow](procedures/issue-to-pr-workflow.md) - High-level flow
- Follow [Close Issue Procedure](procedures/close-issue-procedure.md) - Detailed steps
- Use GitHub MCP server for all GitHub operations
Expand Down
56 changes: 56 additions & 0 deletions knowledge/procedures/github-issue-creation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# GitHub Issue Creation

Intelligent issue creation that auto-detects type, suggests templates, and links relevant procedures.

## When to Use This

When users request "create a GitHub issue for..." or need to document a new task, bug, or enhancement.

## Decision Tree

1. **Analyze the request** to determine issue type:
- Bug report β†’ Use bug template
- Feature request β†’ Use feature template
- MCP tool error β†’ Use mcp-tool-error template
- Procedure documentation β†’ Use procedure-documentation template
- General enhancement β†’ Use enhancement template

2. **Scan for keywords** to link relevant procedures:
- "MCP" β†’ Link MCP-related procedures
- "worktree" β†’ Link worktree-workflow
- "retro" β†’ Link post-pr-mini-retro
- "git" β†’ Link git-workflow

3. **Auto-populate context**:
- Related principles from knowledge/principles/
- Existing procedures that might help
- Recent similar issues (if any)

## Template Mapping

| Request Contains | Suggested Template | Key Fields |
|-----------------|-------------------|------------|
| "error", "fails", "broken", "bug" | issue.md (bug report) | Steps to reproduce, expected behavior |
| "feature", "add", "implement", "enhance" | issue.md (enhancement) | Problem statement, proposed solution |
| "mcp__git", "mcp__github", "tool error" | mcp-tool-error.md | Tool name, error message, reproduction |
| "procedure", "document process", "ghost" | procedure-documentation.md | Procedure name, steps, trigger |
| General request | issue.md | Flexible format for any issue type |

## Available Templates

- **issue.md** - General purpose template for bugs, features, questions
- **mcp-tool-error.md** - Specific to MCP tool failures (auto-assigns)
- **procedure-documentation.md** - For capturing ghost procedures

## Implementation

Use `mcp__github__create_issue` with:
- Appropriate labels based on type
- Cross-referenced procedures in body
- Clear title following conventions
- Assignee if specified

## See Also

- [Issue to PR Workflow](issue-to-pr-workflow.md)
- [Close Issue Procedure](close-issue-procedure.md)