ringdev-refactor-frontend

name	ring:dev-refactor-frontend
description	Analyzes frontend codebase against Ring standards and generates refactoring tasks for ring:dev-cycle-frontend. Dispatches frontend-specific agents in ANALYSIS mode.
trigger	- User wants to refactor existing frontend project to follow standards - Legacy React/Next.js codebase needs modernization - Frontend project audit requested
skip_when	- Greenfield project -> Use /ring:pre-dev-* instead - Single file fix -> Use ring:dev-cycle-frontend directly - Backend-only project -> Use ring:dev-refactor instead
sequence	{"before":["ring:dev-cycle-frontend"]}
related	{"complementary":["ring:dev-refactor","ring:dev-cycle-frontend","ring:using-dev-team"]}
input_schema	{"required":[],"optional":[{"name":"project_path","type":"string","description":"Path to frontend project root (default: current directory)"},{"name":"prompt","type":"string","description":"Direct instruction for refactoring focus"},{"name":"standards_path","type":"string","description":"Custom standards file path (default: Ring standards via WebFetch)"},{"name":"analyze_only","type":"boolean","description":"Generate report without executing ring:dev-cycle-frontend"},{"name":"critical_only","type":"boolean","description":"Limit execution to Critical and High severity (analysis still tracks all)"},{"name":"dry_run","type":"boolean","description":"Show what would be analyzed without executing"}]}
output_schema	{"format":"markdown","artifacts":[{"name":"codebase-report.md","description":"Codebase analysis from ring:codebase-explorer"},{"name":"reports/{agent-name}-report.md","description":"Individual agent analysis reports"},{"name":"findings.md","description":"All findings mapped from agent reports"},{"name":"tasks.md","description":"1:1 mapped REFACTOR-XXX tasks from findings"},{"name":"change-report.html","description":"Visual HTML change report from ring:visual-explainer"}],"traceability":"Ring Standard -> Agent Report -> FINDING-XXX -> REFACTOR-XXX -> Implementation"}

Dev Refactor Frontend Skill

Analyzes existing frontend codebase against Ring/Lerian standards and generates refactoring tasks compatible with ring:dev-cycle-frontend.

---

Standards Loading (MANDATORY)

Before any step execution, you MUST load Ring standards.

Standards Source Resolution

if standards_path is provided:
  → Read tool: {standards_path}
  → If file not found or empty: STOP and report blocker
  → Use loaded content as frontend standards
else:
  → WebFetch the default Ring standards (see URLs below)

Default URLs (used when standards_path is not provided):

<fetch_required> https://raw.githubusercontent.com/LerianStudio/ring/main/CLAUDE.md https://raw.githubusercontent.com/LerianStudio/ring/main/dev-team/docs/standards/frontend.md </fetch_required>

Fetch URLs above and extract: Agent Modification Verification requirements, Anti-Rationalization Tables requirements, Critical Rules, and Frontend Standards.

<block_condition>

• standards_path provided but file not found or empty
• standards_path not provided AND WebFetch fails or returns empty
• CLAUDE.md not accessible </block_condition>

If any condition is true, STOP and report blocker. Cannot proceed without Ring standards.

---

MANDATORY GAP PRINCIPLE (NON-NEGOTIABLE)

any divergence from Ring standards = MANDATORY gap to implement.

<cannot_skip>

• All divergences are gaps - Every difference MUST be tracked as FINDING-XXX
• Severity affects PRIORITY, not TRACKING - Low severity = lower priority, not "optional"
• No filtering allowed - You CANNOT decide which divergences "matter"
• No alternative patterns accepted - Different approach = STILL A GAP
• No cosmetic exceptions - Naming, formatting, structure differences = GAPS </cannot_skip>

Non-negotiable, not open to interpretation - a HARD RULE.

Anti-Rationalization: Mandatory Gap Principle

See shared-patterns/shared-anti-rationalization.md for:

• Refactor Gap Tracking section (mandatory gap principle rationalizations)
• Gate Execution section (workflow skip rationalizations)
• TDD section (test-first rationalizations)

- Bash(command="find ... -name '*.tsx'") -> SKILL FAILURE - Bash(command="ls -la ...") -> SKILL FAILURE - Bash(command="tree ...") -> SKILL FAILURE - Task(subagent_type="Explore", ...) -> SKILL FAILURE - Task(subagent_type="general-purpose", ...) -> SKILL FAILURE - Task(subagent_type="Plan", ...) -> SKILL FAILURE