workspace-health-check-skill

Workspace health checks assess alignment between your current project state and phase expectations by reading workspace metadata, then propose cleanup or realignment actions. Run a check at flow transitions, after major features, or when documentation drifts to get actionable recommendations without automatic changes.

Run checks at end-of-phase transitions, after completing major features, following intensive processes, when documentation appears out of sync with code state, or on manual request. These timing points catch misalignment before it compounds and guide deliberate cleanup.

Health checks assess working directory freshness by pruning stale files and unlocking drafts, verify documentation alignment with current project phase, and flag completed or stale artifacts. Results surface actionable cleanup or realignment steps for your review.

Yes. Health checks output recommendations without automatic execution, requiring explicit user confirmation before any cleanup or realignment actions apply to your workspace.

The check reads workspace state from .aiwg/ metadata and compares it against current phase expectations to identify drift, then outputs cleanup or realignment guidance based on that analysis.