grill-with-docs
Grill With Docs
Section titled “Grill With Docs”Use this vs grill-me:
grill-with-docsis the doc-grounded variant ofgrill-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. Usegrill-mefor context-only assumption surfacing without fetching docs.
HARD GATE — Every challenge must cite a real documentation URL. No hallucinated APIs.
Process
Section titled “Process”- Read the plan or design under test (
specs/release-plan.yaml + epic shards, INTERFACE-OPTIONS.md, etc.). - List assumptions that depend on external libraries or APIs.
- For each assumption: fetch or quote official docs; challenge with “docs say X, plan says Y.”
- Resolve or update the plan inline; unresolved items block
plan-work.
Docs mode rules
Section titled “Docs mode rules”- Cite URL + quoted snippet (method name, parameter, version).
- If docs contradict the plan, plan loses until updated.
- Prefer official docs over blog posts.
Verify
Section titled “Verify”→ 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 –>