phase-wrap

Executes phase-boundary closeout with retrospectives, drift gates, and council reviews.

Updated Sep 14, 2026
One-click install
npx skills add https://github.com/pandejesal/drone-nav-sar --skill phase-wrap-pandejesal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-wrap
Source: https://github.com/pandejesal/drone-nav-sar/tree/main/.swarm/bundled-skills/phase-wrap
Command: npx skills add https://github.com/pandejesal/drone-nav-sar --skill phase-wrap-pandejesal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Multi-phase AI-orchestrated projects often close phases without verified evidence, letting drift, hallucinated APIs, and untested code slip through. This protocol enforces a rigorous, gated phase-completion workflow so no phase closes without retrospectives, verification evidence, and required agent participation. ## Core Features & Use Cases - Retrospective Gate: Blocks phase_complete until a structured retrospective evidence bundle (verdict, metrics, lessons learned) is written via write_retro. - Verification Gates: Runs drift verification against the effective spec, hallucination checks on changed files, and mutation testing when enabled in the QA gate profile. - Council Reviews: Dispatches 5-member phase and final councils, collecting verdicts and persisting quorum-bound evidence before closeout. - Use Case: After finishing Phase 2 of a swarm-managed build, the architect runs this protocol to rescan the codebase, update docs, write the retrospective, pass drift and hallucination gates, and only then call phase_complete. ## Quick Start Ask the architect to run the phase-wrap protocol to close out the current phase with all required evidence gates and retrospective.

Frequently Asked Questions about phase-wrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I complete a phase in a swarm architect workflow?

Run the phase-wrap protocol: rescan with the explorer agent, update docs, write a retrospective via write_retro, pass drift and hallucination gates, then call phase_complete. Missing evidence or required agent dispatches will block completion.

Why is phase_complete blocked with RETROSPECTIVE_MISSING?

The retrospective gate requires a retro-N evidence bundle written via the write_retro tool before phase_complete. Include phase number, verdict, task metrics, and lessons learned, then retry phase completion.

What evidence files are required before closing a phase?

Required artifacts include completion-verify.json, drift-verifier.json when a spec exists, hallucination-guard.json and mutation-gate.json when those QA gates are enabled, and phase-council.json when phase_council is active. All live under .swarm/evidence/{phase}/.

When does the final council run in a multi-phase plan?

The final council runs only after the last phase, when all other phases are complete and final_council is enabled in the QA gate profile. It dispatches five council members with project-scoped context and writes final-council.json before phase_complete.

Can phase gates be skipped in turbo mode?

Yes, turbo mode skips all gates automatically, including drift, hallucination, and mutation checks. Otherwise, enabled gates are hard-enforced by runtime hooks and will block phase_complete if evidence is missing or failing.