How is the compliance score calculated?

The score is calculated by the ratio of correct patterns to total components, with critical violations—such as a Manager being incorrectly implemented as a Skill—carrying double weight.

Does the Architecture Validator modify my code?

No, it is a read-only tool that analyzes your project files and returns a structured JSON report without making any changes to your source files.

What architectural patterns does this skill validate?

It primarily validates the Manager-as-Agent and Director-as-Skill patterns, ensuring Managers handle state and orchestration while Directors focus on pattern expansion.

What happens if an architectural violation is found?

The skill returns a detailed violation report that includes the specific rule broken, evidence found in the code, and a recommended migration path to achieve compliance.

Architecture Validator

Name: Architecture Validator
Author: fractary

$fractary$ byfractary

•

Security & Testing

Validates Claude Code project architectures against Fractary standards for Manager-as-Agent and Director-as-Skill patterns.

The Architecture Validator skill is a specialized tool for Claude Code designed to automate the auditing of project structures according to Fractary's architectural standards. It systematically identifies anti-patterns, such as Managers incorrectly implemented as Skills or Directors misconfigured as Agents, and provides detailed compliance reports with weighted scoring. By checking tool configurations, orchestration phases, and file locations, it ensures that AI-driven projects maintain high structural integrity while providing clear migration paths for correcting architectural drift without modifying your source code.

Key Features

01Read-only validation ensuring no accidental modifications to project source code

02Detailed compliance reporting with weighted scoring and grading

03Specific violation detection with file path and line number evidence

04Migration path recommendations for correcting architectural anti-patterns

052 GitHub stars

06Automated pattern validation for Manager-as-Agent and Director-as-Skill models

Use Cases

01Identifying structural tech debt during the migration of Skills to Agents

02Auditing a new AI agent project for compliance with standard architectural patterns

03Continuous integration checks to prevent architectural drift in complex multi-agent systems

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins architecture-validator

For use in Claude.ai and ChatGPT

Download Skill