Can I use this for greenfield projects?

No, this skill is specifically for existing codebases. For new projects, you should use the /pre-dev-* series of skills.

What is required to start a refactor process?

The skill requires a 'docs/PROJECT_RULES.md' file to exist, which serves as the baseline for all standards and architectural expectations it will measure the code against.

What is the Mandatory Gap Principle?

It is a non-negotiable rule within the skill where every divergence from project standards must be tracked as a finding, regardless of severity or cosmetic nature, ensuring no technical debt goes unnoticed.

Which architecture patterns does the skill enforce?

The skill intelligently applies Hexagonal/Clean Architecture and Domain-Driven Design (DDD) patterns to CRUD APIs and complex services, while remaining flexible for simple scripts and CLI tools.

Dev Refactor: Standards-Driven Modernization

Name: Dev Refactor: Standards-Driven Modernization
Author: LerianStudio

byLerianStudio

•

Developer Tools

Analyzes existing codebases against engineering standards to generate structured, actionable refactoring tasks for AI-driven development cycles.

About

The Dev Refactor skill provides an automated, standards-first approach to technical debt reduction and codebase modernization. By enforcing the 'Mandatory Gap Principle,' the skill ensures that 100% of architectural divergences are tracked, removing subjectivity from the auditing process. It intelligently detects service types to apply appropriate patterns—such as Hexagonal Architecture and DDD for APIs—while orchestrating specialized agents (Golang, TypeScript, Frontend) to perform deep analysis. The result is a comprehensive roadmap of findings and tasks seamlessly integrated into the dev-cycle workflow.

Key Features

Automated Architecture Applicability (Hexagonal/DDD detection)
Codebase-Explorer Agent for high-fidelity architectural mapping
17 GitHub stars
Mandatory Gap Tracking for 100% standards compliance
Multi-Stack Support (Go, TypeScript, React, and BFF patterns)
Direct dev-cycle handoff for immediate task execution

Use Cases

Modernizing legacy codebases to align with current project standards
Conducting architectural audits and technical debt assessments
Standardizing patterns across microservices and monorepos

About

Key Features

Automated Architecture Applicability (Hexagonal/DDD detection)
Codebase-Explorer Agent for high-fidelity architectural mapping
17 GitHub stars
Mandatory Gap Tracking for 100% standards compliance
Multi-Stack Support (Go, TypeScript, React, and BFF patterns)
Direct dev-cycle handoff for immediate task execution

Use Cases

Modernizing legacy codebases to align with current project standards
Conducting architectural audits and technical debt assessments
Standardizing patterns across microservices and monorepos