Update issue templates

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
inigo
2025-09-04 17:00:14 -07:00
parent 7127181c79
commit 1feaffa747
6 changed files with 674 additions and 34 deletions

View File

@@ -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: <!-- specify -->
- Claude CLI version: <!-- output of `claude --version` -->
- Operating System: <!-- e.g. macOS 14.3, Windows 11, Ubuntu 22.04 -->
- Terminal: <!-- e.g. iTerm2, Terminal App -->
## Bug Description
<!-- A clear and concise description of the bug -->
## Steps to Reproduce
1. <!-- First step -->
2. <!-- Second step -->
3. <!-- And so on... -->
## Expected Behavior
<!-- What you expected to happen -->
## Actual Behavior
<!-- What actually happened -->
## Additional Context
<!-- Add any other context about the problem here, such as screenshots, logs, etc. -->

188
.github/ISSUE_TEMPLATE/bug_report.yml vendored Normal file
View File

@@ -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

17
.github/ISSUE_TEMPLATE/config.yml vendored Normal file
View File

@@ -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

117
.github/ISSUE_TEMPLATE/documentation.yml vendored Normal file
View File

@@ -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

View File

@@ -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

View File

@@ -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