| name | grill-with-docs-openspec |
| description | Structured requirement interview for larger changes, grounded in OpenSpec capabilities and repository constraints. |
Grill With Docs (OpenSpec)
Purpose
Run a focused question loop for larger changes so implementation starts with unambiguous requirements.
Required sources
- Relevant OpenSpec capability files under openspec/specs.
- Existing repo instructions and constraints in .github/copilot-instructions.md.
- Impacted code and test paths.
Interview rules
- Ask one concrete question at a time.
- Prefer evidence from code/specs before asking a question.
- Resolve terminology against existing capability language.
- Escalate conflicts between docs and specs explicitly.
- For behavior changes, require proposed delta in openspec/changes before code updates.
Deliverables
- Decision log for resolved questions.
- Confirmed scope and out-of-scope list.
- Capability-impact matrix.
- Test strategy aligned to parser/report risk.
Exit criteria
- Requirements are specific enough to implement without guessing.
- OpenSpec linkage is explicit for every behavior change.
- Stakeholder review points are identified before coding starts.