From 5ba72f152e4c135c46ff1270eace56954ce79faa Mon Sep 17 00:00:00 2001 From: Manfred Riem <15701806+mnriem@users.noreply.github.com> Date: Thu, 19 Mar 2026 11:01:40 -0500 Subject: [PATCH 1/3] docs: update SUPPORT.md, fix issue templates, add preset submission template MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - SUPPORT.md: simplify structure, add Discussions link, soften response commitment - config.yml: fix broken Extension Development Guide URL (was manfredseee → github) - agent_request.yml: update agent list with Tabnine, Vibe, Kimi, Trae, Pi, iFlow - preset_submission.yml: new issue template for preset catalog submissions --- .github/ISSUE_TEMPLATE/agent_request.yml | 2 +- .github/ISSUE_TEMPLATE/config.yml | 2 +- .github/ISSUE_TEMPLATE/preset_submission.yml | 169 +++++++++++++++++++ SUPPORT.md | 13 +- 4 files changed, 177 insertions(+), 9 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/preset_submission.yml diff --git a/.github/ISSUE_TEMPLATE/agent_request.yml b/.github/ISSUE_TEMPLATE/agent_request.yml index a6ac6c4bff..37b0fea5bf 100644 --- a/.github/ISSUE_TEMPLATE/agent_request.yml +++ b/.github/ISSUE_TEMPLATE/agent_request.yml @@ -8,7 +8,7 @@ body: 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, Kiro CLI, Amp, SHAI, IBM Bob, Antigravity + **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, Kiro CLI, Amp, SHAI, Tabnine CLI, Antigravity, IBM Bob, Mistral Vibe, Kimi Code, Trae, Pi Coding Agent, iFlow CLI - type: input id: agent-name diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index c352f86260..04d1923b5b 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -7,7 +7,7 @@ contact_links: 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 + url: https://github.com/github/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 diff --git a/.github/ISSUE_TEMPLATE/preset_submission.yml b/.github/ISSUE_TEMPLATE/preset_submission.yml new file mode 100644 index 0000000000..16c8d02d79 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/preset_submission.yml @@ -0,0 +1,169 @@ +name: Preset Submission +description: Submit your preset to the Spec Kit preset catalog +title: "[Preset]: Add " +labels: ["preset-submission", "enhancement", "needs-triage"] +body: + - type: markdown + attributes: + value: | + Thanks for contributing a preset! This template helps you submit your preset to the community catalog. + + **Before submitting:** + - Review the [Preset Publishing Guide](https://github.com/github/spec-kit/blob/main/presets/PUBLISHING.md) + - Ensure your preset has a valid `preset.yml` manifest + - Create a GitHub release with a version tag (e.g., v1.0.0) + - Test installation: `specify preset add --dev ` + + - type: input + id: preset-id + attributes: + label: Preset ID + description: Unique preset identifier (lowercase with hyphens only) + placeholder: "e.g., healthcare-compliance" + validations: + required: true + + - type: input + id: preset-name + attributes: + label: Preset Name + description: Human-readable preset name + placeholder: "e.g., Healthcare Compliance" + 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 preset does (under 200 characters) + placeholder: Enforces HIPAA-compliant spec workflows with audit templates and compliance checklists + 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 preset + placeholder: "https://github.com/your-org/spec-kit-your-preset" + 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-preset/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: speckit-version + attributes: + label: Required Spec Kit Version + description: Minimum Spec Kit version required + placeholder: "e.g., >=0.3.0" + validations: + required: true + + - type: textarea + id: templates-provided + attributes: + label: Templates Provided + description: List the template overrides your preset provides + placeholder: | + - spec-template.md — adds compliance section + - plan-template.md — includes audit checkpoints + - checklist-template.md — HIPAA compliance checklist + validations: + required: true + + - type: textarea + id: commands-provided + attributes: + label: Commands Provided (optional) + description: List any command overrides your preset provides + placeholder: | + - speckit.specify.md — customized for compliance workflows + + - type: textarea + id: tags + attributes: + label: Tags + description: 2-5 relevant tags (lowercase, separated by commas) + placeholder: "compliance, healthcare, hipaa, audit" + validations: + required: true + + - type: textarea + id: features + attributes: + label: Key Features + description: List the main features and capabilities of your preset + placeholder: | + - HIPAA-compliant spec templates + - Audit trail checklists + - Compliance review workflow + validations: + required: true + + - type: checkboxes + id: testing + attributes: + label: Testing Checklist + description: Confirm that your preset has been tested + options: + - label: Preset installs successfully via `specify preset add` + required: true + - label: Template resolution works correctly after installation + required: true + - label: Documentation is complete and accurate + required: true + - label: Tested on at least one real project + required: true + + - type: checkboxes + id: requirements + attributes: + label: Submission Requirements + description: Verify your preset meets all requirements + options: + - label: Valid `preset.yml` manifest included + required: true + - label: README.md with description and usage instructions + required: true + - label: LICENSE file included + required: true + - label: GitHub release created with version tag + required: true + - label: Preset ID follows naming conventions (lowercase-with-hyphens) + required: true diff --git a/SUPPORT.md b/SUPPORT.md index c6acf76e05..308abae92b 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -1,18 +1,17 @@ # Support -## How to file issues and get help +## How to get help -This project uses GitHub issues to track bugs and feature requests. Please search the existing issues before filing new issues to avoid duplicates. For new issues, file your bug or feature request as a new issue. +Please search existing [issues](https://github.com/github/spec-kit/issues) and [discussions](https://github.com/github/spec-kit/discussions) before creating new ones to avoid duplicates. -For help or questions about using this project, please: - -- Open a [GitHub issue](https://github.com/github/spec-kit/issues/new) for bug reports, feature requests, or questions about the Spec-Driven Development methodology -- Check the [comprehensive guide](./spec-driven.md) for detailed documentation on the Spec-Driven Development process - Review the [README](./README.md) for getting started instructions and troubleshooting tips +- Check the [comprehensive guide](./spec-driven.md) for detailed documentation on the Spec-Driven Development process +- Ask in [GitHub Discussions](https://github.com/github/spec-kit/discussions) for questions about using Spec Kit or the Spec-Driven Development methodology +- Open a [GitHub issue](https://github.com/github/spec-kit/issues/new) for bug reports and feature requests ## Project Status -**Spec Kit** is under active development and maintained by GitHub staff **AND THE COMMUNITY**. We will do our best to respond to support, feature requests, and community questions in a timely manner. +**Spec Kit** is under active development and maintained by GitHub staff and the community. We will do our best to respond to support, feature requests, and community questions as time permits. ## GitHub Support Policy From 4482a0855167a885cc3a5f72f68ffb14cb15b28f Mon Sep 17 00:00:00 2001 From: Manfred Riem <15701806+mnriem@users.noreply.github.com> Date: Thu, 19 Mar 2026 11:43:40 -0500 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .github/ISSUE_TEMPLATE/preset_submission.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/preset_submission.yml b/.github/ISSUE_TEMPLATE/preset_submission.yml index 16c8d02d79..62628c4d3e 100644 --- a/.github/ISSUE_TEMPLATE/preset_submission.yml +++ b/.github/ISSUE_TEMPLATE/preset_submission.yml @@ -72,8 +72,8 @@ body: 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-preset/archive/refs/tags/v1.0.0.zip" + description: URL to the GitHub release archive for your preset (e.g., https://github.com/your-org/spec-kit-preset-your-preset/archive/refs/tags/v1.0.0.zip) + placeholder: "https://github.com/your-org/spec-kit-preset-your-preset/archive/refs/tags/v1.0.0.zip" validations: required: true From 54b1f3297bfb52d2252c5f8f8bed3cec2de09d84 Mon Sep 17 00:00:00 2001 From: Manfred Riem <15701806+mnriem@users.noreply.github.com> Date: Thu, 19 Mar 2026 11:52:43 -0500 Subject: [PATCH 3/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .github/ISSUE_TEMPLATE/preset_submission.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/preset_submission.yml b/.github/ISSUE_TEMPLATE/preset_submission.yml index 62628c4d3e..3a1b963492 100644 --- a/.github/ISSUE_TEMPLATE/preset_submission.yml +++ b/.github/ISSUE_TEMPLATE/preset_submission.yml @@ -12,7 +12,7 @@ body: - Review the [Preset Publishing Guide](https://github.com/github/spec-kit/blob/main/presets/PUBLISHING.md) - Ensure your preset has a valid `preset.yml` manifest - Create a GitHub release with a version tag (e.g., v1.0.0) - - Test installation: `specify preset add --dev ` + - Test installation from the release archive: `specify preset add --from ` - type: input id: preset-id