plan-exit-governance-drift-handoff
When ending a session on an iterated plan draft, audit and document approval-state drift across GitHub labels, local approval markers, README status, and latest review verdicts.
Best use case
plan-exit-governance-drift-handoff is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
When ending a session on an iterated plan draft, audit and document approval-state drift across GitHub labels, local approval markers, README status, and latest review verdicts.
Teams using plan-exit-governance-drift-handoff should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/plan-exit-governance-drift-handoff/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How plan-exit-governance-drift-handoff Compares
| Feature / Agent | plan-exit-governance-drift-handoff | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
When ending a session on an iterated plan draft, audit and document approval-state drift across GitHub labels, local approval markers, README status, and latest review verdicts.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Plan Exit Governance Drift Handoff Use when: - A GitHub issue is still in planning/re-review mode - The plan has gone through multiple adversarial review waves - You are preparing to exit, hand off, or pause work - There is any chance older approval state still exists ## Why this matters A local plan can still be `draft` or "not approval-ready" while the live issue already shows `status:plan-approved` and/or `.planning/plan-approved/<issue>.md` exists from an older state. If you end the session without auditing that, the next operator may incorrectly treat the issue as executable. ## Required exit audit Before finishing, check all four surfaces: 1. Live GitHub issue state and `status:*` labels 2. Local approval marker `.planning/plan-approved/<issue>.md` 3. `docs/plans/README.md` row status 4. Latest valid provider review verdicts in `scripts/review/results/` ## Required handoff contents Document explicitly: - current local plan status (`draft`, `plan-review`, etc.) - latest valid provider verdicts - whether the issue is honestly approval-ready or still revision-required - whether GitHub / local marker / README disagree - the exact contradiction if drift exists - that the next session must reconcile approval-vs-review drift before implementation or further advancement ## Recommended wording pattern - "Live issue shows `status:plan-approved`, but latest valid review evidence still returns MAJOR findings." - "Local approval marker exists, but current draft remains revision-required." - "Next session must determine whether approval remains authoritative or whether fresh-review rollback to `status:plan-review` is required." ## Minimal command bundle ```bash cd /path/to/repo gh issue view <issue> --json state,labels,title,url ls -l .planning/plan-approved/<issue>.md rg -n "\| <issue> \|" docs/plans/README.md ``` Then read the latest provider artifacts for the active plan. ## When to roll back If fresh review evidence is MAJOR and there is no newer authoritative user approval after the revised draft, the next session should consider the fresh-review rollback routine: - remove stale `status:plan-approved` - restore `status:plan-review` - remove stale local approval marker if appropriate - sync `docs/plans/README.md` - leave a governance-cleanup note on the issue ## Output artifacts Prefer both: 1. a GitHub issue status comment 2. a local exit handoff doc under `docs/handoffs/` This makes the drift visible both in-repo and on the issue thread.
Related Skills
public-knowledge-graph-governance
Maintain public-safe knowledge graph artifacts for llm-wiki and similar markdown knowledge bases. Use when changing graph generators, validators, schema docs, weekly freshness checks, or public/private source-scope boundaries.
llm-wiki-cadence-governance
Weekly governance workflow for keeping an llm-wiki repository current, code-development-useful, and connected to actionable GitHub issue planning.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
context-compaction-handoff
Guardrails for resuming work after context compaction or transcript handoff blocks; prioritize the latest real user request over stale summarized tasks and verify before answering.
plan-review-prompt-refresh-after-plan-edits
Refresh reviewer prompt files from the latest on-disk plan before every adversarial re-review. Prevents Codex/Gemini from critiquing stale plan text after local edits.
workspace-hub-overnight-plan-monitor
Monitor and reconcile workspace-hub overnight planning or implementation batches, including process status, result artifacts, issue/commit verification, and controlled failed-lane recovery.
plan-gated-issue-execution-wave
Execute a multi-issue architecture/planning wave in a plan-gated repo, then safely transition approved issues into implementation with file-based Codex prompts, local approval markers, subprocess monitoring, and cleanup handling for sandbox/hook edge cases.
mixed-ops-vs-repo-fix-plan-boundary
Plan mixed operational-vs-repo remediation issues by proving live-state classification first, then only proposing code changes for confirmed repo-owned failure paths.
wave-based-parallel-plan-execution
Orchestrate phase execution by discovering dependencies, grouping into waves, spawning subagents, and collecting results with optional wave filtering
plan-gated-issue-validation-workflow
Systematic validation pattern for plan-approved GitHub issues with pre-existing deliverables
plan-gated-issue-implementation
Workflow for executing pre-approved GitHub issues with mandatory validation checkpoints
external-drive-ingest-planning
Plan safe external-drive ingests into repo-aligned storage such as /mnt/ace: read-only mounts, manifests, staged rsync, dedupe-merge gates, GitHub issue traceability, and governance/execution split.