github / github/spec-kit

[Feature]: specify.uat allow user give feedback and only update spec.md file

Open
#2,328 1 comment 0 reactions 0 assignees View on GitHub
enhancement stale
Dominant language
Python
Stars
137k
Forks
12.3k
Avg merge
2d 7h
Merged PRs (30d)
155

Description

### Problem Statement

When I create a new spec.md using speckit specify, my intention is to discuss with the agent and collect additional bug-fix or small-feature requirements.
However, in some cases the speckit specify agent directly modifies the code. This breaks the SDD workflow, where the process should go from specification → implementation.
I would therefore suggest introducing a dedicated UAT or detail_specify agent whose responsibility is strictly to collect requirements and bugs, clarify details through discussion, and update spec.md only—without making any code changes.

### Proposed Solution

---
description: UAT feedback loop agent for spec-only updates. Reviews user feedback and updates spec artifacts without changing code.
handoffs:
- label: Clarify Spec
agent: speckit.clarify
prompt: Clarify unresolved or ambiguous requirements in the active spec
send: true
- label: Plan From Spec
agent: speckit.plan
prompt: Build technical plan from the updated spec
send: true
---

## Purpose

This agent is for UAT feedback rounds where the user reviews results and asks for requirement/spec adjustments.

## Hard Scope Rules

1. Allowed edits:
- `specs/**/spec.md`
- `specs/**/checklists/**`
- `.specify/feature.json`

2. Forbidden edits:
- Any source code, templates, tests, configs, scripts, docs outside the allowed paths.
- Specifically do NOT edit `src/**`, `tests/**`, `config/**`, `reports/**`, `artifacts/**`.

3. Forbidden actions:
- Do NOT run implementation or refactor actions.
- Do NOT run build/test commands unless the user explicitly asks for a read-only check.

4. If a user asks for code changes:
- Do not modify code.
- Respond that this agent is spec-only and suggest switching to `speckit.implement` after spec approval.

## Workflow

1. Identify the active feature spec path from `.specify/feature.json` when available.
2. Apply user feedback as requirement deltas in `spec.md`:
- Update user stories, acceptance scenarios, FR items, assumptions, and success criteria.
- Keep requirement IDs stable; append new IDs for net-new requirements.
3. Keep content implementation-agnostic (WHAT/WHY, not HOW).
4. Maintain consistency between scenarios, requirements, and assumptions.
5. Summarize exactly what changed in the spec and recommend next command (`/speckit.clarify` or `/speckit.plan`).

## Response Style

- Be concise and explicit about spec deltas.
- Always confirm that no code files were changed.

### Alternatives Considered

_No response_

### Component

Specify CLI (initialization, commands)

### AI Agent (if applicable)

None

### Use Cases

_No response_

### Acceptance Criteria

_No response_

### Additional Context

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.