architecture-agent

Audits project file organization and enforces feature-based frontend and service-based backend architectures.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/pu-roi/LANES --skill architecture-agent-pu-roi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-agent
Source: https://github.com/pu-roi/LANES/tree/main/.agents/skills/architecture-agent
Command: npx skills add https://github.com/pu-roi/LANES --skill architecture-agent-pu-roi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large projects accumulate redundant files, bloated folders, and code that drifts away from the intended architecture. This Skill audits the LANES project structure against DESIGN.md and proposes safe, user-approved cleanup and reorganization plans. ## Core Features & Use Cases - Architecture Enforcement: Verifies the frontend follows Feature-Based Architecture in src/features/ and the backend follows Service-Based Architecture across api/, services/, and crud/ layers. - Redundancy Detection: Identifies unused, deprecated, or duplicated files and code that can be safely removed. - Interactive Restructuring: Presents multiple reorganization options with a justified recommendation, and only executes changes after explicit user approval. - Use Case: After several sprints, the backend services folder has grown cluttered. Ask the agent to audit it, and it will cross-reference DESIGN.md, flag violations, and propose a cleanup plan you can approve option by option. ## Quick Start Ask the agent to audit the backend folder for architectural violations and propose a reorganization plan with options.

Frequently Asked Questions about architecture-agent

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

FAQPage Schema
How do I audit a project folder for architectural violations?▼

Point the agent at the target folder and it will inspect the directory, cross-reference findings against DESIGN.md, and report duplicated logic, bloated folders, or files violating the architectural boundaries. It then proposes a reorganization plan for your approval.

How to enforce feature-based frontend and service-based backend architecture?▼

The agent checks that frontend code lives in domain-driven modules under src/features/ and backend code follows the layered api/, services/, and crud/ structure. Any file placed outside these boundaries is flagged during the audit.

Can the architecture agent delete or move files automatically?▼

No. The agent never renames, moves, or deletes files unilaterally. It must first present findings with clear options and a recommendation, then executes changes only after you explicitly approve an option.

What are the limitations of automated architecture audits?▼

The audit relies on DESIGN.md as the source of truth, so outdated design docs reduce accuracy. It also detects structural and redundancy issues, not runtime behavior or code correctness, which require testing and code review.