π« Toolkit to help you get started with SDD or any other process!
feat: add GitHub issue templates (#1655)
Manfred Riem68d1d3a0fcda
diff --git a/.github/ISSUE_TEMPLATE/agent_request.yml b/.github/ISSUE_TEMPLATE/agent_request.ymlnew file mode 100644index 000000000..a72dacda5--- /dev/null+++ b/.github/ISSUE_TEMPLATE/agent_request.yml@@ -0,0 +1,141 @@+name: Agent Request+description: Request support for a new AI agent/assistant in Spec Kit+title: "[Agent]: Add support for "+labels: ["agent-request", "enhancement", "needs-triage"]+body:+ - type: markdown+ attributes:+ value: |+ Thanks for requesting a new agent! Before submitting, please check if the agent is already supported.++ **Currently supported agents**: Claude Code, Gemini CLI, GitHub Copilot, Cursor, Qwen Code, opencode, Codex CLI, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy, Qoder CLI, Amazon Q Developer CLI, Amp, SHAI, IBM Bob, Antigravity++ - type: input+ id: agent-name+ attributes:+ label: Agent Name+ description: What is the name of the AI agent/assistant?+ placeholder: "e.g., SuperCoder AI"+ validations:+ required: true++ - type: input+ id: website+ attributes:+ label: Official Website+ description: Link to the agent's official website or documentation+ placeholder: "https://..."+ validations:+ required: true++ - type: dropdown+ id: agent-type+ attributes:+ label: Agent Type+ description: How is the agent accessed?+ options:+ - CLI tool (command-line interface)+ - IDE extension/plugin+ - Both CLI and IDE+ - Other+ validations:+ required: true++ - type: input+ id: cli-command+ attributes:+ label: CLI Command (if applicable)+ description: What command is used to invoke the agent from terminal?+ placeholder: "e.g., supercode, ai-assistant"++ - type: input+ id: install-method+ attributes:+ label: Installation Method+ description: How is the agent installed?+ placeholder: "e.g., npm install -g supercode, pip install supercode, IDE marketplace"+ validations:+ required: true++ - type: textarea+ id: command-structure+ attributes:+ label: Command/Workflow Structure+ description: How does the agent define custom commands or workflows?+ placeholder: |+ - Command file format (Markdown, YAML, TOML, etc.)+ - Directory location (e.g., .supercode/commands/)+ - Example command file structure+ validations:+ required: true++ - type: textarea+ id: argument-pattern+ attributes:+ label: Argument Passing Pattern+ description: How does the agent handle arguments in commands?+ placeholder: |+ e.g., Uses {{args}}, $ARGUMENTS, %ARGS%, or other placeholder format+ Example: "Run test suite with {{args}}"++ - type: dropdown+ id: popularity+ attributes:+ label: Popularity/Usage+ description: How widely is this agent used?+ options:+ - Widely used (thousands+ of users)+ - Growing adoption (hundreds of users)+ - New/emerging (less than 100 users)+ - Unknown+ validations:+ required: true++ - type: textarea+ id: documentation+ attributes:+ label: Documentation Links+ description: Links to relevant documentation for custom commands/workflows+ placeholder: |+ - Command documentation: https://...+ - API/CLI reference: https://...+ - Examples: https://...++ - type: textarea+ id: use-case+ attributes:+ label: Use Case+ description: Why do you want this agent supported in Spec Kit?+ placeholder: Explain your workflow and how this agent fits into your development process+ validations:+ required: true++ - type: textarea+ id: example-command+ attributes:+ label: Example Command File+ description: If possible, provide an example of a command file for this agent+ render: markdown+ placeholder: |+ ```toml+ description = "Example command"+ prompt = "Do something with {{args}}"+ ```++ - type: checkboxes+ id: contribution+ attributes:+ label: Contribution+ description: Are you willing to help implement support for this agent?+ options:+ - label: I can help test the integration+ - label: I can provide example command files+ - label: I can help with documentation+ - label: I can submit a pull request for the integration++ - type: textarea+ id: context+ attributes:+ label: Additional Context+ description: Any other relevant information about this agent+ placeholder: Screenshots, community links, comparison to existing agents, etc.diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.ymlnew file mode 100644index 000000000..20adb6c3f--- /dev/null+++ b/.github/ISSUE_TEMPLATE/bug_report.yml@@ -0,0 +1,118 @@+name: Bug Report+description: Report a bug or unexpected behavior in Specify CLI or Spec Kit+title: "[Bug]: "+labels: ["bug", "needs-triage"]+body:+ - type: markdown+ attributes:+ value: |+ Thanks for taking the time to report a bug! Please fill out the sections below to help us diagnose and fix the issue.++ - type: textarea+ id: description+ attributes:+ label: Bug Description+ description: A clear and concise description of what the bug is.+ placeholder: What went wrong?+ validations:+ required: true++ - type: textarea+ id: reproduce+ attributes:+ label: Steps to Reproduce+ description: Steps to reproduce the behavior+ placeholder: |+ 1. Run command '...'+ 2. Execute script '...'+ 3. See error+ validations:+ required: true++ - type: textarea+ id: expected+ attributes:+ label: Expected Behavior+ description: What did you expect to happen?+ placeholder: Describe the expected outcome+ validations:+ required: true++ - type: textarea+ id: actual+ attributes:+ label: Actual Behavior+ description: What actually happened?+ placeholder: Describe what happened instead+ validations:+ required: true++ - type: input+ id: version+ attributes:+ label: Specify CLI Version+ description: "Run `specify --version` or `pip show spec-kit`"+ placeholder: "e.g., 1.3.0"+ validations:+ required: true++ - type: dropdown+ id: ai-agent+ attributes:+ label: AI Agent+ description: Which AI agent are you using?+ options:+ - Claude Code+ - Gemini CLI+ - GitHub Copilot+ - Cursor+ - Qwen Code+ - opencode+ - Codex CLI+ - Windsurf+ - Kilo Code+ - Auggie CLI+ - Roo Code+ - CodeBuddy+ - Qoder CLI+ - Amazon Q Developer CLI+ - Amp+ - SHAI+ - IBM Bob+ - Antigravity+ - Not applicable+ validations:+ required: true++ - type: input+ id: os+ attributes:+ label: Operating System+ description: Your operating system and version+ placeholder: "e.g., macOS 14.2, Ubuntu 22.04, Windows 11"+ validations:+ required: true++ - type: input+ id: python+ attributes:+ label: Python Version+ description: "Run `python --version` or `python3 --version`"+ placeholder: "e.g., Python 3.11.5"+ validations:+ required: true++ - type: textarea+ id: logs+ attributes:+ label: Error Logs+ description: Please paste any relevant error messages or logs+ render: shell+ placeholder: Paste error output here++ - type: textarea+ id: context+ attributes:+ label: Additional Context+ description: Add any other context about the problem+ placeholder: Screenshots, related issues, workarounds attempted, etc.diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.ymlnew file mode 100644index 000000000..c352f8626--- /dev/null+++ b/.github/ISSUE_TEMPLATE/config.yml@@ -0,0 +1,17 @@+blank_issues_enabled: false+contact_links:+ - name: π¬ General Discussion+ url: https://github.com/github/spec-kit/discussions+ about: Ask questions, share ideas, or discuss Spec-Driven Development+ - name: π Documentation+ url: https://github.com/github/spec-kit/blob/main/README.md+ about: Read the Spec Kit documentation and guides+ - name: π οΈ Extension Development Guide+ url: https://github.com/manfredseee/spec-kit/blob/main/extensions/EXTENSION-DEVELOPMENT-GUIDE.md+ about: Learn how to develop and publish Spec Kit extensions+ - name: π€ Contributing Guide+ url: https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md+ about: Learn how to contribute to Spec Kit+ - name: π Security Issues+ url: https://github.com/github/spec-kit/blob/main/SECURITY.md+ about: Report security vulnerabilities privatelydiff --git a/.github/ISSUE_TEMPLATE/extension_submission.yml b/.github/ISSUE_TEMPLATE/extension_submission.ymlnew file mode 100644index 000000000..d298925e7--- /dev/null+++ b/.github/ISSUE_TEMPLATE/extension_submission.yml@@ -0,0 +1,280 @@+name: Extension Submission+description: Submit your extension to the Spec Kit catalog+title: "[Extension]: Add "+labels: ["extension-submission", "enhancement", "needs-triage"]+body:+ - type: markdown+ attributes:+ value: |+ Thanks for contributing an extension! This template helps you submit your extension to the community catalog.++ **Before submitting:**+ - Review the [Extension Publishing Guide](https://github.com/github/spec-kit/blob/main/extensions/EXTENSION-PUBLISHING-GUIDE.md)+ - Ensure your extension has a valid `extension.yml` manifest+ - Create a GitHub release with a version tag (e.g., v1.0.0)+ - Test installation: `specify extension add --from <your-release-url>`++ - type: input+ id: extension-id+ attributes:+ label: Extension ID+ description: Unique extension identifier (lowercase with hyphens only)+ placeholder: "e.g., jira-integration"+ validations:+ required: true++ - type: input+ id: extension-name+ attributes:+ label: Extension Name+ description: Human-readable extension name+ placeholder: "e.g., Jira Integration"+ validations:+ required: true++ - type: input+ id: version+ attributes:+ label: Version+ description: Semantic version number+ placeholder: "e.g., 1.0.0"+ validations:+ required: true++ - type: textarea+ id: description+ attributes:+ label: Description+ description: Brief description of what your extension does (under 200 characters)+ placeholder: Integrates Jira issue tracking with Spec Kit workflows for seamless task management+ validations:+ required: true++ - type: input+ id: author+ attributes:+ label: Author+ description: Your name or organization+ placeholder: "e.g., John Doe or Acme Corp"+ validations:+ required: true++ - type: input+ id: repository+ attributes:+ label: Repository URL+ description: GitHub repository URL for your extension+ placeholder: "https://github.com/your-org/spec-kit-your-extension"+ validations:+ required: true++ - type: input+ id: download-url+ attributes:+ label: Download URL+ description: URL to the GitHub release archive (e.g., v1.0.0.zip)+ placeholder: "https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip"+ validations:+ required: true++ - type: input+ id: license+ attributes:+ label: License+ description: Open source license type+ placeholder: "e.g., MIT, Apache-2.0"+ validations:+ required: true++ - type: input+ id: homepage+ attributes:+ label: Homepage (optional)+ description: Link to extension homepage or documentation site+ placeholder: "https://..."++ - type: input+ id: documentation+ attributes:+ label: Documentation URL (optional)+ description: Link to detailed documentation+ placeholder: "https://github.com/your-org/spec-kit-your-extension/blob/main/docs/"++ - type: input+ id: changelog+ attributes:+ label: Changelog URL (optional)+ description: Link to changelog file+ placeholder: "https://github.com/your-org/spec-kit-your-extension/blob/main/CHANGELOG.md"++ - type: input+ id: speckit-version+ attributes:+ label: Required Spec Kit Version+ description: Minimum Spec Kit version required+ placeholder: "e.g., >=0.1.0"+ validations:+ required: true++ - type: textarea+ id: required-tools+ attributes:+ label: Required Tools (optional)+ description: List any external tools or dependencies required+ placeholder: |+ - jira-cli (>=1.0.0) - required+ - python (>=3.8) - optional+ render: markdown++ - type: input+ id: commands-count+ attributes:+ label: Number of Commands+ description: How many commands does your extension provide?+ placeholder: "e.g., 3"+ validations:+ required: true++ - type: input+ id: hooks-count+ attributes:+ label: Number of Hooks (optional)+ description: How many hooks does your extension provide?+ placeholder: "e.g., 0"++ - type: textarea+ id: tags+ attributes:+ label: Tags+ description: 2-5 relevant tags (lowercase, separated by commas)+ placeholder: "issue-tracking, jira, atlassian, automation"+ validations:+ required: true++ - type: textarea+ id: features+ attributes:+ label: Key Features+ description: List the main features and capabilities of your extension+ placeholder: |+ - Create Jira issues from specs+ - Sync task status with Jira+ - Link specs to existing issues+ - Generate Jira reports+ validations:+ required: true++ - type: checkboxes+ id: testing+ attributes:+ label: Testing Checklist+ description: Confirm that your extension has been tested+ options:+ - label: Extension installs successfully via download URL+ required: true+ - label: All commands execute without errors+ required: true+ - label: Documentation is complete and accurate+ required: true+ - label: No security vulnerabilities identified+ required: true+ - label: Tested on at least one real project+ required: true++ - type: checkboxes+ id: requirements+ attributes:+ label: Submission Requirements+ description: Verify your extension meets all requirements+ options:+ - label: Valid `extension.yml` manifest included+ required: true+ - label: README.md with installation and usage instructions+ required: true+ - label: LICENSE file included+ required: true+ - label: GitHub release created with version tag+ required: true+ - label: All command files exist and are properly formatted+ required: true+ - label: Extension ID follows naming conventions (lowercase-with-hyphens)+ required: true++ - type: textarea+ id: testing-details+ attributes:+ label: Testing Details+ description: Describe how you tested your extension+ placeholder: |+ **Tested on:**+ - macOS 14.0 with Spec Kit v0.1.0+ - Linux Ubuntu 22.04 with Spec Kit v0.1.0++ **Test project:** [Link or description]++ **Test scenarios:**+ 1. Installed extension+ 2. Configured settings+ 3. Ran all commands+ 4. Verified outputs+ validations:+ required: true++ - type: textarea+ id: example-usage+ attributes:+ label: Example Usage+ description: Provide a simple example of using your extension+ render: markdown+ placeholder: |+ ```bash+ # Install extension+ specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip++ # Use a command+ /speckit.your-extension.command-name arg1 arg2+ ```+ validations:+ required: true++ - type: textarea+ id: catalog-entry+ attributes:+ label: Proposed Catalog Entry+ description: Provide the JSON entry for catalog.json (helps reviewers)+ render: json+ placeholder: |+ {+ "your-extension": {+ "name": "Your Extension",+ "id": "your-extension",+ "description": "Brief description",+ "author": "Your Name",+ "version": "1.0.0",+ "download_url": "https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip",+ "repository": "https://github.com/your-org/spec-kit-your-extension",+ "homepage": "https://github.com/your-org/spec-kit-your-extension",+ "license": "MIT",+ "requires": {+ "speckit_version": ">=0.1.0"+ },+ "provides": {+ "commands": 3+ },+ "tags": ["category", "tool"],+ "verified": false,+ "downloads": 0,+ "stars": 0,+ "created_at": "2026-02-20T00:00:00Z",+ "updated_at": "2026-02-20T00:00:00Z"+ }+ }+ validations:+ required: true++ - type: textarea+ id: additional-context+ attributes:+ label: Additional Context+ description: Any other information that would help reviewers+ placeholder: Screenshots, demo videos, links to related projects, etc.diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.ymlnew file mode 100644index 000000000..71786ddce--- /dev/null+++ b/.github/ISSUE_TEMPLATE/feature_request.yml@@ -0,0 +1,104 @@+name: Feature Request+description: Suggest a new feature or enhancement for Specify CLI or Spec Kit+title: "[Feature]: "+labels: ["enhancement", "needs-triage"]+body:+ - type: markdown+ attributes:+ value: |+ Thanks for suggesting a feature! Please provide details below to help us understand and evaluate your request.++ - type: textarea+ id: problem+ attributes:+ label: Problem Statement+ description: Is your feature request related to a problem? Please describe.+ placeholder: "I'm frustrated when..."+ validations:+ required: true++ - type: textarea+ id: solution+ attributes:+ label: Proposed Solution+ description: Describe the solution you'd like+ placeholder: What would you like to happen?+ validations:+ required: true++ - type: textarea+ id: alternatives+ attributes:+ label: Alternatives Considered+ description: Have you considered any alternative solutions or workarounds?+ placeholder: What other approaches might work?++ - type: dropdown+ id: component+ attributes:+ label: Component+ description: Which component does this feature relate to?+ options:+ - Specify CLI (initialization, commands)+ - Spec templates (BDD, Testing Strategy, etc.)+ - Agent integrations (command files, workflows)+ - Scripts (Bash/PowerShell utilities)+ - Documentation+ - CI/CD workflows+ - Other+ validations:+ required: true++ - type: dropdown+ id: ai-agent+ attributes:+ label: AI Agent (if applicable)+ description: Does this feature relate to a specific AI agent?+ options:+ - All agents+ - Claude Code+ - Gemini CLI+ - GitHub Copilot+ - Cursor+ - Qwen Code+ - opencode+ - Codex CLI+ - Windsurf+ - Kilo Code+ - Auggie CLI+ - Roo Code+ - CodeBuddy+ - Qoder CLI+ - Amazon Q Developer CLI+ - Amp+ - SHAI+ - IBM Bob+ - Antigravity+ - Not applicable++ - type: textarea+ id: use-cases+ attributes:+ label: Use Cases+ description: Describe specific use cases where this feature would be valuable+ placeholder: |+ 1. When working on large projects...+ 2. During spec review...+ 3. When integrating with CI/CD...++ - type: textarea+ id: acceptance+ attributes:+ label: Acceptance Criteria+ description: How would you know this feature is complete and working?+ placeholder: |+ - [ ] Feature does X+ - [ ] Documentation is updated+ - [ ] Works with all supported agents++ - type: textarea+ id: context+ attributes:+ label: Additional Context+ description: Add any other context, screenshots, or examples+ placeholder: Links to similar features, mockups, related discussions, etc.