refine-architecture

Automate architecture refinement by spawning multiple reviewers to iteratively analyze and improve module depth and boundaries. The workflow orchestrates specialized assessments against your active epic's architecture files until quality thresholds are met.

Iterative architecture refinement is a cyclic process that applies specialized reviewers to assess design files, back up changes, and track progress across up to eight rounds. It enforces governance by loading decisions and maturity conventions to guide structured improvements.

Yes, automated architecture reviews require a repository of .goodplan/architecture files and an active epic. The workflow enforces these prerequisites and loads existing decisions and maturity conventions to ground the reviewer context before making any changes.

Multi-reviewer architecture assessment improves subsystem boundaries by spawning Software Architecture and Holistic reviewers simultaneously. This dual perspective grounds the analysis in project decisions and enforces governance criteria to iteratively refine module depth until quality thresholds are satisfied.

Automated architecture refinement is limited to a maximum of eight iterations per run. The process automatically stops when quality thresholds are met, generating a final refinement report, and requires existing .goodplan/architecture files to function correctly.

The best way to orchestrate structured architecture reviews is to invoke an automated refinement command that handles reviewer spawning, backup creation, and progress tracking. This enforces governance and applies maturity conventions to generate a final refinement report.