promote-branchlisted

# Promote branch ## Purpose Move code through the configured environment ladder (dev → test → prod) without bypassing the pre-push promotion gate. Wraps `yakos env promote` with the discipline of a guided workflow: pre-checks, PR creation, post-merge confirmation. ## Scope Operates against the project's `.yakos.yml` `environments:` config and the configured git branches. Does NOT model deploy infra (k8s, Vercel, etc.) — promotion stops at PR merge; deploy is downstream. ## Automated pass ```sh # Pre-checks (skill internals): yakos env validate # config sanity yakos env list # confirm from/to envs exist git status --porcelain # clean working tree required git -C $project fetch --all # local matches remote ``` If pre-checks pass, invokes `yakos env promote <from> <to>`, which: 1. Confirms the from-branch is at HEAD-of-origin 2. Detects the PR tool (`gh`/`glab`/plain git) 3. Creates the PR with structured title + body 4. Returns the PR URL for operator review ## Manual pass After the PR is open: - Operator reviews the PR per the project's review discipline (`rule:pr-conventions`) - For `requires_review: true` environments (typically `prod`), at least one human approval required - Operator merges per the project's merge convention (squash, merge-commit, rebase) The skill does NOT auto-merge. yakOS's audit-trail-first posture applies: every promotion to prod requires a human signature on the merge. #