plangatelisted
Install: claude install-skill ParthGanatra/agent-skills
# PlanGate — terminal-native plan-review loop
Batch the decisions into a reviewable plan file instead of forcing the user through
one-by-one chat. The user reviews in vim; their `:w` is the signal; you resolve and
revise; no code until it's agreed. Full background & prior art: see the repo README.
**Review markers (the contract).** Everything the user reviews is markdown blockquotes:
- `> Q:` — a question / decision / anything needing the user's input. **Whenever you write a
`> Q:` line, put an empty `> A:` line directly under it** so the user jumps in and types the
answer with no marker typing (their vim has `]a` to jump to the next empty `> A:` and start typing).
- `> A:` — the answer. The user fills the empty slot; you fill it when *replying* to a `> Q:` the
user raised.
- **An open item = an empty `> A:` slot** (`^\s*> A:\s*$`), plus any `> Q:` the user added with no
`> A:` under it. The loop is done when every `> Q:` has a non-empty `> A:` beneath it.
- Blockquotes keep the plan valid markdown (renders fine in Obsidian/GitHub) and — with the bundled
vim reading setup (see README) — highlight `> Q:` vs `> A:`, with `]q`/`[q` to page between open questions.
Helper scripts live beside this file:
- `open-plan.sh <file>` — open/focus the plan in a right-side vim pane (its own pane; never hijacks the user's working vim).
- `wait-save.sh <file> [max_s]` — block until the user saves; run it in the BACKGROUND so their `:w` re-invokes you.
- `nudge-reload.sh` — after