dev-refactor

Detect Ring/Lerian standard divergences and generate FINDING-XXX and REFACTOR-XXX tasks.

205|26|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/LerianStudio/ring --skill dev-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-refactor
Source: https://github.com/LerianStudio/ring/tree/main/dev-team/skills/dev-refactor
Command: npx skills add https://github.com/LerianStudio/ring --skill dev-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes codebase against standards and generates refactoring tasks for dev-cycle.

Core Features & Use Cases

  • Standards gap detection: identifies divergences from Ring/Lerian standards.
  • Automated task generation: creates FINDING-XXX and REFACTOR-XXX tasks.
  • Non-negotiable rules: enforces mandatory gaps and anti-rationalizations.

Quick Start

Run refactor analysis against the current project to produce findings.md and tasks.md.

Frequently Asked Questions about dev-refactor

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

FAQPage Schema
How do I audit my codebase against Ring and Lerian standards?

Code auditing identifies divergences from Ring/Lerian standards by analyzing your existing codebase structure, patterns, and architecture compliance. This Skill scans CRUD APIs and complex services following Hexagonal/Lerian patterns to detect gaps and output findings as actionable refactoring tasks aligned with your standards.

What types of projects can I run refactor analysis on?

Refactor analysis applies to CRUD APIs and complex services built with Hexagonal/Lerian architecture across multi-context codebases. It excludes simple scripts, CLIs, workers, and single-file utilities, focusing on projects with substantive architectural patterns to analyze.

What output does a standards gap analysis produce?

Standards gap analysis generates findings.md and tasks.md files. Findings document all divergences as FINDING-XXX entries, while tasks.md contains REFACTOR-XXX actionable items aligned with Hexagonal/Lerian architecture and Lerian directory patterns for your dev cycle.

How does the Mandatory Gap Principle work in refactoring?

The Mandatory Gap Principle enforces that all detected divergences from standards are reported as findings regardless of severity, with no rationalizations allowed. This ensures comprehensive visibility into every standards violation so your team can prioritize refactoring systematically.

Can I use this for codebases not following Hexagonal architecture?

This Skill targets projects already built on Hexagonal/Lerian architectural patterns. Codebases without this foundational structure, or simple utilities and workers, fall outside its scope; it's designed for complex multi-context services requiring standards alignment.