cto-review

What problem does it solve?

This Skill identifies and quantifies architectural and data-flow complexity in a branch diff, prioritizing algorithmic and pipeline simplifications over cosmetic changes to reduce long-term maintenance burden and runtime inefficiencies.

Core Features & Use Cases

• Merge-base scoped diffs: Scopes analysis to git merge-base vs current working tree including staged, unstaged, and untracked production files.
• Data-flow first analysis: Prioritizes algorithmic and data-pipeline issues (redundant passes, state duplication, algorithm-problem mismatch).
• Quantified, verifiable proposals: Requires exact file paths and line numbers, concrete line-count eliminations, and ranked, shippable phases written to PLAN.md.
• Phased workflow & tooling: Parallel explore agents, Sonnet-class quantification, scorecard, and declined-suggestion tracking for iterative reviews.
• Use Case: Use this skill when preparing a branch for a large refactor or release to ensure simplifications are high-impact, behavior-preserving, and verifiable.

Quick Start

Run a CTO-level review of the current branch diff against a base ref and produce a ranked, line-numbered PLAN.md with concrete simplification steps.