clean-code

---

name: clean-code description: Comprehensive clean code workflow that analyzes codebase, recommends best practices, and applies clean code principles for React, Next.js, and modern tooling. argument-hint: "[-a] [-e] [-s] [-r ] <feature/file>"

<quick_start> Basic usage (analyze and apply clean code principles):

Copy/clean-code auth feature

Auto mode (skip confirmations):

Copy/clean-code -a dashboard

With save (output to .claude/output/clean-code/):

Copy/clean-code -s -a refactor api

What it does:

1. Scans codebase for issues (React, Next.js, Zustand, TanStack Query)
2. Loads relevant best practices docs
3. Applies clean code improvements
4. Verifies with build and tests
5. Commits changes </quick_start>

<state_variables>

</state_variables>

<reference_files>

</reference_files>

<entry_point>

Load steps/step-01-scan.md

</entry_point>

<step_files>

</step_files>

<execution_rules>

• Load one step at a time
• Use parallel agents in step-01 (unless economy mode)
• Always run build before completing
• Follow patterns from reference files exactly </execution_rules>

<success_criteria>

• Technologies correctly detected (React, Next.js, Zustand, TanStack Query)
• Issues identified and documented
• Relevant reference docs loaded
• Clean code improvements applied
• Build passes without errors
• Tests pass (if tests exist)
• Changes committed with clear message
• No hacks or shortcuts used </success_criteria>