team-arch-opt

What problem does it solve?

This Skill helps teams systematically improve an existing codebase’s architecture by coordinating analysis, refactoring design, implementation, and verification—without skipping safety checks.

Core Features & Use Cases

• Unified multi-agent pipeline: Analyzer → Designer → Refactorer → Validator + Reviewer with structured outputs at each stage.
• Parallel refactoring strategies: Supports single, fan-out (branch-by-refactor), independent (multi-target), and auto mode that chooses an approach based on refactoring count.
• Review-fix safety loop: Automatically creates targeted fix tasks when validation or review reports issues.
• Evidence-based deliverables: Produces baseline metrics, ranked architecture issues, a prioritized refactoring plan, validation results, and a review report.

Quick Start

Run a coordinated architecture optimization session by giving the task description “Refactor the gateway runtime modules to reduce coupling and improve layering in the tecton repository.”