scan-structural
OfficialPrioritize structural refactors for clarity
Authorsncollective
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Scans the monorepo for organization and layout issues and delivers a prioritized, actionable structural refactor backlog so engineering teams can improve navigability, reduce coupling, and lower maintenance cost.
Core Features & Use Cases
- Rule-driven analysis: Checks route file size, thin handlers vs services, route utilities separation, component splitting by concern, one-domain schema placement, flat services guidance, and test mirror structure.
- Prioritized backlog output: Produces High Value, Worth Considering, and Not Worth It tiers with affected files, current vs target layouts, implementation notes, and testable acceptance criteria.
- Use Case: Run during a tech-debt audit or sprint planning to produce a migration plan for oversized route files, misplaced utilities, and component fragmentation.
Quick Start
Run a repository scan and write the prioritized structural refactor backlog to docs/structural-refactor-backlog.md in the platform directory.
Dependency Matrix
Required Modules
None requiredComponents
references
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: scan-structural Download link: https://github.com/sncollective/snc-platform/archive/main.zip#scan-structural Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.