project-structure-validator

Validate modular decomposition in project_structure.md against architectural principles.

5|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/tikazyq/agentic-spec-forge --skill project-structure-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-structure-validator
Source: https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/implementation_planning/project-structure-validator
Command: npx skills add https://github.com/tikazyq/agentic-spec-forge --skill project-structure-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of ensuring a well-defined and feasible modular decomposition for software projects, preventing issues like circular dependencies and unclear responsibilities early in the implementation planning phase.

Core Features & Use Cases

  • Module Validation: Assesses the modularity defined in project_structure.md against architectural principles.
  • Dependency Analysis: Detects circular dependencies and identifies modules with overlapping or unclear responsibilities.
  • Use Case: Before committing to a complex project structure, use this Skill to stress-test the proposed module breakdown, ensuring each module has a clear purpose and minimal interdependencies, thereby reducing future refactoring efforts.

Quick Start

Validate the project structure defined in spec/implementation/project_structure.md.

Frequently Asked Questions about project-structure-validator

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

FAQPage Schema
How do I validate project modularity before implementation planning?

To validate project modularity, stress-test your structure file against architectural principles to assess module independence and detect overlapping responsibilities. This ensures feasible module definitions and reduces future refactoring efforts early in implementation planning.

How can I detect circular dependencies in my proposed project structure?

Detect circular dependencies in your project structure by analyzing the defined modules for interdependencies that form loops. This validation process identifies circular references and highlights modules with unclear boundaries before you commit to the architecture.

What is the best way to identify modules with overlapping responsibilities in software architecture?

Identifying modules with overlapping responsibilities involves analyzing your project structure to find boundaries where multiple modules perform similar tasks. This architectural validation process detects unclear module definitions and ensures each component maintains strict independence.

When do I need to run a dependency analysis on my project structure?

You need to run a dependency analysis when committing to a complex project structure during implementation planning. This process stress-tests proposed module breakdowns to ensure clear purposes and minimal interdependencies, preventing architectural issues early.

Does project structure validation require a specific file format for module definitions?

Project structure validation requires a markdown file defining your proposed modules, typically located at spec/implementation/project_structure.md. The validator assesses this file against architectural principles to detect circular dependencies and unclear module boundaries.