Numerical Simulation Troubleshooting Knowledge Taxonomy and Defect Analysis
Analyze computational simulation failure modes and engineer an error diagnostic taxonomy for research software knowledge bases.
Use this template when computational research platforms suffer from high support handle times due to fragmented troubleshooting guides. It extracts root-cause error signatures from numerical solver telemetry and restructures them into a diagnostic knowledge taxonomy.
Role: Senior Quantitative Research Operations Specialist specializing in scientific computing reproducibility and numerical solver diagnostic frameworks.
Context
- Computational Framework: {{computational_framework}}
- Knowledge Base Repository: {{numerical_kb_repository}}
- Error Distribution Telemetry: {{error_distribution_telemetry}}
- Solver Algorithm Family: {{solver_algorithm_family}}
- User Expertise Profile: {{user_expertise_profile}}
- SLA Breach Thresholds: {{sla_breach_thresholds}}
Task
Conduct an in-depth numerical failure mode analysis and construct an authoritative diagnostic troubleshooting taxonomy across {{numerical_kb_repository}} to accelerate ticket resolution times for {{solver_algorithm_family}} simulations.
Method
- Analyze {{error_distribution_telemetry}} to identify the top numerical failure modes (e.g., non-convergence, ill-conditioned matrices, floating-point overflows).
- Audit existing articles in {{numerical_kb_repository}} to locate outdated parameter recommendations or missing solver flags for {{computational_framework}}.
- Map error codes to underlying mathematical causes within {{solver_algorithm_family}} rather than generic operating system error descriptions.
- Calibrate diagnostic guidance steps to the technical capability of {{user_expertise_profile}}.
- Benchmark current resolution workflows against {{sla_breach_thresholds}} to pinpoint diagnostic bottlenecks.
- Formulate a multi-tier decision logic taxonomy organizing errors by symptom, mathematical condition, and verified mitigation step.
- Draft comprehensive remediation guidelines for articles contributing directly to prolonged investigation times.
Constraints
- Troubleshooting steps MUST explicitly specify convergence tolerances, preconditioner configurations, and mesh criteria.
- You MUST NOT recommend generic solver restarts or reinstallations as valid resolution steps.
- Analysis MUST isolate hardware-induced memory faults from algorithmic instability.
- All recommendations must maintain fidelity to {{computational_framework}} capabilities.
Output format
Structure the deliverable into four sequential sections:
- Telemetry and Knowledge Base Gap Audit: 150-word overview of solver instability drivers and article coverage gaps.
- Root-Cause Diagnostic Taxonomy: Hierarchical taxonomy classifying Error Signature, Mathematical Root Cause, Inadequate Existing KB Guidance, and Defect Severity.
- Step-by-Step Remediation Protocols: 3 detailed, deterministic diagnostic scripts for Tier-2 support engineers.
- SLA Optimization Strategy: 3-5 concrete knowledge modifications to eliminate breaches defined in {{sla_breach_thresholds}}.
Self-review
- Ensure every numerical remedy provides concrete mathematical parameter adjustments.
- Confirm all 6 input variables are explicitly utilized.
- Verify diagnostic scripts do not rely on non-deterministic workarounds.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.