# Busirocket Refactor Workflow

> Enforces strict refactoring workflow for TypeScript/React codebases. Use when refactoring files with multiple exports, splitting components/hooks/utils, moving inline types to types/, and enforcing post-refactor quality gates.

- Skill: `busirocket/busirocket-refactor-workflow` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add busirocket/busirocket-refactor-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/busirocket/busirocket-refactor-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: busirocket (https://skillmd.com/u/busirocket)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/busirocket/busirocket-refactor-workflow

---


# Refactor Workflow

Strict, step-by-step refactoring guidance for maintaining code quality.

## When to Use

Use this skill when:

- Refactoring files with multiple exports (use `@file` workflow)
- Splitting components/hooks/utils into smaller files
- Moving inline types to `types/`
- Enforcing post-refactor quality checks

## Non-Negotiables (MUST)

- After any refactor: run the project's standard checks (e.g. `yarn check:all`)
  as a mandatory quality gate.
- If a file has multiple responsibilities, split immediately.
- If a hook/component contains helpers, extract them.
- If a file declares types inline, move them to `types/`.
- Never use index/barrel files; import from concrete modules only.

## @file Refactor Workflow

When referencing `@file` for a one-shot refactor:

- Exactly one exported symbol per file.
- No inline `interface`/`type` declarations in non-type files.
- No helper functions inside components/hooks.

## Rules

### @file Refactor Workflow

- `refactor-file-workflow` - @file refactor workflow (strict constraints)
- `refactor-mandatory-checks` - Mandatory checks after refactor

### Refactoring TypeScript/React

- `refactor-goals` - Goals for refactoring (many small files, one export per
  file)
- `refactor-decision-rules` - Decision rules for when to split files
- `refactor-never-index-files` - Never use index files
- `refactor-post-refactor-checks` - Post-refactor checks (MANDATORY)

### Post-Refactor Checks

- `refactor-golden-path` - Golden path for post-refactor checks
- `refactor-file-size-guidelines` - File size targets and max lines
- `refactor-if-something-fails` - What to do if checks fail
- `refactor-when-to-split` - Fast heuristics for when to split files

## Related Skills

- `busirocket-core-conventions` - File structure and boundaries
- `busirocket-typescript-standards` - TypeScript standards to enforce
- `busirocket-react` - Component/hook patterns

## How to Use

Read individual rule files for detailed explanations and code examples:

```
rules/refactor-file-workflow.md
rules/refactor-decision-rules.md
rules/refactor-post-refactor-checks.md
```

Each rule file contains:

- Brief explanation of why it matters
- Code examples (correct and incorrect patterns)
- Additional context and best practices