name	team-cleanup
description	Technical debt and refactoring — analyze, refactor, and validate code improvements
argument-hint	<area or module to clean up>
disable-model-invocation	true
allowed-tools	Bash(git *), TaskCreate, TaskUpdate, TaskList, TaskGet

Cleanup — Technical Debt and Refactoring

Improve code quality, performance, and maintainability through targeted refactoring.

Area to clean up: $ARGUMENTS

Execution

With Agent Teams (recommended)

Enable with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Create a team and spawn teammates:

Create team named cleanup-<area-slug>
Spawn teammates: shipper, reviewer, full-stack-developer, database-admin (if data layer), documentor

Create the following task list with dependencies:

#	Task	Owner	Blocked By
1	Create branch `refactor/<area>` from main	shipper	—
2	Analyze code for smells, bottlenecks, and refactoring opportunities	reviewer	1
3	Refactor application code based on review findings	full-stack-developer	2
4	Refactor data layer based on review findings (if needed)	database-admin	2
5	Commit refactoring changes	shipper	3, 4
6	Run full test suite and validate	shipper	5
7	Update documentation for refactoring changes	documentor	6
8	Create PR to main with before/after summary	shipper	6, 7

Parallelism: Tasks 3 and 4 can run simultaneously after the review completes.

Without Agent Teams (fallback)

Execute sequentially using the Task tool:

Task(shipper, "Create branch refactor/<area> from main")
Task(reviewer, "Analyze $ARGUMENTS for code smells, bottlenecks, refactoring opportunities")
Task(full-stack-developer, "Refactor based on review findings: <findings>")
Task(database-admin, "Refactor data layer: <findings>") — only if needed
Task(shipper, "Commit changes: refactor: <description>")
Task(shipper, "Run full test suite, validate no regressions")
Task(documentor, "Update docs for refactoring changes in: $ARGUMENTS")
Task(shipper, "Create PR to main with before/after summary")

Workflow Diagram

┌─────────┐     ┌──────────┐     ┌──────────────────┐     ┌─────────┐     ┌─────────┐     ┌────────────┐     ┌─────────┐
│ Shipper │────►│ Reviewer │────►│ Full Stack Dev   │────►│ Shipper │────►│ Shipper │────►│ Documentor │────►│ Shipper │
│ Branch  │     │ Analyze  │     │ + DB Admin (||)  │     │ Commit  │     │  Test   │     │ Update Docs│     │  PR     │
└─────────┘     └──────────┘     │ Refactor         │     └─────────┘     └─────────┘     └────────────┘     └─────────┘
                     │           └──────────────────┘
              [Identify Issues]
              [Prioritize]

Más de este repositorio

mismo repositorio

team-ship

bryanweaver/claude-agent-kit

Build and deploy features — branch, implement, commit, review, test, deploy, PR/merge

2026-06-162

shadcn-components

bryanweaver/claude-agent-kit

shadcn/ui component patterns including Radix UI primitives, CVA variants, form components with React Hook Form, and Tailwind CSS styling. Use when creating UI components, building forms, implementing design systems, or working with shadcn/ui.

2026-02-272

team-add-tests

bryanweaver/claude-agent-kit

Add critical test coverage — tests ONLY for functionality that could cause production disasters

2026-02-272

team-all-tools

bryanweaver/claude-agent-kit

List all available tools with their signatures and purposes

2026-02-272

team-audit

bryanweaver/claude-agent-kit

Analyze Claude Code audit logs — session summaries, metrics, timelines, anomaly detection, and claim verification

2026-02-272

team-create-agent

bryanweaver/claude-agent-kit

Create a new custom agent using the meta-agent with guided requirements gathering

2026-02-272

Cleanup — Technical Debt and Refactoring

Improve code quality, performance, and maintainability through targeted refactoring.

Area to clean up: $ARGUMENTS

Execution

With Agent Teams (recommended)

Enable with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Create a team and spawn teammates:

Create team named cleanup-<area-slug>

Spawn teammates: shipper, reviewer, full-stack-developer, database-admin (if data layer), documentor

Create the following task list with dependencies:

Task

Owner

Blocked By

Create branch refactor/<area> from main

shipper

—

Analyze code for smells, bottlenecks, and refactoring opportunities

reviewer

Refactor application code based on review findings

full-stack-developer

Refactor data layer based on review findings (if needed)

database-admin

Commit refactoring changes

shipper

3, 4

Run full test suite and validate

shipper

Update documentation for refactoring changes

documentor

Create PR to main with before/after summary

shipper

6, 7

Parallelism: Tasks 3 and 4 can run simultaneously after the review completes.

Without Agent Teams (fallback)

Execute sequentially using the Task tool:

Task(shipper, "Create branch refactor/<area> from main")

Task(reviewer, "Analyze $ARGUMENTS for code smells, bottlenecks, refactoring opportunities")

Task(full-stack-developer, "Refactor based on review findings: <findings>")

Task(database-admin, "Refactor data layer: <findings>") — only if needed

Task(shipper, "Commit changes: refactor: <description>")

Task(shipper, "Run full test suite, validate no regressions")

Task(documentor, "Update docs for refactoring changes in: $ARGUMENTS")

Task(shipper, "Create PR to main with before/after summary")

Workflow Diagram

┌─────────┐ ┌──────────┐ ┌──────────────────┐ ┌─────────┐ ┌─────────┐ ┌────────────┐ ┌─────────┐ │ Shipper │────►│ Reviewer │────►│ Full Stack Dev │────►│ Shipper │────►│ Shipper │────►│ Documentor │────►│ Shipper │ │ Branch │ │ Analyze │ │ + DB Admin (||) │ │ Commit │ │ Test │ │ Update Docs│ │ PR │ └─────────┘ └──────────┘ │ Refactor │ └─────────┘ └─────────┘ └────────────┘ └─────────┘ │ └──────────────────┘ [Identify Issues] [Prioritize]