project-structure

Audit codebase project structures and recommend file and module placement.

7|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/tartinerlabs/skills --skill project-structure-tartinerlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-structure
Source: https://github.com/tartinerlabs/skills/tree/main/skills/project-structure
Command: npx skills add https://github.com/tartinerlabs/skills --skill project-structure-tartinerlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams decide where code should live, how to group related files, and how to audit and improve project structure for maintainability and clarity.

Core Features & Use Cases

  • Colocation guidance to colocate related components, tests, and types within a feature or module.
  • Anti-pattern detection to surface and address common structural pitfalls like deep nesting, barrels, and scattered utilities.
  • Framework-aware and pattern-driven recommendations for feature-based or layer-based organization across frontend and backend projects.
  • Workflow-driven audits that produce prioritized recommendations and actionable fixes.

Quick Start

Analyze a repository to produce a recommended project-structure plan and an implementation path for reorganization.

Frequently Asked Questions about project-structure

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

FAQPage Schema
What is the best way to organize a monorepo project structure for scalability?

The best way to organize a monorepo project structure is by applying framework-aware conventions, detecting anti-patterns, and suggesting feature-based or layer-based structures to colocate related components, tests, and types within a feature or module.

How do I audit my codebase to find common architecture anti-patterns?

You can audit your codebase for common architecture anti-patterns by running a workflow-driven audit that surfaces structural pitfalls like deep nesting, barrels, and scattered utilities, then producing prioritized recommendations and actionable fixes.

Should I use feature-based or layer-based code organization for my frontend and backend?

Choosing between feature-based and layer-based code organization depends on your framework-aware conventions, as this Skill provides pattern-driven recommendations for grouping related files across both frontend and backend projects to maximize maintainability.

Does this project structure audit work with multi-language repositories?

Yes, the project structure audit works with multi-language repositories, applying framework-aware conventions to guide colocated components, grouping strategies, and architectural patterns across diverse codebases.

How do I implement colocation guidance for related components and tests?

To implement colocation guidance, the Skill audits your codebase to recommend optimal placement of files and modules, ensuring related components, tests, and types are grouped within a specific feature or module directory.