Terminal
Terminal/Skill
Questions you one question at a time about a vague idea, recording goals and constraints in the spec before any tasks exist.
By Julius Brussee
Works with
npx skills add juliusbrussee/cavekit --skill grillOne question at a time. Every answer lands in a § or gets parked ?. Never guess a constraint into existence.
Plan-then-execute guesses the fuzzy parts & builds the wrong thing. Grill drags the fuzz into §G/§C before a single §T row exists. A bad assumption caught here costs one question. Caught in §B it costs a bug.
/spec new on anything non-trivial.Skip for a typo or a one-line fix. Grill scales to uncertainty, ⊥ to ego.
One opening read, not a quiz:
Match it. Brutal grilling on a half-formed idea just demoralizes. Light grilling on a committed plan misses the load-bearing flaw.
Climb in order. Each rung, ask one question, recommend an answer, wait.
? §C bullet)Stop climbing the moment the spec would be unambiguous. Do not ask all seven by reflex.
Each question carries a recommended answer so the user can grunt "yes" & move:
Q: auth — session cookie or JWT? rec: JWT — stateless, you named horizontal scaling as a §C. (a) JWT (b) cookie (c) something else?
When done, emit a compact block — goal line, constraint bullets, surfaced
unknowns as ? — and hand to the spec skill to write §G/§C. Grill proposes;
spec is the sole mutator. Never write SPEC.md directly.
Done when ALL hold:
?.Unresolved blocking unknown that needs the outside world → recommend /research, not a guess.