← ClaudeAtlas

grill-with-docslisted

Before brainstorming or coding, interrogate a vague request for scope/constraints AND ground it against real, current docs (not training-data memory) for any library or API it touches. Produces a CONTEXT.md the brainstorming/planning phase consumes. Use at the very start of any non-trivial task that names a library, framework, or external API.
bharat3645/The-Ideal-Harness · ★ 5 · AI & Automation · score 71
Install: claude install-skill bharat3645/The-Ideal-Harness
# Grill with docs A distinct, earlier stage than `brainstorming`: brainstorming compares *design approaches* once the problem is understood; this skill establishes *what the problem actually is* and *what's actually true about the libraries involved* before any approach gets proposed. Skipping this step is how a plan gets built on a hallucinated API that changed two major versions ago. ## Process 1. **Ask the clarifying questions a spec would answer** — scope boundary, non-goals, acceptance criteria, who/what this needs to work for. Two or three sharp questions beat ten shallow ones. 2. **Name every library/API the request touches.** For each one you're not certain is current, ground it instead of assuming: call `web_docs` (package metadata + README) or `web_fetch` (a specific docs page) from the `web` module. This is the actual anti-hallucination lever — check before you plan, not after something breaks. 3. **Write `CONTEXT.md`** (or update it if one exists): the restated problem, the answered questions, and one line per grounded fact ("`fetchPage` in package X takes `{url, headers}`, confirmed via registry README as of today," not "I recall it takes..."). 4. **Hand off.** `CONTEXT.md` is what `brainstorming` reads to propose approaches — don't re-ask the same questions there. ## When to skip A request with no external library/API surface and no real ambiguity doesn't need this — go straight to `brainstorming` or straight to work for a genuinely tri