grill-me is one of Matt Pocock’s AI Hero skills, a set of instructions you add to an AI coding agent like Claude Code. It has the agent interview you in rounds until the vague parts of an idea are pinned down, and it doesn’t write any files. That makes it my pick for a vague plan, or for a repo where I haven’t set up the rest of the AI Hero skills.
On repos where I have run the setup (setup-matt-pocock-skills, which records where your issues and docs live), I use grill-with-docs instead. It runs the same interview but writes what you agree on into the repo as you go: a GLOSSARY.md as terms are resolved, and an ADR (architecture decision record, a short file saying what was decided and why) under docs/adr/ for anything hard to reverse or worth explaining later.
It really wants ADRs to exist already, and if there aren’t any it starts suggesting you create one. I was already writing ADRs by hand, so it fitted straight into that habit, and the format is now consistent across every repo I touch at work.
wayfinder is for a big piece of work that needs splitting up, and that’s where I’ve found it useful. Agents get confused on bigger jobs, so you want to keep each one focused on a single task rather than a whole project, and wayfinder is good at breaking the work down that way.
You tell it where you’re trying to get to, and it opens a map issue on your tracker, a parent issue with a child issue for each decision still to be made. Most of those are grilling sessions with you, but some are prototypes or research that an agent can go off and do on its own. You work through them one session at a time.
Wayfinder itself only plans. Once the map is clear, the to-spec and to-tickets skills from the same set turn it into implementation issues that you can triage and hand to agents to build.