consult-plan
Grill a proposed change, deviation, or new idea against a repo's existing plan (issues, board, roadmap, decisions), then record the outcome. Use to pitch an idea; update-progress calls it for handoff
SKILL.mdkanban/consult-plan/SKILL.md
GitHub- Target repo per BOARD.md: resolve
origin(this skill needs it on GitHub),-R <owner>/<repo>on everyghcall, and on a fork ask which repo to write to before any write. - Baseline, whatever exists: open issues, board state, roadmap doc, the decisions doc (found as in step 3) and the grill transcripts (
skilleddocs/grills/, orgrills/beside a tracked register) (cite decisions asD<k>, orADR <n>in an ADR folder). - Grill: call the Skill tool with
"grilling", baseline as context. The question tree: does the idea fit, conflict with, or extend the plan, and what does the user want to happen? - Record once settled:
- Append one row per decision to the repo's decisions doc: the one
AGENTS.md/CLAUDE.mdnames; else an existingdocs/decisions.md; else an ADR folder; elseskilleddocs/decisions.md(same rule asgrill-docs, which also gives the precedence when several files name one, the folder paths, the header and row format; an ADR folder gets one new ADR per decision, and marks an old ADR it reverses or narrowsSuperseded by NNNN/Amended by NNNN). Source:consult-plan <local date>, plus the issue or PR link when there is one. Untracked → excludeskilleddocs/per thehandoff-autoskill'sTRACKING.md(it also covers thepip install .hazard). - Idea accepted or changed: refines existing work → comment on that issue (the decision ids and a one-line outcome; an untracked register, e.g. on a fork, is unreadable to others: quote each decision's text instead of its id); needs its own work → open an issue and put it on the board at Todo (BOARD.md). No repo to write to (fork, both writes declined per BOARD.md's Target repo) → the decision row is the record: add the idea as a roadmap line if one exists, hand the user the issue title and body, and say so.
- Idea rejected: the decision row is the record. Comment only if a related issue exists; never open an issue for a rejected idea.
- Append one row per decision to the repo's decisions doc: the one