Operations
AuraScore 83/100

Architecture Technical Debt Refactoring Operational Brief

Create an executive engineering operations brief to prioritize legacy codebase refactoring against delivery velocity.

Use this template when planning technical debt remediation cycles or justifying platform re-architecture to engineering leadership. It frames architectural degradation in terms of operational risk, deployment friction, and infrastructure cost.

Template

Role: VP of Engineering Operations and Principal Enterprise Software Architect

Context

  • Target Codebases & Services: {{legacy_service_inventory}}
  • Performance & Scaling Chokepoints: {{throughput_bottlenecks}}
  • Code Quality & Maintainability Signals: {{cyclomatic_complexity_reports}}
  • Competing Product Roadmap Demands: {{quarterly_feature_commitments}}
  • Infrastructure & Cloud Cost Ceilings: {{infrastructure_budget_cap}}
  • Reliability & Performance Targets: {{target_sla_targets}}

Task

Draft a technical debt refactoring brief that justifies and operationalizes targeted architectural remediation while protecting delivery commitments and remaining within defined infrastructure constraints.

Method

  1. Cross-reference {{legacy_service_inventory}} with {{cyclomatic_complexity_reports}} to locate high-churn, high-risk modules.
  2. Quantify the operational drag imposed by {{throughput_bottlenecks}} on ongoing release cadence and system concurrency.
  3. Evaluate the risk profile of deferred refactoring against the reliability goals set in {{target_sla_targets}}.
  4. Align candidate refactoring phases with {{quarterly_feature_commitments}} to mitigate scheduling collisions.
  5. Model resource allocation to ensure refactoring tasks respect {{infrastructure_budget_cap}}.
  6. Structure a phased migration path using patterns such as strangler-fig or anti-corruption layers.
  7. Define explicit cutover triggers, rollback criteria, and automated verification benchmarks for each phase.

Constraints

  • MUST justify every refactoring initiative with measurable engineering metrics (e.g., MTTR, deploy frequency, error budgets).
  • MUST NOT propose full ground-up rewrites without incremental, deployable operational phases.
  • Budget and roadmap trade-offs MUST be stated explicitly with mitigation plans.
  • The output must follow strict concise brief formatting under 650 words.

Output format

Generate the brief using these required sections:

  • Strategic Architectural Context
  • Operational Drag & Vulnerability Assessment
  • Phased Refactoring Roadmap (Phase, Target Component, Decoupling Strategy, Deliverable)
  • Resource Allocation & Delivery Risk Trade-Offs

Self-review

  • Ensure every architectural claim connects back to operational risk or performance.
  • Verify that each phase yields independently deployable system increments.
  • Confirm all 6 input variables are logically integrated.
AuraScore breakdown
83/100Provisional
Instruction clarity15/15 · Strong

Explicit role, a named task, and discrete steps the model can follow.

Context architecture12/12 · Strong

Background, inputs and variables the model needs before it starts.

Constraint engineering12/12 · Strong

Hard boundaries — what the model must and must not do.

Output specification6/14 · Thin

A named, field-level shape for the response.

Reasoning structure10/10 · Strong

Ordered work items that force analysis before an answer.

Model compatibility10/10 · Strong

Length and structure that travel across frontier models.

Token efficiency7/10 · Adequate

Signal density — instruction weight without padding.

Reusability7/7 · Strong

Documented variables so the scaffold adapts to new inputs.

Robustness3/5 · Adequate

Quality bar, assumptions and behaviour when inputs are thin.

Observed performance1/5 · Thin

How much real usage the template has behind it.

business-strategy
business-operations
software-engineering-debugging
technical-debt
system-architecture
engineering-ops