Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .github/ISSUE_TEMPLATE/agent_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -139,3 +139,16 @@ body:
label: Additional Context
description: Any other relevant information about this agent
placeholder: Screenshots, community links, comparison to existing agents, etc.

- type: textarea
id: ai-disclosure
attributes:
label: AI Disclosure
description: >-
Per our [Contributing guidelines](https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md#ai-contributions-in-spec-kit),
any AI assistance used to create this issue must be disclosed. If you used AI, name the agent/tool, model(s),
settings/mode (reasoning effort; autonomous vs. human-supervised), and extent. Otherwise leave this as "N/A".
This does not change how your issue is handled — it just gives maintainers visibility into model/agent usage.
value: "N/A"
validations:
required: true
13 changes: 13 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -138,3 +138,16 @@ body:
label: Additional Context
description: Add any other context about the problem
placeholder: Screenshots, related issues, workarounds attempted, etc.

- type: textarea
id: ai-disclosure
attributes:
label: AI Disclosure
description: >-
Per our [Contributing guidelines](https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md#ai-contributions-in-spec-kit),
any AI assistance used to create this issue must be disclosed. If you used AI, name the agent/tool, model(s),
settings/mode (reasoning effort; autonomous vs. human-supervised), and extent. Otherwise leave this as "N/A".
This does not change how your issue is handled — it just gives maintainers visibility into model/agent usage.
value: "N/A"
validations:
required: true
13 changes: 13 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -124,3 +124,16 @@ body:
label: Additional Context
description: Add any other context, screenshots, or examples
placeholder: Links to similar features, mockups, related discussions, etc.

- type: textarea
id: ai-disclosure
attributes:
label: AI Disclosure
description: >-
Per our [Contributing guidelines](https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md#ai-contributions-in-spec-kit),
any AI assistance used to create this issue must be disclosed. If you used AI, name the agent/tool, model(s),
settings/mode (reasoning effort; autonomous vs. human-supervised), and extent. Otherwise leave this as "N/A".
This does not change how your issue is handled — it just gives maintainers visibility into model/agent usage.
value: "N/A"
validations:
required: true
6 changes: 4 additions & 2 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@
<!-- See: https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md#ai-contributions-in-spec-kit -->

- [ ] I **did not** use AI assistance for this contribution
- [ ] I **did** use AI assistance (describe below)
- [ ] I **did** use AI assistance (fill in the disclosure below)

<!-- If you used AI, briefly describe how (e.g., "Code generated by Copilot", "Consulted ChatGPT for approach"): -->
<!-- If you used AI assistance, replace "N/A" below with a free-form disclosure that names the agent/tool, model(s), settings/mode (reasoning effort; autonomous vs. human-supervised), and extent (docs vs. code generation). This does not change how much scrutiny your PR receives — the same evidence bar applies to everyone. It just gives maintainers visibility into model/agent usage. -->

**AI disclosure:** N/A
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -522,7 +522,7 @@ Disclosure is **continuous**, not a one-time event. A single AI-disclosure parag

### Comments

- If you are an agent working on behalf of a human, **disclose your identity in your PR comment** — name the agent (and model, if applicable) and the human you are acting for (e.g., "Posted on behalf of @user by GitHub Copilot (model: &lt;name-if-known&gt;)").
- If you are an agent working on behalf of a human, **disclose your identity in your PR comment** — name the agent and model and the human you are acting for (e.g., "Posted on behalf of @user by GitHub Copilot (model: &lt;name-if-known&gt;)").
- **Re-state agent identity in each review-round summary comment.** A prior PR-body disclosure does not cover later comments or commits.
- Post **one** top-level summary comment per review round listing what changed and the commit SHA. Do not reply on every individual comment.
- Reply inline only when context is needed (disagreement, deferral, non-obvious fix). Keep it to a sentence or two.
Expand Down
24 changes: 16 additions & 8 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -237,23 +237,31 @@ Number each test sequentially (T1, T2, ...). List prerequisite tests first.
We welcome and encourage the use of AI tools to help improve Spec Kit! Many valuable contributions have been enhanced with AI assistance for code generation, issue detection, and feature definition.

That being said, if you are using any kind of AI assistance (e.g., agents, ChatGPT) while contributing to Spec Kit,
**this must be disclosed in the pull request or issue**, along with the extent to which AI assistance was used (e.g., documentation comments vs. code generation).
**this must be disclosed in the pull request or issue**. When AI assistance was used, the disclosure must name:
Comment thread
Copilot marked this conversation as resolved.

If your PR responses or comments are being generated by an AI, disclose that as well.
- **The agent/tool** — e.g., GitHub Copilot, Claude Code, ChatGPT.
- **The model(s)** — e.g., Claude Opus 4.x, GPT-5.
- **The settings/mode** — e.g., reasoning effort, and whether it ran autonomously or under human supervision.
- **The extent** — e.g., documentation comments vs. code generation.

As an exception, trivial spacing or typo fixes don't need to be disclosed, so long as the changes are limited to small parts of the code or short phrases.
If your PR responses or comments are being generated by an AI, disclose that as well, naming the same agent, model(s), settings/mode, and extent.

As an exception, trivial spacing or typo fixes don't need to be disclosed, so long as the changes are limited to small parts of the code or short phrases. The catalog-submission issue forms (extension, preset, and bundle submissions) feed content-neutral validation automation rather than code review, so they carry no disclosure field and are exempt from this requirement.

An example disclosure:

> This PR was written primarily by GitHub Copilot.
> Implemented with GitHub Copilot using Claude Opus 4.x in agent/autonomous mode; code generation.

Or a more detailed disclosure:

> I consulted ChatGPT to understand the codebase but the solution
> I consulted ChatGPT (GPT-5, default settings, human-supervised) to understand the codebase, but the solution
> was fully authored manually by myself.

Failure to disclose this is first and foremost rude to the human operators on the other end of the pull request, but it also makes it difficult to
determine how much scrutiny to apply to the contribution.
Failure to disclose this is first and foremost rude to the human operators on the other end of the pull request.

To be clear, this disclosure does not change the level of scrutiny a contribution receives — the same evidence bar applies to
everyone, human and AI-assisted alike. It simply gives maintainers visibility into which models and settings are being used and to
what extent, which in turn helps us judge whether our [`AGENTS.md`](./AGENTS.md) guidance needs refinement over time.

In a perfect world, AI assistance would produce equal or higher quality work than any human. That isn't the world we live in today, and in most cases
where human supervision or expertise is not in the loop, it's generating code that cannot be reasonably maintained or evolved.
Expand All @@ -262,7 +270,7 @@ where human supervision or expertise is not in the loop, it's generating code th

When submitting AI-assisted contributions, please ensure they include:

- **Clear disclosure of AI use** - You are transparent about AI use and degree to which you're using it for the contribution
- **Clear disclosure of AI use** - You are transparent about AI use, naming the agent/tool, model(s), settings/mode, and the degree to which you're using it for the contribution
- **Human understanding and testing** - You've personally tested the changes and understand what they do
- **Clear rationale** - You can explain why the change is needed and how it fits within Spec Kit's goals
- **Concrete evidence** - Include test cases, scenarios, or examples that demonstrate the improvement
Expand Down