---
name: spec-discussion
description: >-
  Help clarify a feature and draft its specification.
  Use when the user requests a design discussion or a
  feature has unresolved decisions about behavior,
  scope, or integration. Skip routine changes whose
  requirements are already clear.
---

# Discuss the feature

Discuss the design before implementing the feature.

1. Read the request, relevant project instructions,
   existing specs, and relevant code. Identify settled
   decisions and important open questions.
2. Ask about unresolved decisions that affect this
   feature. Explain useful options and consequences.
   Ask one question at a time when an answer needs
   careful discussion. Do not repeat settled questions.
3. Draft or update SPEC.md at the project root during
   the discussion. If the project already has a spec
   for this feature, update that file instead.
   Record intended behavior, scope,
   integration, important decisions and reasons,
   checks, and open decisions.
4. Summarize what will be built next and ask the user
   to review and correct the draft. Resolve decisions
   needed for that work and record deferred ones.
   Finish when there is shared understanding.
   Wait for the user's instruction to implement.