aios-structure-validate

Validates an AIS-OS project file tree against a frozen starter-kit baseline using SHA-256 hash comparison.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill aios-structure-validate-sebaperiesdigit-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aios-structure-validate
Source: https://github.com/sebaperiesdigit-create/Peries-Skills-Master/tree/main/.claude/skills/aios-structure-validate
Command: npx skills add https://github.com/sebaperiesdigit-create/Peries-Skills-Master --skill aios-structure-validate-sebaperiesdigit-create

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It detects when an AIS-OS project has drifted from the frozen starter-kit baseline — missing files, altered structural content, non-empty placeholders, or anti-pattern folders — without ever modifying the scanned project. ## Core Features & Use Cases - Baseline conformance scan: Compares the current directory against a manifest of 14 hash-verified templates, reporting missing items, structural drift, non-empty placeholders, and unrecognized anti-pattern folders with concrete fix instructions. - Three-tier content policy: Content-mutable files (CLAUDE.md, aios-intake.md) are checked for presence only, structural files are hash-compared exactly, and placeholder files must be zero bytes. - Safe non-AIS-OS detection: Exits with a redirect message if no distinctive AIS-OS files exist, avoiding noisy false reports in unrelated projects. - Use Case: After weeks of editing your AIS-OS project, run /aios-structure-validate to confirm the file tree still matches the baseline and optionally save a dated report to validations/. ## Quick Start Run /aios-structure-validate from the root of your AIS-OS project to scan it against the frozen baseline and review the categorized report.

Frequently Asked Questions about aios-structure-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate my AIS-OS project structure against the starter-kit baseline?▼

Run /aios-structure-validate from your project root. The bundled PowerShell script compares your file tree against a manifest of 14 hash-verified templates and reports missing items, structural drift, non-empty placeholders, and unrecognized folders with fix instructions.

What is the difference between /audit and aios-structure-validate?▼

The /audit skill scores AIOS maturity out of 100 across the Four Cs (Context, Connections, Capabilities, Cadence). aios-structure-validate is a narrow pass/fail structural check of whether your file tree literally matches the frozen baseline, with no score.

Does aios-structure-validate modify my project files?▼

No. The scan is read-only. The only possible write is an optional validation report saved to validations/validate-{date}.md, and only after you explicitly consent via a prompt after each scan.

Why does the validator not flag changes to my CLAUDE.md content?▼

CLAUDE.md, aios-intake.md, connections.md, and decisions/log.md are content-mutable files checked for presence only. Being filled in by /onboard is expected healthy state, so content changes are never flagged as drift.

What happens if I run the validator in a non-AIS-OS project?▼

The script checks for 7 distinctive AIS-OS identifier files first. If none exist, it exits with code 2 and a redirect message suggesting aios-structure-build instead, avoiding a noisy everything-is-missing report.

What are the limitations of aios-structure-validate?▼

It only checks structural conformance, not maturity or capability. It never flags EXPANSIONS.md-sanctioned growth folders or extra skills, never recurses into node_modules or .git, and requires PowerShell 5.1 on the machine running the scan.