Skip to content

grill-with-docs

Use this vs grill-me: grill-with-docs is the doc-grounded variant of grill-me. Use it when the plan relies on external libraries or APIs and every challenge must be grounded in and cite a real documentation URL. Use grill-me for context-only assumption surfacing without fetching docs.

HARD GATE — Every challenge must cite a real documentation URL. No hallucinated APIs.

  1. Read the plan or design under test (specs/release-plan.yaml + epic shards, INTERFACE-OPTIONS.md, etc.).
  2. List assumptions that depend on external libraries or APIs.
  3. For each assumption: fetch or quote official docs; challenge with “docs say X, plan says Y.”
  4. Resolve or update the plan inline; unresolved items block plan-work.
  • Cite URL + quoted snippet (method name, parameter, version).
  • If docs contradict the plan, plan loses until updated.
  • Prefer official docs over blog posts.

→ verify: grep -c 'https\?://' skills/grill-with-docs/SKILL.md | awk '{if($1>=2) print "OK"; else print "NEEDS DOCS"}'

See REFERENCE.md for question templates.

<!– story: e03s01 –>