spacehub

surshar / claude-code

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

Built by Anthropic · github.com/anthropics

Merge pull request #7180 from anthropics/inigo/issue-templatesBrowse files
Update issue templates
bogini authored on Sep 5, 2025 · GitHub committed on Sep 5, 2025 parents 72042e9 + 1feaffa · commit 3404b075ecc6
6 changed files+674 -34compared with 72042e9
D.github/ISSUE_TEMPLATE/bug_report.md
A.github/ISSUE_TEMPLATE/bug_report.yml
A.github/ISSUE_TEMPLATE/config.yml
A.github/ISSUE_TEMPLATE/documentation.yml
A.github/ISSUE_TEMPLATE/feature_request.yml
A.github/ISSUE_TEMPLATE/model_behavior.yml
D.github/ISSUE_TEMPLATE/bug_report.md+0 -34
@@ -1,34 +1,0 @@
1----
2-name: Bug report
3-about: Create a report to help us improve
4-title: '[BUG] '
5-labels: bug
6-assignees: ''
7----
8-
9-## Environment
10-- Platform (select one):
11- - [ ] Anthropic API
12- - [ ] AWS Bedrock
13- - [ ] Google Vertex AI
14- - [ ] Other: <!-- specify -->
15-- Claude CLI version: <!-- output of `claude --version` -->
16-- Operating System: <!-- e.g. macOS 14.3, Windows 11, Ubuntu 22.04 -->
17-- Terminal: <!-- e.g. iTerm2, Terminal App -->
18-
19-## Bug Description
20-<!-- A clear and concise description of the bug -->
21-
22-## Steps to Reproduce
23-1. <!-- First step -->
24-2. <!-- Second step -->
25-3. <!-- And so on... -->
26-
27-## Expected Behavior
28-<!-- What you expected to happen -->
29-
30-## Actual Behavior
31-<!-- What actually happened -->
32-
33-## Additional Context
34-<!-- Add any other context about the problem here, such as screenshots, logs, etc. -->
@@ -1,0 +1,188 @@
1+name: 🐛 Bug Report
2+description: Report a bug or unexpected behavior in Claude Code
3+title: "[BUG] "
4+labels:
5+ - bug
6+body:
7+ - type: markdown
8+ attributes:
9+ value: |
10+ Thanks for taking the time to report this bug! Please fill out the sections below to help us understand and fix the issue.
11+
12+ Before submitting, please check:
13+ - You're using the [latest version](https://www.npmjs.com/package/@anthropic-ai/claude-code?activeTab=versions) of Claude Code (`claude --version`)
14+ - 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).
15+ - This is a bug, not a feature request or support question
16+
17+ - type: checkboxes
18+ id: preflight
19+ attributes:
20+ label: Preflight Checklist
21+ description: Please confirm before submitting
22+ options:
23+ - 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
24+ required: true
25+ - label: This is a single bug report (please file separate reports for different bugs)
26+ required: true
27+ - label: I am using the latest version of Claude Code
28+ required: true
29+
30+ - type: textarea
31+ id: actual
32+ attributes:
33+ label: What's Wrong?
34+ description: Describe what's happening that shouldn't be
35+ placeholder: |
36+ When I try to create a Python file, Claude shows an error "EACCES: permission denied" and the file isn't created.
37+
38+ The command fails immediately after accepting the file write permission...
39+ validations:
40+ required: true
41+
42+ - type: textarea
43+ id: expected
44+ attributes:
45+ label: What Should Happen?
46+ description: Describe the expected behavior
47+ placeholder: Claude should create a Python script file successfully without errors
48+ validations:
49+ required: true
50+
51+ - type: textarea
52+ id: error_output
53+ attributes:
54+ label: Error Messages/Logs
55+ description: If you see any error messages, paste them here
56+ placeholder: |
57+ Paste any error output, stack traces, or relevant logs here.
58+ This will be automatically formatted as code.
59+ render: shell
60+ validations:
61+ required: false
62+
63+ - type: textarea
64+ id: reproduction
65+ attributes:
66+ label: Steps to Reproduce
67+ description: |
68+ Please provide clear, numbered steps that anyone can follow to reproduce the issue.
69+ **Important**: Include any necessary code, file contents, or context needed to reproduce the bug.
70+ If the issue involves specific files or code, please create a minimal example.
71+ placeholder: |
72+ 1. Create a file `test.py` with this content:
73+ ```python
74+ def hello():
75+ print("test")
76+ ```
77+ 2. Run `claude "add type hints to test.py"`
78+ 3. When prompted for file access, accept
79+ 4. Error appears: "Unable to parse..."
80+
81+ Note: The bug only happens with Python files containing...
82+ validations:
83+ required: true
84+
85+ - type: dropdown
86+ id: model
87+ attributes:
88+ label: Claude Model
89+ description: Which model were you using? (Run `/model` to check)
90+ options:
91+ - Sonnet (default)
92+ - Opus
93+ - Not sure / Multiple models
94+ - Other
95+ validations:
96+ required: false
97+
98+ - type: dropdown
99+ id: regression
100+ attributes:
101+ label: Is this a regression?
102+ description: Did this work in a previous version?
103+ options:
104+ - "Yes, this worked in a previous version"
105+ - "No, this never worked"
106+ - "I don't know"
107+ validations:
108+ required: true
109+
110+ - type: input
111+ id: working_version
112+ attributes:
113+ label: Last Working Version
114+ description: If this is a regression, which version last worked? This helps expedite a fix.
115+ placeholder: "e.g., 1.0.100"
116+ validations:
117+ required: false
118+
119+ - type: input
120+ id: version
121+ attributes:
122+ label: Claude Code Version
123+ description: Run `claude --version` and paste the output
124+ placeholder: "e.g., 1.0.123 (Claude Code)"
125+ validations:
126+ required: true
127+
128+ - type: dropdown
129+ id: platform
130+ attributes:
131+ label: Platform
132+ description: Which API platform are you using?
133+ options:
134+ - Anthropic API
135+ - AWS Bedrock
136+ - Google Vertex AI
137+ - Other
138+ validations:
139+ required: true
140+
141+ - type: dropdown
142+ id: os
143+ attributes:
144+ label: Operating System
145+ options:
146+ - macOS
147+ - Windows
148+ - Ubuntu/Debian Linux
149+ - Other Linux
150+ - Other
151+ validations:
152+ required: true
153+
154+ - type: dropdown
155+ id: terminal
156+ attributes:
157+ label: Terminal/Shell
158+ description: Which terminal are you using?
159+ options:
160+ - Terminal.app (macOS)
161+ - Warp
162+ - Cursor
163+ - iTerm2
164+ - IntelliJ IDEA terminal
165+ - VS Code integrated terminal
166+ - PyCharm terminal
167+ - Windows Terminal
168+ - PowerShell
169+ - WSL (Windows Subsystem for Linux)
170+ - Xterm
171+ - Non-interactive/CI environment
172+ - Other
173+ validations:
174+ required: true
175+
176+ - type: textarea
177+ id: additional
178+ attributes:
179+ label: Additional Information
180+ description: |
181+ Anything else that might help us understand the issue?
182+ - Screenshots (drag and drop images here)
183+ - Configuration files
184+ - Related files or code
185+ - Links to repositories demonstrating the issue
186+ placeholder: Any additional context, screenshots, or information...
187+ validations:
188+ required: false
@@ -1,0 +1,17 @@
1+blank_issues_enabled: false
2+contact_links:
3+ - name: 💬 Discord Community
4+ url: https://anthropic.com/discord
5+ about: Get help, ask questions, and chat with other Claude Code users
6+ - name: 📖 Documentation
7+ url: https://docs.anthropic.com/en/docs/claude-code
8+ about: Read the official documentation and guides
9+ - name: 🎓 Getting Started Guide
10+ url: https://docs.anthropic.com/en/docs/claude-code/getting-started
11+ about: New to Claude Code? Start here
12+ - name: 🔧 Troubleshooting Guide
13+ url: https://docs.anthropic.com/en/docs/claude-code/troubleshooting
14+ about: Common issues and how to fix them
15+ - name: 💡 Discussions
16+ url: https://github.com/anthropics/claude-code/discussions
17+ about: Share ideas, tips, and chat with maintainers
@@ -1,0 +1,117 @@
1+name: 📚 Documentation Issue
2+description: Report missing, unclear, or incorrect documentation
3+title: "[DOCS] "
4+labels:
5+ - documentation
6+body:
7+ - type: markdown
8+ attributes:
9+ value: |
10+ ## Help us improve our documentation!
11+
12+ Good documentation is crucial for a great developer experience. Please let us know what's missing or confusing.
13+
14+ - type: dropdown
15+ id: doc_type
16+ attributes:
17+ label: Documentation Type
18+ description: What kind of documentation issue is this?
19+ options:
20+ - Missing documentation (feature not documented)
21+ - Unclear/confusing documentation
22+ - Incorrect/outdated documentation
23+ - Typo or formatting issue
24+ - Missing code examples
25+ - Broken links
26+ - Other
27+ validations:
28+ required: true
29+
30+ - type: input
31+ id: location
32+ attributes:
33+ label: Documentation Location
34+ description: Where did you encounter this issue? Provide a URL if possible
35+ placeholder: "e.g., https://docs.anthropic.com/en/docs/claude-code/getting-started"
36+ validations:
37+ required: false
38+
39+ - type: input
40+ id: section
41+ attributes:
42+ label: Section/Topic
43+ description: Which specific section or topic needs improvement?
44+ placeholder: "e.g., MCP Server Configuration section"
45+ validations:
46+ required: true
47+
48+ - type: textarea
49+ id: current
50+ attributes:
51+ label: Current Documentation
52+ description: |
53+ What does the documentation currently say?
54+ Quote the specific text if applicable.
55+ placeholder: |
56+ The docs currently say:
57+ "To configure MCP servers, add them to your configuration..."
58+
59+ But it doesn't explain...
60+ validations:
61+ required: false
62+
63+ - type: textarea
64+ id: issue
65+ attributes:
66+ label: What's Wrong or Missing?
67+ description: Explain what's incorrect, unclear, or missing
68+ placeholder: |
69+ The documentation doesn't explain how to:
70+ - Configure multiple MCP servers
71+ - Handle authentication
72+ - Debug connection issues
73+
74+ The example code doesn't work because...
75+ validations:
76+ required: true
77+
78+ - type: textarea
79+ id: suggested
80+ attributes:
81+ label: Suggested Improvement
82+ description: How should the documentation be improved? Provide suggested text if possible
83+ placeholder: |
84+ The documentation should include:
85+
86+ 1. A complete example showing...
87+ 2. Explanation of common errors like...
88+ 3. Step-by-step guide for...
89+
90+ Suggested text:
91+ "To configure multiple MCP servers, create an array in your settings..."
92+ validations:
93+ required: true
94+
95+ - type: dropdown
96+ id: impact
97+ attributes:
98+ label: Impact
99+ description: How much does this documentation issue affect users?
100+ options:
101+ - High - Prevents users from using a feature
102+ - Medium - Makes feature difficult to understand
103+ - Low - Minor confusion or inconvenience
104+ validations:
105+ required: true
106+
107+ - type: textarea
108+ id: additional
109+ attributes:
110+ label: Additional Context
111+ description: |
112+ - Screenshots showing the issue
113+ - Links to related documentation
114+ - Examples from other projects that do this well
115+ placeholder: Any additional information that would help...
116+ validations:
117+ required: false
@@ -1,0 +1,132 @@
1+name: ✨ Feature Request
2+description: Suggest a new feature or enhancement for Claude Code
3+title: "[FEATURE] "
4+labels:
5+ - enhancement
6+body:
7+ - type: markdown
8+ attributes:
9+ value: |
10+ ## Thanks for suggesting a feature!
11+
12+ We love hearing ideas from our community. Please help us understand your use case by filling out the sections below.
13+ Before submitting, please check if this feature has already been requested.
14+
15+ - type: checkboxes
16+ id: preflight
17+ attributes:
18+ label: Preflight Checklist
19+ options:
20+ - 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
21+ required: true
22+ - label: This is a single feature request (not multiple features)
23+ required: true
24+
25+ - type: textarea
26+ id: problem
27+ attributes:
28+ label: Problem Statement
29+ description: |
30+ What problem are you trying to solve? Why do you need this feature?
31+ Focus on the problem, not the solution. Help us understand your workflow.
32+ placeholder: |
33+ I often need to work with multiple projects simultaneously, but Claude Code doesn't support...
34+
35+ When I'm debugging code, I find it difficult to...
36+
37+ The current workflow requires me to manually...
38+ validations:
39+ required: true
40+
41+ - type: textarea
42+ id: solution
43+ attributes:
44+ label: Proposed Solution
45+ description: |
46+ How would you like this to work? Describe the ideal user experience.
47+ Be specific about how you'd interact with this feature.
48+ placeholder: |
49+ I'd like to be able to run `claude --workspace project1,project2` to...
50+
51+ There should be a command or setting that allows...
52+
53+ The interface should show...
54+ validations:
55+ required: true
56+
57+ - type: textarea
58+ id: alternatives
59+ attributes:
60+ label: Alternative Solutions
61+ description: |
62+ What alternatives have you considered or tried?
63+ Are there workarounds you're currently using?
64+ placeholder: |
65+ I've tried using multiple terminal windows but...
66+
67+ Currently I work around this by...
68+
69+ Other tools solve this by...
70+ validations:
71+ required: false
72+
73+ - type: dropdown
74+ id: priority
75+ attributes:
76+ label: Priority
77+ description: How important is this feature to your workflow?
78+ options:
79+ - Critical - Blocking my work
80+ - High - Significant impact on productivity
81+ - Medium - Would be very helpful
82+ - Low - Nice to have
83+ validations:
84+ required: true
85+
86+ - type: dropdown
87+ id: category
88+ attributes:
89+ label: Feature Category
90+ description: What area does this feature relate to?
91+ options:
92+ - CLI commands and flags
93+ - Interactive mode (TUI)
94+ - File operations
95+ - API and model interactions
96+ - MCP server integration
97+ - Performance and speed
98+ - Configuration and settings
99+ - Developer tools/SDK
100+ - Documentation
101+ - Other
102+ validations:
103+ required: true
104+
105+ - type: textarea
106+ id: use_case
107+ attributes:
108+ label: Use Case Example
109+ description: |
110+ Provide a concrete, real-world example of when you'd use this feature.
111+ Walk us through a scenario step-by-step.
112+ placeholder: |
113+ Example scenario:
114+ 1. I'm working on a React app with a Node.js backend
115+ 2. I need to make changes to both frontend and backend
116+ 3. With this feature, I could...
117+ 4. This would save me time because...
118+ validations:
119+ required: false
120+
121+ - type: textarea
122+ id: additional
123+ attributes:
124+ label: Additional Context
125+ description: |
126+ - Screenshots or mockups of the proposed feature
127+ - Links to similar features in other tools
128+ - Technical considerations or constraints
129+ - Any other relevant information
130+ placeholder: Add any other context, mockups, or examples here...
131+ validations:
132+ required: false
@@ -1,0 +1,220 @@
1+name: 🤖 Model Behavior Issue
2+description: Report unexpected Claude model behavior, incorrect actions, or permission violations
3+title: "[MODEL] "
4+labels:
5+ - model
6+body:
7+ - type: markdown
8+ attributes:
9+ value: |
10+ ## Report Unexpected Model Behavior
11+
12+ Use this template when Claude does something unexpected, makes unwanted changes, or behaves inconsistently with your instructions.
13+
14+ **This is for:** Unexpected actions, file modifications outside scope, ignoring instructions, making assumptions
15+ **NOT for:** Crashes, API errors, or installation issues (use Bug Report instead)
16+
17+ - type: checkboxes
18+ id: preflight
19+ attributes:
20+ label: Preflight Checklist
21+ description: Please confirm before submitting
22+ options:
23+ - label: I have searched [existing issues](https://github.com/anthropics/claude-code/issues?q=is%3Aissue%20state%3Aopen%20label%3Amodel) for similar behavior reports
24+ required: true
25+ - label: This report does NOT contain sensitive information (API keys, passwords, etc.)
26+ required: true
27+
28+ - type: dropdown
29+ id: behavior_type
30+ attributes:
31+ label: Type of Behavior Issue
32+ description: What category best describes the unexpected behavior?
33+ options:
34+ - Claude modified files I didn't ask it to modify
35+ - Claude accessed files outside the working directory
36+ - Claude ignored my instructions or configuration
37+ - Claude reverted/undid previous changes without asking
38+ - Claude made incorrect assumptions about my project
39+ - Claude refused a reasonable request
40+ - Claude's behavior changed between sessions
41+ - Subagent behaved unexpectedly
42+ - Other unexpected behavior
43+ validations:
44+ required: true
45+
46+ - type: textarea
47+ id: what_you_asked
48+ attributes:
49+ label: What You Asked Claude to Do
50+ description: Provide the exact prompt or command you gave
51+ placeholder: |
52+ I asked: "Update the README.md file to add installation instructions"
53+
54+ Or I ran: `claude "fix the bug in auth.js"`
55+ validations:
56+ required: true
57+
58+ - type: textarea
59+ id: what_claude_did
60+ attributes:
61+ label: What Claude Actually Did
62+ description: Describe step-by-step what Claude did instead
63+ placeholder: |
64+ 1. Claude read README.md
65+ 2. Instead of updating it, Claude deleted the entire file
66+ 3. Created a new README from scratch with different content
67+ 4. Also modified package.json without being asked
68+ 5. Changed .gitignore file
69+ validations:
70+ required: true
71+
72+ - type: textarea
73+ id: expected_behavior
74+ attributes:
75+ label: Expected Behavior
76+ description: What should Claude have done?
77+ placeholder: |
78+ Claude should have:
79+ 1. Read the existing README.md
80+ 2. Added an "Installation" section
81+ 3. Only modified that single file
82+ 4. Not touched any other files
83+ validations:
84+ required: true
85+
86+ - type: textarea
87+ id: files_affected
88+ attributes:
89+ label: Files Affected
90+ description: |
91+ List all files that were accessed or modified (even if you didn't expect them to be)
92+ placeholder: |
93+ Modified:
94+ - README.md (deleted and recreated)
95+ - package.json (version bumped - not requested)
96+ - .gitignore (added entries - not requested)
97+
98+ Read (unexpectedly):
99+ - /Users/me/.ssh/config
100+ - ../../../parent-directory/secrets.env
101+ render: shell
102+ validations:
103+ required: false
104+
105+ - type: dropdown
106+ id: permission_mode
107+ attributes:
108+ label: Permission Mode
109+ description: What permission settings were active?
110+ options:
111+ - Accept Edits was ON (auto-accepting changes)
112+ - Accept Edits was OFF (manual approval required)
113+ - I don't know / Not sure
114+ validations:
115+ required: true
116+
117+ - type: dropdown
118+ id: reproducible
119+ attributes:
120+ label: Can You Reproduce This?
121+ description: Does this happen consistently?
122+ options:
123+ - Yes, every time with the same prompt
124+ - Sometimes (intermittent)
125+ - No, only happened once
126+ - Haven't tried to reproduce
127+ validations:
128+ required: true
129+
130+ - type: textarea
131+ id: reproduction_steps
132+ attributes:
133+ label: Steps to Reproduce
134+ description: If reproducible, provide minimal steps
135+ placeholder: |
136+ 1. Create a new directory with a simple README.md
137+ 2. Ask Claude Code to "improve the README"
138+ 3. Claude will delete and recreate the file instead of editing
139+ validations:
140+ required: false
141+
142+ - type: dropdown
143+ id: model
144+ attributes:
145+ label: Claude Model
146+ description: Which model were you using? (Run `/model` to check)
147+ options:
148+ - Sonnet
149+ - Opus
150+ - Haiku
151+ - Not sure
152+ - Other
153+ validations:
154+ required: true
155+
156+ - type: textarea
157+ id: conversation_log
158+ attributes:
159+ label: Relevant Conversation
160+ description: |
161+ Include relevant parts of Claude's responses, especially where it explains what it's doing
162+ placeholder: |
163+ Claude said: "I'll help you update the README. Let me first delete the old one and create a fresh version..."
164+
165+ [Then proceeded to delete without asking for confirmation]
166+ render: markdown
167+ validations:
168+ required: false
169+
170+ - type: dropdown
171+ id: impact
172+ attributes:
173+ label: Impact
174+ description: How severe was the impact of this behavior?
175+ options:
176+ - Critical - Data loss or corrupted project
177+ - High - Significant unwanted changes
178+ - Medium - Extra work to undo changes
179+ - Low - Minor inconvenience
180+ validations:
181+ required: true
182+
183+ - type: input
184+ id: version
185+ attributes:
186+ label: Claude Code Version
187+ description: Run `claude --version` and paste the output
188+ placeholder: "e.g., 1.0.123 (Claude Code)"
189+ validations:
190+ required: true
191+
192+ - type: dropdown
193+ id: platform
194+ attributes:
195+ label: Platform
196+ description: Which API platform are you using?
197+ options:
198+ - Anthropic API
199+ - AWS Bedrock
200+ - Google Vertex AI
201+ - Other
202+ validations:
203+ required: true
204+
205+ - type: textarea
206+ id: additional
207+ attributes:
208+ label: Additional Context
209+ description: |
210+ - Any patterns you've noticed
211+ - Similar behavior in other sessions
212+ - Specific file types or project structures that trigger this
213+ - Screenshots if relevant
214+ placeholder: |
215+ This seems to happen more often with:
216+ - Python projects
217+ - When there are multiple similar files
218+ - After long conversations
219+ validations:
220+ required: false