z-grill-with-docs
Installation
SKILL.md
Grill with docs
The interview is [[z-grill-me]] — sharpen the ask, grill the brief against the code, grill it against the records, grill the user, close. Run it as written. This skill adds one thing: the records are updated during the interview, not from memory afterwards.
Write as you go
- Resolve the authoritative record first. Use existing OpenSpec specs/design when present, otherwise the project's glossary/ADR convention. Update it as a term is resolved; do not create a second source of truth. For a CONTEXT.md fallback, use references/context-format.md.
- When a term is vague or overloaded, propose one canonical term and record the rejected synonyms as avoid entries — that list is what stops the next session relitigating it.
- Surface a conflict with the authoritative glossary when it appears. Preserve settled decisions unless the user changes them.
- Record a consequential trade-off in the existing OpenSpec design or decision record. Use a separate ADR only when that is the project's convention and the decision warrants durable rationale; see references/adr-format.md.
- Stress-test domain relationships with concrete scenarios that probe edge cases; a term that survives no scenario is not resolved.
Term and boundary judgment — what deserves a glossary entry, where a context boundary runs — is [[z-domain-modeling]]'s territory; this skill supplies the writing discipline and the file formats.