| name | grill-with-docs |
| description | Clarify a Salesforce feature or design through focused questions while recording domain decisions in CONTEXT.md and ADRs. |
| disable-model-invocation | true |
Clarify with repository docs
Use this skill before a non-trivial feature, integration, data, access, or architecture change.
Process
- Read
CONTEXT.md, relevant ADRs under docs/adr/, and the nearest implementation.
- Ask focused questions about actor, user outcome, constraints, failure paths, data, access, package boundaries, and operational ownership.
- Distinguish facts, decisions, assumptions, and unresolved questions.
- Update
CONTEXT.md only with stable domain or architecture language.
- Record a consequential choice as a dated ADR under
docs/adr/.
- Stop for human approval before access, personal-data, authentication, callout, metadata-visibility, CI, deployment, or package decisions.
- Hand the agreed outcome to
to-spec and do not implement directly from an unresolved conversation.
Do not invent domain terms, Salesforce IDs, external contracts, or policy requirements.