Description
The Repository Quality audit for 2026-04-30 analyzed 735 source files (171,448 total lines) and identified 6 files exceeding 900 lines, violating the AGENTS.md 300-line guideline and the general principle of small, focused files. These files have grown through feature additions without corresponding decomposition.
Large files increase cognitive load, slow code review, and accumulate future technical debt faster. The audit report (discussion #29317) provides specific decomposition recommendations for each file — the most impactful split opportunities are already identified.
The task is to: (1) review the decomposition plan from the audit, (2) split each oversized file into focused modules per AGENTS.md size guidelines, (3) update imports, and (4) run the test suite to verify no regressions.
Expected Impact
AGENTS.md compliance for 6 files, improved code reviewability, and reduced cognitive load for contributors. Establishes a precedent for proactive file size management.
Suggested Agent
Code Simplifier, Refactoring Cadence, or a dedicated decomposition agent.
Estimated Effort
Medium (1–4 hours): 6 files × moderate split complexity, with test verification.
Data Source
Generated by DeepReport - Intelligence Gathering Agent · ● 573.9K · ◷
Description
The Repository Quality audit for 2026-04-30 analyzed 735 source files (171,448 total lines) and identified 6 files exceeding 900 lines, violating the AGENTS.md 300-line guideline and the general principle of small, focused files. These files have grown through feature additions without corresponding decomposition.
Large files increase cognitive load, slow code review, and accumulate future technical debt faster. The audit report (discussion #29317) provides specific decomposition recommendations for each file — the most impactful split opportunities are already identified.
The task is to: (1) review the decomposition plan from the audit, (2) split each oversized file into focused modules per AGENTS.md size guidelines, (3) update imports, and (4) run the test suite to verify no regressions.
Expected Impact
AGENTS.md compliance for 6 files, improved code reviewability, and reduced cognitive load for contributors. Establishes a precedent for proactive file size management.
Suggested Agent
Code Simplifier, Refactoring Cadence, or a dedicated decomposition agent.
Estimated Effort
Medium (1–4 hours): 6 files × moderate split complexity, with test verification.
Data Source