What problem does it solve? AI agents rely on a well-structured .agents directory for project context, feature specs, memory handoffs, and reusable skills. Missing or malformed files cause hallucinated code, lost session state, and ignored constraints. This Skill audits every .agents directory in a workspace and reports exactly what is missing and how to fix it. ## Core Features & Use Cases - Structural Validation: Recursively finds all .agents directories and checks for required folders (specs, architecture, conventions, mcps, memory, skills) and files (AGENTS.md, context.md, system-overview.md). - Spec Completeness Checks: Verifies each feature folder contains spec.md, architecture.md, implementation.md, and decisions.md, with errors for critical gaps and warnings for optional ones. - Human-Readable Diagnostics: Outputs formatted pass/warning/error logs explaining each issue, why it matters, and how to fix it, plus a summary with exit codes for CI use. - Use Case: Before starting a new feature, run the validator to confirm your spec-driven development setup is complete so AI agents load the correct requirements and constraints. ## Quick Start Run the validation script against my workspace and report any missing or malformed .agents directory files.
