team-code-refactor

Coordinate architect-directed code refactoring within an existing review team using pyright validation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sunbluesome/dotfiles --skill team-code-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-code-refactor
Source: https://github.com/sunbluesome/dotfiles/tree/main/.claude/ds/skills/team-code-refactor
Command: npx skills add https://github.com/sunbluesome/dotfiles --skill team-code-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables architect-directed refactoring to occur inside an existing review team without creating new teams, keeping governance intact and ensuring alignment with the action plans.

Core Features & Use Cases

  • Shut down non-critical reviewers to streamline the team for Phase 5 refactoring.
  • Spawn a single refactorer into the existing team and load mandatory skills.
  • Assign a concrete action plan to the refactorer and coordinate with the architect.
  • Implement changes, verify with pyright, and perform cleanup after validation.
  • Ensure governance by using the approved action plan and team lifecycle commands.

Quick Start

Load this skill after the team-code-review phase and follow the action plan to refactor in the existing team.

Frequently Asked Questions about team-code-refactor

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

FAQPage Schema
How do I perform architect-directed code refactoring within an existing team?

Architect-directed code refactoring within an existing team is handled by loading the coding skill into a single refactorer, assigning an action plan, and verifying changes with pyright. This keeps team governance intact and coordinates refactoring via message exchanges.

What is the best way to coordinate a team code refactor without creating new teams?

The best way to coordinate a team code refactor without creating new teams is to spawn a single refactorer into the existing review team, assign tasks using the team name, and apply an approved action plan to ensure alignment and governance.

How do I verify code quality during a team refactoring phase?

You verify code quality during team refactoring by running pyright validation after each change group. This ensures type safety and code quality are maintained before performing final cleanup operations.

Can I use pyright validation to check changes during an in-place team refactor?

Yes, pyright validation is used to check changes during an in-place team refactor. The architect directs the single refactorer to implement changes, and pyright verification is performed after each change group to ensure code quality.

Do I need an existing review team to start an architect-led refactor?

Yes, you need an existing review team from a previous code review phase to start an architect-led refactor. The skill shuts down non-critical reviewers and streamlines the existing team for Phase 5 refactoring using an approved action plan.

Why should I shut down non-critical reviewers before starting a team code refactor?

You should shut down non-critical reviewers before a team code refactor to streamline the existing team for Phase 5 refactoring. This allows the architect to focus coordination on a single refactorer executing the approved action plan with pyright validation.