nw-command-optimization-workflow

To refactor oversized command files into lean declarative definitions, use a multi-phase workflow covering Analyze, Extract, Restructure, Validate, and Measure to systematically remove duplication and extract domain knowledge to agents.

The best way to modularize a large command repository is by adopting the forge.md pattern, which extracts shared boilerplate and moves domain knowledge to agents to enable reusable, composable command definitions with clear agent invocations.

You need to extract domain knowledge to agents when command files reach 500-2400 lines and require modularization, orchestration, and declarative templates to reduce command size and complexity for improved maintainability.

Yes, you can reduce command file size from 2000 lines to under 300 lines by feeding the oversized command file into this workflow to generate a lean declarative definition and improve maintainability.

The command optimization workflow validates refactored declarative templates through a defined Validate phase, ensuring modular, testable commands maintain clear agent invocations and produce measurable size reductions during the orchestration process.

Refactoring commands into declarative definitions is limited to large repositories where oversized command files require modularization, orchestration, and declarative templates to achieve measurable size reductions and improve maintainability through a multi-phase, auditable workflow.