From 1feaffa7473539c6b77a27d110302767cbe0dcfa Mon Sep 17 00:00:00 2001 From: inigo Date: Thu, 4 Sep 2025 17:00:14 -0700 Subject: [PATCH] Update issue templates Co-Authored-By: Claude --- .github/ISSUE_TEMPLATE/bug_report.md | 34 ---- .github/ISSUE_TEMPLATE/bug_report.yml | 188 ++++++++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 17 ++ .github/ISSUE_TEMPLATE/documentation.yml | 117 +++++++++++ .github/ISSUE_TEMPLATE/feature_request.yml | 132 +++++++++++++ .github/ISSUE_TEMPLATE/model_behavior.yml | 220 +++++++++++++++++++++ 6 files changed, 674 insertions(+), 34 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/documentation.yml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml create mode 100644 .github/ISSUE_TEMPLATE/model_behavior.yml diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index 67b80ecf..00000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -name: Bug report -about: Create a report to help us improve -title: '[BUG] ' -labels: bug -assignees: '' ---- - -## Environment -- Platform (select one): - - [ ] Anthropic API - - [ ] AWS Bedrock - - [ ] Google Vertex AI - - [ ] Other: -- Claude CLI version: -- Operating System: -- Terminal: - -## Bug Description - - -## Steps to Reproduce -1. -2. -3. - -## Expected Behavior - - -## Actual Behavior - - -## Additional Context - \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 00000000..fce2b87e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,188 @@ +name: 🐛 Bug Report +description: Report a bug or unexpected behavior in Claude Code +title: "[BUG] " +labels: + - bug +body: + - type: markdown + attributes: + value: | + Thanks for taking the time to report this bug! Please fill out the sections below to help us understand and fix the issue. + + Before submitting, please check: + - You're using the [latest version](https://www.npmjs.com/package/@anthropic-ai/claude-code?activeTab=versions) of Claude Code (`claude --version`) + - This issue hasn't already been reported by searching [existing issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20state%3Aopen%20label%3Abug). + - This is a bug, not a feature request or support question + + - type: checkboxes + id: preflight + attributes: + label: Preflight Checklist + description: Please confirm before submitting + options: + - label: I have searched [existing issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20state%3Aopen%20label%3Abug) and this hasn't been reported yet + required: true + - label: This is a single bug report (please file separate reports for different bugs) + required: true + - label: I am using the latest version of Claude Code + required: true + + - type: textarea + id: actual + attributes: + label: What's Wrong? + description: Describe what's happening that shouldn't be + placeholder: | + When I try to create a Python file, Claude shows an error "EACCES: permission denied" and the file isn't created. + + The command fails immediately after accepting the file write permission... + validations: + required: true + + - type: textarea + id: expected + attributes: + label: What Should Happen? + description: Describe the expected behavior + placeholder: Claude should create a Python script file successfully without errors + validations: + required: true + + - type: textarea + id: error_output + attributes: + label: Error Messages/Logs + description: If you see any error messages, paste them here + placeholder: | + Paste any error output, stack traces, or relevant logs here. + This will be automatically formatted as code. + render: shell + validations: + required: false + + - type: textarea + id: reproduction + attributes: + label: Steps to Reproduce + description: | + Please provide clear, numbered steps that anyone can follow to reproduce the issue. + **Important**: Include any necessary code, file contents, or context needed to reproduce the bug. + If the issue involves specific files or code, please create a minimal example. + placeholder: | + 1. Create a file `test.py` with this content: + ```python + def hello(): + print("test") + ``` + 2. Run `claude "add type hints to test.py"` + 3. When prompted for file access, accept + 4. Error appears: "Unable to parse..." + + Note: The bug only happens with Python files containing... + validations: + required: true + + - type: dropdown + id: model + attributes: + label: Claude Model + description: Which model were you using? (Run `/model` to check) + options: + - Sonnet (default) + - Opus + - Not sure / Multiple models + - Other + validations: + required: false + + - type: dropdown + id: regression + attributes: + label: Is this a regression? + description: Did this work in a previous version? + options: + - "Yes, this worked in a previous version" + - "No, this never worked" + - "I don't know" + validations: + required: true + + - type: input + id: working_version + attributes: + label: Last Working Version + description: If this is a regression, which version last worked? This helps expedite a fix. + placeholder: "e.g., 1.0.100" + validations: + required: false + + - type: input + id: version + attributes: + label: Claude Code Version + description: Run `claude --version` and paste the output + placeholder: "e.g., 1.0.123 (Claude Code)" + validations: + required: true + + - type: dropdown + id: platform + attributes: + label: Platform + description: Which API platform are you using? + options: + - Anthropic API + - AWS Bedrock + - Google Vertex AI + - Other + validations: + required: true + + - type: dropdown + id: os + attributes: + label: Operating System + options: + - macOS + - Windows + - Ubuntu/Debian Linux + - Other Linux + - Other + validations: + required: true + + - type: dropdown + id: terminal + attributes: + label: Terminal/Shell + description: Which terminal are you using? + options: + - Terminal.app (macOS) + - Warp + - Cursor + - iTerm2 + - IntelliJ IDEA terminal + - VS Code integrated terminal + - PyCharm terminal + - Windows Terminal + - PowerShell + - WSL (Windows Subsystem for Linux) + - Xterm + - Non-interactive/CI environment + - Other + validations: + required: true + + - type: textarea + id: additional + attributes: + label: Additional Information + description: | + Anything else that might help us understand the issue? + - Screenshots (drag and drop images here) + - Configuration files + - Related files or code + - Links to repositories demonstrating the issue + placeholder: Any additional context, screenshots, or information... + validations: + required: false \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..ad58e8eb --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,17 @@ +blank_issues_enabled: false +contact_links: + - name: 💬 Discord Community + url: https://anthropic.com/discord + about: Get help, ask questions, and chat with other Claude Code users + - name: 📖 Documentation + url: https://docs.anthropic.com/en/docs/claude-code + about: Read the official documentation and guides + - name: 🎓 Getting Started Guide + url: https://docs.anthropic.com/en/docs/claude-code/getting-started + about: New to Claude Code? Start here + - name: 🔧 Troubleshooting Guide + url: https://docs.anthropic.com/en/docs/claude-code/troubleshooting + about: Common issues and how to fix them + - name: 💡 Discussions + url: https://github.com/anthropics/claude-code/discussions + about: Share ideas, tips, and chat with maintainers \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml new file mode 100644 index 00000000..ead68fe3 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.yml @@ -0,0 +1,117 @@ +name: 📚 Documentation Issue +description: Report missing, unclear, or incorrect documentation +title: "[DOCS] " +labels: + - documentation +body: + - type: markdown + attributes: + value: | + ## Help us improve our documentation! + + Good documentation is crucial for a great developer experience. Please let us know what's missing or confusing. + + - type: dropdown + id: doc_type + attributes: + label: Documentation Type + description: What kind of documentation issue is this? + options: + - Missing documentation (feature not documented) + - Unclear/confusing documentation + - Incorrect/outdated documentation + - Typo or formatting issue + - Missing code examples + - Broken links + - Other + validations: + required: true + + - type: input + id: location + attributes: + label: Documentation Location + description: Where did you encounter this issue? Provide a URL if possible + placeholder: "e.g., https://docs.anthropic.com/en/docs/claude-code/getting-started" + validations: + required: false + + - type: input + id: section + attributes: + label: Section/Topic + description: Which specific section or topic needs improvement? + placeholder: "e.g., MCP Server Configuration section" + validations: + required: true + + - type: textarea + id: current + attributes: + label: Current Documentation + description: | + What does the documentation currently say? + Quote the specific text if applicable. + placeholder: | + The docs currently say: + "To configure MCP servers, add them to your configuration..." + + But it doesn't explain... + validations: + required: false + + - type: textarea + id: issue + attributes: + label: What's Wrong or Missing? + description: Explain what's incorrect, unclear, or missing + placeholder: | + The documentation doesn't explain how to: + - Configure multiple MCP servers + - Handle authentication + - Debug connection issues + + The example code doesn't work because... + validations: + required: true + + - type: textarea + id: suggested + attributes: + label: Suggested Improvement + description: How should the documentation be improved? Provide suggested text if possible + placeholder: | + The documentation should include: + + 1. A complete example showing... + 2. Explanation of common errors like... + 3. Step-by-step guide for... + + Suggested text: + "To configure multiple MCP servers, create an array in your settings..." + validations: + required: true + + - type: dropdown + id: impact + attributes: + label: Impact + description: How much does this documentation issue affect users? + options: + - High - Prevents users from using a feature + - Medium - Makes feature difficult to understand + - Low - Minor confusion or inconvenience + validations: + required: true + + - type: textarea + id: additional + attributes: + label: Additional Context + description: | + - Screenshots showing the issue + - Links to related documentation + - Examples from other projects that do this well + placeholder: Any additional information that would help... + validations: + required: false \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 00000000..2fa6ca24 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,132 @@ +name: ✨ Feature Request +description: Suggest a new feature or enhancement for Claude Code +title: "[FEATURE] " +labels: + - enhancement +body: + - type: markdown + attributes: + value: | + ## Thanks for suggesting a feature! + + We love hearing ideas from our community. Please help us understand your use case by filling out the sections below. + Before submitting, please check if this feature has already been requested. + + - type: checkboxes + id: preflight + attributes: + label: Preflight Checklist + options: + - label: I have searched [existing requests](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20label%3Aenhancement) and this feature hasn't been requested yet + required: true + - label: This is a single feature request (not multiple features) + required: true + + - type: textarea + id: problem + attributes: + label: Problem Statement + description: | + What problem are you trying to solve? Why do you need this feature? + Focus on the problem, not the solution. Help us understand your workflow. + placeholder: | + I often need to work with multiple projects simultaneously, but Claude Code doesn't support... + + When I'm debugging code, I find it difficult to... + + The current workflow requires me to manually... + validations: + required: true + + - type: textarea + id: solution + attributes: + label: Proposed Solution + description: | + How would you like this to work? Describe the ideal user experience. + Be specific about how you'd interact with this feature. + placeholder: | + I'd like to be able to run `claude --workspace project1,project2` to... + + There should be a command or setting that allows... + + The interface should show... + validations: + required: true + + - type: textarea + id: alternatives + attributes: + label: Alternative Solutions + description: | + What alternatives have you considered or tried? + Are there workarounds you're currently using? + placeholder: | + I've tried using multiple terminal windows but... + + Currently I work around this by... + + Other tools solve this by... + validations: + required: false + + - type: dropdown + id: priority + attributes: + label: Priority + description: How important is this feature to your workflow? + options: + - Critical - Blocking my work + - High - Significant impact on productivity + - Medium - Would be very helpful + - Low - Nice to have + validations: + required: true + + - type: dropdown + id: category + attributes: + label: Feature Category + description: What area does this feature relate to? + options: + - CLI commands and flags + - Interactive mode (TUI) + - File operations + - API and model interactions + - MCP server integration + - Performance and speed + - Configuration and settings + - Developer tools/SDK + - Documentation + - Other + validations: + required: true + + - type: textarea + id: use_case + attributes: + label: Use Case Example + description: | + Provide a concrete, real-world example of when you'd use this feature. + Walk us through a scenario step-by-step. + placeholder: | + Example scenario: + 1. I'm working on a React app with a Node.js backend + 2. I need to make changes to both frontend and backend + 3. With this feature, I could... + 4. This would save me time because... + validations: + required: false + + - type: textarea + id: additional + attributes: + label: Additional Context + description: | + - Screenshots or mockups of the proposed feature + - Links to similar features in other tools + - Technical considerations or constraints + - Any other relevant information + placeholder: Add any other context, mockups, or examples here... + validations: + required: false \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/model_behavior.yml b/.github/ISSUE_TEMPLATE/model_behavior.yml new file mode 100644 index 00000000..9c89de4b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/model_behavior.yml @@ -0,0 +1,220 @@ +name: 🤖 Model Behavior Issue +description: Report unexpected Claude model behavior, incorrect actions, or permission violations +title: "[MODEL] " +labels: + - model +body: + - type: markdown + attributes: + value: | + ## Report Unexpected Model Behavior + + Use this template when Claude does something unexpected, makes unwanted changes, or behaves inconsistently with your instructions. + + **This is for:** Unexpected actions, file modifications outside scope, ignoring instructions, making assumptions + **NOT for:** Crashes, API errors, or installation issues (use Bug Report instead) + + - type: checkboxes + id: preflight + attributes: + label: Preflight Checklist + description: Please confirm before submitting + options: + - label: I have searched [existing issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20state%3Aopen%20label%3Amodel) for similar behavior reports + required: true + - label: This report does NOT contain sensitive information (API keys, passwords, etc.) + required: true + + - type: dropdown + id: behavior_type + attributes: + label: Type of Behavior Issue + description: What category best describes the unexpected behavior? + options: + - Claude modified files I didn't ask it to modify + - Claude accessed files outside the working directory + - Claude ignored my instructions or configuration + - Claude reverted/undid previous changes without asking + - Claude made incorrect assumptions about my project + - Claude refused a reasonable request + - Claude's behavior changed between sessions + - Subagent behaved unexpectedly + - Other unexpected behavior + validations: + required: true + + - type: textarea + id: what_you_asked + attributes: + label: What You Asked Claude to Do + description: Provide the exact prompt or command you gave + placeholder: | + I asked: "Update the README.md file to add installation instructions" + + Or I ran: `claude "fix the bug in auth.js"` + validations: + required: true + + - type: textarea + id: what_claude_did + attributes: + label: What Claude Actually Did + description: Describe step-by-step what Claude did instead + placeholder: | + 1. Claude read README.md + 2. Instead of updating it, Claude deleted the entire file + 3. Created a new README from scratch with different content + 4. Also modified package.json without being asked + 5. Changed .gitignore file + validations: + required: true + + - type: textarea + id: expected_behavior + attributes: + label: Expected Behavior + description: What should Claude have done? + placeholder: | + Claude should have: + 1. Read the existing README.md + 2. Added an "Installation" section + 3. Only modified that single file + 4. Not touched any other files + validations: + required: true + + - type: textarea + id: files_affected + attributes: + label: Files Affected + description: | + List all files that were accessed or modified (even if you didn't expect them to be) + placeholder: | + Modified: + - README.md (deleted and recreated) + - package.json (version bumped - not requested) + - .gitignore (added entries - not requested) + + Read (unexpectedly): + - /Users/me/.ssh/config + - ../../../parent-directory/secrets.env + render: shell + validations: + required: false + + - type: dropdown + id: permission_mode + attributes: + label: Permission Mode + description: What permission settings were active? + options: + - Accept Edits was ON (auto-accepting changes) + - Accept Edits was OFF (manual approval required) + - I don't know / Not sure + validations: + required: true + + - type: dropdown + id: reproducible + attributes: + label: Can You Reproduce This? + description: Does this happen consistently? + options: + - Yes, every time with the same prompt + - Sometimes (intermittent) + - No, only happened once + - Haven't tried to reproduce + validations: + required: true + + - type: textarea + id: reproduction_steps + attributes: + label: Steps to Reproduce + description: If reproducible, provide minimal steps + placeholder: | + 1. Create a new directory with a simple README.md + 2. Ask Claude Code to "improve the README" + 3. Claude will delete and recreate the file instead of editing + validations: + required: false + + - type: dropdown + id: model + attributes: + label: Claude Model + description: Which model were you using? (Run `/model` to check) + options: + - Sonnet + - Opus + - Haiku + - Not sure + - Other + validations: + required: true + + - type: textarea + id: conversation_log + attributes: + label: Relevant Conversation + description: | + Include relevant parts of Claude's responses, especially where it explains what it's doing + placeholder: | + Claude said: "I'll help you update the README. Let me first delete the old one and create a fresh version..." + + [Then proceeded to delete without asking for confirmation] + render: markdown + validations: + required: false + + - type: dropdown + id: impact + attributes: + label: Impact + description: How severe was the impact of this behavior? + options: + - Critical - Data loss or corrupted project + - High - Significant unwanted changes + - Medium - Extra work to undo changes + - Low - Minor inconvenience + validations: + required: true + + - type: input + id: version + attributes: + label: Claude Code Version + description: Run `claude --version` and paste the output + placeholder: "e.g., 1.0.123 (Claude Code)" + validations: + required: true + + - type: dropdown + id: platform + attributes: + label: Platform + description: Which API platform are you using? + options: + - Anthropic API + - AWS Bedrock + - Google Vertex AI + - Other + validations: + required: true + + - type: textarea + id: additional + attributes: + label: Additional Context + description: | + - Any patterns you've noticed + - Similar behavior in other sessions + - Specific file types or project structures that trigger this + - Screenshots if relevant + placeholder: | + This seems to happen more often with: + - Python projects + - When there are multiple similar files + - After long conversations + validations: + required: false \ No newline at end of file