synth-pr-to-soplisted

# /synth-pr-to-sop Turn a merged PR into a typed workflow entry. The PR's title becomes the workflow name. The PR description, commits, and review notes become ordered steps. The result is a single markdown file with `type: workflow` frontmatter that the wiki-maintainer aggregates into a topic page. ## When to run After a PR ships that captures a process worth filing. Examples: - A PR that updates a deploy runbook - A PR that documents a new onboarding step - A PR that codifies a fix-and-followup pattern ## Two synthesis paths The script supports two modes. Pick one before running: ### Path A: heuristic (offline, no LLM) The script extracts headers, bullets, and commit subjects deterministically. Good for PRs that already follow a structured template. Run: ```bash python3 skills/synth-pr-to-sop/synth.py <pr-path> --vault-root <vault> ``` ### Path B: Claude Code session is the LLM You (the operator) run this skill from a Claude Code session. The script first runs the heuristic pass and writes a draft. Then Claude reads the PR markdown directly, refines the steps, owners, and edge cases, and writes the final file. No external LLM API call is made by the script. Claude is the LLM, your hands on the keyboard are the operator. This is the default and recommended path. ## Step 1: Locate the PR markdown Argument can be: - A single file (e.g. `External Inputs/GitHub/myrepo/2026-04-30.md`) - A folder of PR exports (e.g. `External Inputs/GitHub/myrepo/`) If a folder, the