Report a bug in the edge-stack plugin with structured information
Report bugs in the edge-stack plugin with structured information and create a GitHub issue. Use this when you encounter agent, command, or deployment issues that need maintainer attention.
/plugin marketplace add hirefrank/hirefrank-marketplace/plugin install edge-stack@hirefrank-marketplace<command_purpose> Report bugs encountered while using the edge-stack plugin. Gathers structured information and creates a GitHub issue for the maintainer. </command_purpose>
<role>Community Bug Reporter with structured issue creation workflow</role>
Help improve the edge-stack plugin by reporting bugs you encounter. This command guides you through a structured bug reporting process that collects all necessary information and creates a GitHub issue.
Use the AskUserQuestion tool to collect the following information:
Question 1: Bug Category
Question 2: Specific Component
Question 3: What Happened (Actual Behavior)
Question 4: What Should Have Happened (Expected Behavior)
Question 5: Steps to Reproduce
/es-deployQuestion 6: Error Messages
Question 7: Additional Context (Optional)
Run these commands to collect environment information:
# Get plugin version
PLUGIN_VERSION=$(cat ~/.claude/plugins/installed_plugins.json 2>/dev/null | grep -A5 "edge-stack" | grep "version" | head -1 | cut -d'"' -f4)
if [ -z "$PLUGIN_VERSION" ]; then
PLUGIN_VERSION="Unknown (not found in installed_plugins.json)"
fi
# Get Claude Code version
CLAUDE_VERSION=$(claude --version 2>/dev/null || echo "Claude CLI version unknown")
# Get OS info
OS_INFO=$(uname -a)
# Get Cloudflare tooling versions (if available)
WRANGLER_VERSION=$(wrangler --version 2>/dev/null || echo "Not installed")
NODE_VERSION=$(node --version 2>/dev/null || echo "Not installed")
# Get git status (if in a repo)
GIT_STATUS=$(git status --short 2>/dev/null || echo "Not a git repository or git not available")
Store the collected information in variables for use in the bug report.
Create the bug report with this structure:
## Bug Description
**Component:** [Type] - [Name]
**Category:** [Bug category from Question 1]
[Brief summary from collected information]
## Environment
- **Plugin Version:** [from plugin version check]
- **Claude Code Version:** [from claude --version]
- **Wrangler Version:** [from wrangler --version]
- **Node Version:** [from node --version]
- **OS:** [from uname -a]
## What Happened (Actual Behavior)
[Detailed description from Question 3]
## Expected Behavior
[Description from Question 4]
## Steps to Reproduce
[Numbered steps from Question 5]
## Error Messages
[Error output from Question 6, or "No error messages" if none]
## Additional Context
[Information from Question 7, or "None provided" if empty]
## Git Status (if applicable)
[Git status output, or "Not in a git repository"]
---
*Reported via `/es-report-bug` command*
Create a concise, descriptive title:
[edge-stack] Bug: [Component] - [Brief description]
Example: [edge-stack] Bug: /es-deploy - Fails with wrangler authentication error
# Create temp file with bug report content
BUG_REPORT_FILE=$(mktemp)
cat > "$BUG_REPORT_FILE" << 'EOF'
[Bug report markdown content from Step 3]
EOF
Try to create the issue with the GitHub CLI:
gh issue create \
--repo hirefrank/marketplace \
--title "[edge-stack] Bug: [Brief description]" \
--body-file "$BUG_REPORT_FILE" \
--label "bug,edge-stack"
Fallback if labels don't exist:
gh issue create \
--repo hirefrank/marketplace \
--title "[edge-stack] Bug: [Brief description]" \
--body-file "$BUG_REPORT_FILE"
Fallback if gh CLI not authenticated:
If the gh command fails with authentication error:
GitHub CLI is not authenticated. Please either:
1. Run: gh auth login
Then re-run this command
2. Or manually create an issue at:
https://github.com/hirefrank/marketplace/issues/new
And paste the bug report below:
[Display formatted bug report]
rm -f "$BUG_REPORT_FILE"
If issue created successfully:
✅ Bug report submitted successfully!
Issue: https://github.com/hirefrank/marketplace/issues/[NUMBER]
Title: [edge-stack] Bug: [description]
Thank you for helping improve the edge-stack plugin!
Frank Harris (plugin maintainer) will review your report and respond as soon as possible.
You can track the issue at the URL above and will receive notifications when there are updates.
Next Steps:
- Watch the issue for maintainer response
- Be ready to provide additional details if requested
- Check for similar issues that might be related
If manual submission required:
⚠️ Unable to create GitHub issue automatically
Please create the issue manually at:
https://github.com/hirefrank/marketplace/issues/new
Title: [edge-stack] Bug: [description]
Body:
[Display complete formatted bug report]
Thank you for taking the time to report this bug!
<error_handling> Handle common error scenarios gracefully </error_handling>
Issue: gh CLI not installed
Solution:
Error: GitHub CLI (gh) is not installed.
Please install it:
- macOS: brew install gh
- Linux: See https://github.com/cli/cli#installation
- Windows: See https://github.com/cli/cli#installation
Then run: gh auth login
After authentication, re-run /es-report-bug
Issue: Not authenticated with GitHub Solution: Display bug report and provide manual submission instructions
Issue: Repository not found or no permission Solution:
Error: Cannot access hirefrank/marketplace repository.
Please verify:
1. You have internet connectivity
2. The repository exists at github.com/hirefrank/marketplace
3. You have permission to create issues
Manual submission option:
[Display bug report and manual submission instructions]
Issue: User cancels during question flow Solution:
Bug report cancelled. No issue was created.
You can restart the bug reporting process anytime by running:
/es-report-bug
<privacy_notice> This command does NOT collect:
Only technical information about the bug is included:
<best_practices> Tips for writing effective bug reports: </best_practices>
The command produces:
/es-triage - Triage and track findings/es-issue - Create feature requests and improvements/es-review - Comprehensive code review for quality issues