workspace-health

Workspace health assessment compares your current working directory state against phase expectations, identifying drift in documentation, artifacts, and traceability. Run a health check to receive a compact status and recommended cleanup or realignment actions based on where you are in your workflow.

Validate workspace health at end-of-phase transitions, after major features, following intensive processes, or when documentation appears out of sync. Manual checks are available anytime you suspect workspace drift or need to confirm consistency before proceeding.

Health checks flag stale artifacts, documentation gaps, broken traceability links, and hygiene problems in your working directory. The assessment exposes misalignment across workflow phases and proposes specific cleanup or realignment recommendations for user confirmation.

Workspace health requires explicit user confirmation before executing any cleanup or realignment actions. The Skill exposes integration points for related commands while safeguarding against unintended modifications to your project state.

The health check reads workspace state from the .aiwg/ directory, comparing configuration and artifact metadata against current phase expectations to generate actionable recommendations for alignment.