Does this skill automatically delete my files?

No, the skill identifies issues and suggests cleanup commands like /workspace-prune-working, but it requires user confirmation before any destructive actions are taken.

Can it detect if my code doesn't match my architecture?

Yes, it flags potential architecture drift by comparing current code states against documented Software Architecture Documents (SAD) and ADRs.

When should I run a workspace health check?

It is best used after finishing major features, transitioning between SDLC phases (like Elaboration to Construction), or whenever your documentation feels out of sync with your code.

Is this skill compatible with other AI coding tools?

While optimized for Claude Code, it supports the AIWG cognitive architecture which is also used by platforms like Hermes and OpenClaw.

What directory structure does it monitor?

It specifically monitors the .aiwg/ directory, including the planning, reports, and working artifact folders to ensure structural integrity and phase alignment.

Workspace Health Check

Name: Workspace Health Check
Author: jmagly

byjmagly

•

102

•

Productividad y Flujo de Trabajo

Monitors and maintains the integrity of your development environment by identifying stale artifacts and documentation misalignments.

The Workspace Health Check skill ensures your AI-augmented development environment remains organized and synchronized with your project's progress. It automatically audits the .aiwg directory structure to detect orphaned drafts, stale lock files, and documentation that has drifted from the actual implementation. Ideal for complex projects following structured SDLC phases, this skill provides actionable reports and cleanup recommendations to prevent technical and documentation debt from accumulating during high-velocity coding sessions.

Características Principales

01Automated audit of the .aiwg directory for stale or orphan files

02Detection of architectural drift and outdated risk registers

03Traceability checks between project requirements and implementation artifacts

04Phase-based documentation alignment verification across planning and reports

05102 GitHub stars

06Actionable remediation suggestions and cleanup command prompts

Casos de Uso

01Verifying requirement coverage and artifact freshness before project milestones

02Ensuring documentation stays in sync with code during rapid iteration cycles

03Cleaning up the working directory after completing a major development phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jmagly/aiwg workspace-health

For use in Claude.ai and ChatGPT

Download Skill