vouchdev /vouch-propose-from-pr
A PR is a decision: someone proposed a change, the team accepted it. The "why" gets compressed into the merge message and forgotten. This command preserves the why as cited claims in the KB.
Steps:
- Parse
$ARGUMENTSas a PR URL or<owner>/<repo>#<num>; default to the most-recently-merged PR you authored. - Fetch the PR title, body, and the merged-commit SHA via
gh. - Register the merge commit as a
kb_register_sourceso subsequent claims can cite it. - Read the diff. For each behavioural change (not formatting / renaming),
draft one
kb_propose_claimwhose text summarises the new invariant the code now upholds, citing the source from step 3. - Propose at most five claims per PR. If a PR is that big, suggest the contributor split it next time.
Do not auto-approve. The KB's review gate is intentional; this command only fills the queue.