Workspace Health Check FAQs

Question 1

What does the Workspace Health Check skill actually do?

Accepted Answer

It performs a diagnostic scan of your project's internal AI context (the .aiwg directory) to ensure your documentation, requirements, and code artifacts are properly synchronized and free of stale data.

Question 2

Does this skill automatically delete my files?

Accepted Answer

No, it generates a detailed Health Report with recommendations. You must manually execute the suggested cleanup commands, such as /workspace-prune-working, to finalize any changes.

Question 3

When is the best time to run a workspace health check?

Accepted Answer

You should invoke this skill at the end of phase transitions, after completing major features, or whenever you notice the AI documentation seems out of sync with the actual code.

Question 4

How does it detect architecture drift?

Accepted Answer

The skill compares your current codebase implementation against your documented Software Architecture Document (SAD) and Architecture Decision Records (ADR) to flag where they have diverged.

Question 5

Is this skill compatible with standard Git repositories?

Accepted Answer

While it works in any repository, it is specifically optimized for the .aiwg context stack structure used by autonomous agentic coding frameworks like the AI Writing Guide.

Workspace Health Check

Key Features

Use Cases

Workspace Health Check

Key Features

Use Cases