github / github/spec-kit

[Feature]: Add /speckit.guide for dry-run implementation planning

Offen
#3,057 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement
Vorherrschende Sprache
Python
Sterne
137k
Forks
12.3k
Ø Merge
2 T. 12 Std.
Gemergte PRs (30 T.)
159

Beschreibung

### Problem Statement

While /speckit.clarify helps reduce ambiguity in the feature specification before planning, there is currently no equivalent step for validating implementation scope after task generation and before execution.

This leaves a gap where /speckit.implement may exceed the intended scope by acting on future tasks or making architectural assumptions that were not explicitly reviewed beforehand.

This creates risks such as:

Scope creep across planned phases
Unintended architecture changes
Hallucinated dependencies or missing interfaces
Higher review and rollback costs

### Proposed Solution

Introduce a new optional command: `/speckit.guide`.

This command would run after `/speckit.tasks` and before `/speckit.implement`, generating a `guide.md` file that acts as a dry-run implementation plan.

The generated guide would describe:

* Which files are expected to be modified
* Which interfaces or services may be affected
* Required dependencies or prerequisites
* Execution order of tasks
* Scope boundaries for the current phase
* Potential risks or stop conditions

This would provide developers with a reviewable implementation artifact before execution, reducing the chance of scope drift and improving architecture control.

Proposed workflow:

```text
/speckit.specify
→ /speckit.clarify
→ /speckit.plan
→ /speckit.tasks
→ /speckit.guide
→ Human review
→ /speckit.implement
```

This would not replace `/speckit.clarify`, but complement it by extending the same validation principle into the implementation phase.

### Alternatives Considered

Yes, I considered the following alternatives:

1. **Using `/speckit.clarify`**

* This helps resolve ambiguity in the feature specification before planning.
* However, it does not address implementation scope validation after task generation.

2. **Improving `/speckit.implement` directly**

* Scope validation logic could be embedded into `/speckit.implement`.
* However, this would mix planning/review concerns with execution, reducing workflow transparency.

3. **Manual `guide.md` creation**

* This is the current workaround I use.
* It provides better control, but it is manual, inconsistent, and not integrated into the Spec Kit workflow.

I believe a dedicated `/speckit.guide` command is the cleanest solution because it introduces a reusable, explicit review layer between task generation and implementation.

### Component

Agent integrations (command files, workflows)

### AI Agent (if applicable)

None

### Use Cases

_No response_

### Acceptance Criteria

_No response_

### Additional Context

_No response_

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginnen Sie mit der Untersuchung der vorhandenen Befehlsdateien und Workflows für /speckit.tasks und /speckit.implement, um zu verstehen, wie sich ein neuer Schritt /speckit.guide einfügen würde. Der Issue schlägt vor, guide.md mit Umfang, Abhängigkeiten, Ausführungsreihenfolge, Abgrenzungen, Risiken und Abbruchbedingungen zu erzeugen, nennt jedoch keine benannten Dateien, Tests oder Akzeptanzkriterien; diese müssen festgelegt werden, bevor die Implementierung abgeschlossen ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
developer-experience, tooling
Issue-Typ
Feature
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.