What problem does it solve? Phase planning documents often contain vague items, stale file references, and unresolved decisions that force an executing model to guess. This Skill audits an existing uncompleted phase doc against the actual repository, resolves open questions with the human, and rewrites the doc so any model can execute it without ambiguity. ## Core Features & Use Cases - Evidence-based audit: Reads the chosen phase doc in full, dispatches read-only subagents to verify file paths, symbol signatures, and recently landed changes, then prints a terse gap report grouped by area. - Human-in-the-loop scoping: Stops at five stages to let the user pick the phase, choose expansion areas, set rewrite posture, and answer drill-down questions whose answers change the written plan. - Structured rewrite and index sync: Rewrites the doc in place with a "Refined: xN" stamp, nested detail bullets, resolved decisions, and verification lines, then recomputes progress counts in _INDEX.md and commits doc-only changes to main. - Use Case: Before running an implementation pass on Phase 26, invoke the refine workflow to fix dead links, name exact symbols and IPC channels, resolve open questions, and stamp the doc so the executor never has to make a judgement call. ## Quick Start Run the midnite-refine workflow on phase 26 to audit it against the repo, resolve its open decisions with me, and rewrite the doc to an executable standard.
