This prompt is designed for AI evaluation engineers and agent platform teams who need to programmatically grade the quality of a model's problem decomposition strategy. The core job-to-be-done is turning a subjective assessment of 'did the model break this problem down well?' into a structured, repeatable score. You should use this when you are evaluating reasoning traces from agent planning, chain-of-thought outputs, or task decomposition modules, and you need to verify that the sub-problems are complete, logically independent, correctly ordered, and broken down to an appropriate level of granularity before the agent begins execution.
Prompt
Decomposition Strategy Quality Evaluation Prompt

When to Use This Prompt
Define the evaluation job, the ideal user, required context, and the constraints that make this prompt the right tool—or the wrong one.
The ideal user has a batch of reasoning traces and a reference definition of the original complex problem. You must provide the full reasoning trace and the original problem statement as inputs. This prompt is not a general-purpose quality rater; it is specifically calibrated for decomposition strategy. Do not use it to grade final answer correctness, factual accuracy, or stylistic quality. It is also a poor fit for single-step tasks where no decomposition occurs, or for evaluating creative brainstorming where divergent, overlapping ideas are a feature rather than a bug. If your agent's plan is already executing and you want to evaluate tool-use correctness, switch to a tool-use evaluation prompt instead.
Before wiring this into an automated pipeline, ensure you have a human-annotated calibration set to validate the LLM judge's scores against your team's standards. The output is a structured scorecard, not a binary pass/fail, so downstream systems should implement threshold logic based on your risk tolerance. For high-stakes agent workflows—such as those in healthcare, finance, or safety-critical operations—always route low decomposition scores for human review before allowing autonomous execution to proceed.
Use Case Fit
Where the Decomposition Strategy Quality Evaluation Prompt delivers reliable signal—and where it introduces noise or risk.
Good Fit: Agent Planning Traces
Use when: evaluating how an agent breaks a complex task into sub-tasks before execution. The prompt excels at grading decomposition completeness, sub-problem independence, and ordering logic in planning traces. Guardrail: Pair with a tool-use evaluation prompt to verify that the plan actually maps to executable tool calls.
Good Fit: Multi-Step Reasoning Audits
Use when: you need to verify that a reasoning trace properly decomposes a problem before solving it. The prompt checks whether sub-problems are distinct, non-overlapping, and sequenced correctly. Guardrail: Run before step-level correctness grading so you catch structural decomposition failures before chasing per-step errors.
Bad Fit: Single-Step Answers
Avoid when: the model output is a direct answer with no intermediate reasoning or decomposition. The prompt expects explicit sub-problem breakdown and will produce misleading low scores or hallucinated structure on flat responses. Guardrail: Pre-filter with a reasoning-trace detection check before routing to this evaluator.
Bad Fit: Creative or Open-Ended Generation
Avoid when: evaluating narrative, creative writing, or brainstorming where decomposition into independent sub-problems is not the intended structure. The prompt will penalize valid creative work for lacking formal decomposition. Guardrail: Use a task-type classifier to route creative outputs to appropriate quality rubrics instead.
Required Inputs
Requires: the full reasoning trace or planning output as [INPUT], plus an optional [TASK_DESCRIPTION] for context on what problem was being solved. Without the task description, the evaluator may misjudge whether sub-problems are appropriately scoped. Guardrail: Always include the original task or user query alongside the trace to ground decomposition relevance judgments.
Operational Risk: Judge Overconfidence
Risk: The LLM judge may assign high decomposition scores to traces that look well-structured but contain subtly merged or dependent sub-problems. Surface-level formatting can mask real decomposition failures. Guardrail: Spot-check a sample of high-scoring traces with human review, and cross-validate with the Step Dependency Mapping prompt to catch hidden coupling.
Copy-Ready Prompt Template
A reusable prompt template for evaluating decomposition strategy quality in reasoning traces, ready to copy and adapt for your evaluation pipeline.
This prompt template evaluates how well a reasoning trace decomposes a complex problem into sub-problems. It produces structured scores for decomposition completeness, sub-problem independence, ordering logic, and granularity appropriateness. The template uses square-bracket placeholders so you can swap in your own reasoning trace, evaluation rubric, output schema, and constraints without rewriting the core evaluation logic.
textYou are an expert evaluation judge specializing in problem decomposition quality. Your task is to evaluate how well a reasoning trace breaks down a complex problem into sub-problems. ## INPUT **Original Problem:** [ORIGINAL_PROBLEM] **Reasoning Trace to Evaluate:** [REASONING_TRACE] ## EVALUATION DIMENSIONS Evaluate the decomposition strategy across these four dimensions using the provided scoring scale: ### 1. Decomposition Completeness (1-5) - Does the trace identify all necessary sub-problems required to solve the original problem? - Are there missing sub-problems that would prevent a complete solution? - Score 5: All required sub-problems identified. Score 1: Critical sub-problems missing. ### 2. Sub-Problem Independence (1-5) - Are sub-problems defined so they can be solved independently where possible? - Does the trace avoid unnecessary coupling between sub-problems? - Score 5: Sub-problems are cleanly separated with minimal overlap. Score 1: Sub-problems are entangled and interdependent. ### 3. Ordering Logic (1-5) - Are sub-problems sequenced in a logical order where dependencies are respected? - Does the trace explain why certain sub-problems must precede others? - Score 5: Clear, justified ordering with explicit dependency reasoning. Score 1: Arbitrary or incorrect ordering that blocks progress. ### 4. Granularity Appropriateness (1-5) - Are sub-problems broken down to an appropriate level of detail? - Does the trace avoid over-decomposition (too fine-grained) or under-decomposition (too coarse)? - Score 5: Each sub-problem is actionable and appropriately scoped. Score 1: Sub-problems are either trivial or impossibly broad. ## OUTPUT SCHEMA Return a JSON object with this exact structure: { "overall_score": <float between 1.0 and 5.0>, "dimension_scores": { "decomposition_completeness": <int 1-5>, "sub_problem_independence": <int 1-5>, "ordering_logic": <int 1-5>, "granularity_appropriateness": <int 1-5> }, "strengths": [<list of specific strengths observed>], "weaknesses": [<list of specific gaps or issues>], "missing_sub_problems": [<list of sub-problems the trace should have included but didn't>], "ordering_issues": [<list of sequencing problems with step references>], "granularity_issues": [<list of over-decomposition or under-decomposition examples>], "overall_assessment": "<2-3 sentence summary of decomposition quality>" } ## CONSTRAINTS [CONSTRAINTS] ## EVALUATION INSTRUCTIONS 1. First, extract all sub-problems explicitly stated in the reasoning trace. 2. Compare against what a complete decomposition should include for this problem type. 3. Check whether sub-problems overlap or depend on each other unnecessarily. 4. Verify that the ordering respects actual dependencies. 5. Assess whether each sub-problem is scoped appropriately for solution. 6. Provide specific evidence from the trace for every score and finding. 7. If the trace is too short to evaluate decomposition, note this and score accordingly. ## EXAMPLES [EXAMPLES]
Adaptation guidance: Replace [ORIGINAL_PROBLEM] with the problem statement the model was given. Replace [REASONING_TRACE] with the full reasoning output you want to evaluate. Use [CONSTRAINTS] to add domain-specific rules such as required sub-problem categories, minimum sub-problem counts, or forbidden decomposition patterns. Use [EXAMPLES] to provide scored examples that calibrate the judge to your quality standards. If you need a different output shape, modify the JSON schema block directly. For high-stakes evaluation pipelines, add a confidence field to the output schema and require the judge to flag low-confidence assessments for human review.
Prompt Variables
Required inputs for the Decomposition Strategy Quality Evaluation Prompt. Each variable must be populated before the judge model can produce reliable scores.
| Placeholder | Purpose | Example | Validation Notes |
|---|---|---|---|
[REASONING_TRACE] | The full decomposition trace to evaluate | Step 1: Parse user request into intent and constraints. Step 2: Identify sub-problems: authentication, data fetch, formatting. Step 3: ... | Required. Must contain at least 3 reasoning steps. Reject if empty or fewer than 3 steps. Check for step delimiters (newlines, numbering, or bullet points). |
[ORIGINAL_PROBLEM] | The problem statement the trace attempts to decompose | Build a dashboard that shows real-time user activity across 3 data sources with role-based access control. | Required. Must be non-empty and describe a task or question. Used to verify that the decomposition addresses the stated problem rather than a different one. |
[DECOMPOSITION_CRITERIA] | The scoring dimensions and their weight definitions | completeness: Are all necessary sub-problems identified? independence: Can sub-problems be solved separately? ordering: Is the sequence logical? granularity: Are sub-problems at the right level of detail? | Required. Must define at least 2 criteria with descriptions. Each criterion must have a clear definition. Validate that criteria names match the output schema fields. |
[SCORING_SCALE] | The numeric or categorical scale for each criterion | 1-5 scale where 1=inadequate, 2=partial, 3=adequate, 4=good, 5=excellent | Required. Must define anchor points for each score value. Validate that scale bounds are explicit and each level has a behavioral description. Reject scales without anchor definitions. |
[DOMAIN_CONTEXT] | Optional domain-specific constraints or terminology | This is a backend engineering task. Sub-problems should reflect service boundaries, data contracts, and API design patterns. | Optional. If provided, use to calibrate granularity expectations and terminology. If null, judge uses general problem-solving standards. Validate that domain context does not contradict the original problem. |
[OUTPUT_SCHEMA] | The expected JSON structure for the evaluation output | {"overall_score": float, "criterion_scores": {"[criterion_name]": {"score": int, "justification": string}}, "missing_subproblems": [string], "ordering_issues": [string], "granularity_notes": string} | Required. Must be a valid JSON schema or example structure. Validate that schema fields match the decomposition criteria. Reject if schema is malformed or missing required fields. |
[FEW_SHOT_EXAMPLES] | Optional example evaluations showing expected scoring behavior | [{"trace": "Step 1: ...", "evaluation": {"overall_score": 4.2, ...}}, ...] | Optional. If provided, must contain at least 1 complete example with trace and evaluation. Validate that example scores are consistent with the scoring scale anchors. Use to calibrate judge behavior. |
[CONSTRAINTS] | Hard constraints the evaluation must respect | Do not penalize for missing sub-problems that are explicitly out of scope per the original problem. Flag over-decomposition (more than 15 sub-problems) as a granularity issue. | Optional. If provided, each constraint must be a clear, actionable rule. Validate that constraints do not conflict with each other or with the scoring criteria. Apply constraints after initial scoring as override rules. |
Implementation Harness Notes
How to wire the Decomposition Strategy Quality Evaluation Prompt into an evaluation pipeline with validation, retries, and human review gates.
This prompt is designed to run inside an automated evaluation harness, not as a one-off manual review tool. The typical integration point is after an agent or reasoning model has produced a decomposition trace. You feed the original problem statement and the decomposition trace into this prompt, and the LLM judge returns a structured JSON scorecard. The harness should treat this as a model-graded evaluation step that can be batched, logged, and compared across prompt versions or model changes.
Validation and retry logic is critical because the output schema includes numeric scores, enum labels, and arrays of finding objects. Implement a JSON schema validator that checks: all required fields are present, overall_score is an integer between 1 and 5, each dimension_score is within its defined range, and critical_flaws contains valid enum values like missing_subproblem or dependency_cycle. If validation fails, retry up to two times with the same prompt but append the validation error message as a [CONSTRAINTS] note. After three failures, flag the trace for human review rather than silently accepting a malformed score. Log every validation failure and retry attempt for later judge calibration analysis.
Model choice matters. This prompt requires strong reasoning capabilities to assess decomposition logic. Use a capable model like GPT-4o, Claude 3.5 Sonnet, or Gemini 1.5 Pro as the judge. Avoid using smaller or faster models for this evaluation task because they tend to miss subtle dependency violations and produce inflated scores. If cost is a concern, consider sampling a subset of traces for full evaluation rather than downgrading the judge model. Human review gates should be triggered when the overall score is 2 or below, when critical flaws are detected, or when the judge's confidence field (if you add one) falls below a threshold. Route flagged traces to a review queue where a human can confirm or override the automated score before the decomposition strategy is used in production.
Integration pattern: Wire this prompt as a post-processing step in your agent evaluation pipeline. After an agent produces a decomposition, store the raw trace. Then call this evaluation prompt asynchronously, store the scorecard alongside the trace, and update your evaluation dashboard. If you're running regression tests across prompt versions, compare the distribution of decomposition scores to detect regressions. A drop in sub_problem_independence or ordering_logic scores often signals that a planning prompt change introduced subtle breakage. Finally, periodically run inter-rater reliability checks by having a second LLM judge or a human evaluator score the same traces and comparing agreement rates on each dimension.
Common Failure Modes
What breaks first when evaluating decomposition strategy quality and how to guard against it.
Granularity Mismatch
What to watch: The judge rewards sub-problems that are too fine-grained (single trivial steps) or too coarse (entire task phases treated as one step). Both extremes inflate scores without reflecting real decomposition quality. Guardrail: Define explicit granularity anchors in the rubric with examples of appropriate sub-problem size for the domain. Use a separate granularity dimension scored independently from completeness.
False Independence Scoring
What to watch: The judge marks sub-problems as independent when they share hidden dependencies, data requirements, or ordering constraints. This produces inflated independence scores and masks brittle decomposition. Guardrail: Include a cross-check step in the evaluation harness that tests each sub-problem pair for shared inputs, outputs, or preconditions. Flag pairs with dependency overlap for manual review.
Ordering Blindness
What to watch: The judge accepts any plausible ordering without detecting when later sub-problems require outputs from earlier ones that haven't been produced yet. Circular or impossible orderings pass undetected. Guardrail: Build a dependency graph from declared inputs and outputs of each sub-problem. Validate topological sortability. Reject orderings that violate dependency direction.
Completeness Drift
What to watch: The judge gives high completeness scores to decompositions that cover obvious sub-problems but miss edge cases, error handling, verification steps, or integration work. The score looks good but the plan is incomplete. Guardrail: Maintain a domain-specific completeness checklist of required sub-problem categories. Cross-reference the decomposition against the checklist before scoring. Deduct for missing categories.
Surface-Level Pattern Matching
What to watch: The judge rewards decompositions that use expected keywords and structures without verifying that the sub-problems actually decompose the specific problem instance. Generic templates score well while missing problem-specific nuance. Guardrail: Include a problem-specific verification step where the judge must map each sub-problem back to a concrete requirement or constraint from the original problem statement. Flag sub-problems without clear provenance.
Judge Overconfidence on Ambiguous Decompositions
What to watch: The judge assigns high-confidence scores to decompositions where multiple valid strategies exist, failing to express uncertainty or acknowledge alternative approaches. This produces brittle pass/fail decisions on inherently subjective quality dimensions. Guardrail: Require the judge to output confidence intervals per dimension and flag cases where alternative decompositions could be equally valid. Escalate low-confidence or high-variance cases for human calibration review.
Evaluation Rubric
Use this rubric to evaluate the quality of a decomposition strategy in a reasoning trace. Each criterion targets a specific failure mode that breaks downstream agent execution. Apply per-trace and aggregate across a test suite before shipping.
| Criterion | Pass Standard | Failure Signal | Test Method |
|---|---|---|---|
Decomposition Completeness | All necessary sub-problems to solve the original task are explicitly listed; no missing dependencies. | The trace omits a sub-problem required for the final answer, or jumps directly to a solution without identifying intermediate steps. | LLM-as-Judge: prompt a second model to extract all sub-problems and compare against a human-annotated reference set. Flag missing items. |
Sub-Problem Independence | Each sub-problem is self-contained and can be reasoned about without relying on the solution of another sub-problem unless explicitly ordered. | Two sub-problems are defined such that solving one implicitly requires the answer from another, but no dependency is declared. Causes circular or blocked execution. | Parse the decomposition into a directed acyclic graph (DAG). Fail if an undeclared cycle is detected or if a node's input set references an undeclared output. |
Ordering Logic | Sub-problems are sequenced so that dependencies are resolved before they are needed. No forward references to unsolved sub-problems. | A sub-problem references the output of a later sub-problem, or the sequence requires solving a dependent problem before its prerequisite. | Topological sort of the declared dependency graph. Fail if the sort fails or if the trace's execution order contradicts the declared dependencies. |
Granularity Appropriateness | Sub-problems are sized appropriately for a single tool call or reasoning step. No sub-problem is a monolithic 'solve everything' step. | A single sub-problem contains multiple distinct operations (e.g., 'research, analyze, and write report'). This prevents effective tool assignment. | Count the verbs or distinct actions per sub-problem. Fail if any sub-problem contains more than one primary action verb without a clear single-tool mapping. |
Sub-Problem Specification Clarity | Each sub-problem is stated as a clear, actionable goal with a defined output type. An agent could pick up any sub-problem and execute it. | A sub-problem is vague ('handle the data'), underspecified ('do the thing'), or lacks a clear output artifact. | LLM-as-Judge: prompt a model to rate each sub-problem on a 1-3 clarity scale. Fail if any sub-problem scores 1 (unactionable). |
Root Problem Alignment | The set of sub-problems collectively solves the original user request. No extra work is introduced, and no goal is left unaddressed. | The decomposition solves a different problem, adds unnecessary sub-problems (over-decomposition), or misses the core intent of the original request. | LLM-as-Judge: prompt a model to verify that the union of sub-problem outputs would satisfy the original request. Fail if coverage score < 0.9 or if extraneous sub-problems are detected. |
Tool-Action Mapping Readiness | Each sub-problem can be directly mapped to an available tool or a well-defined reasoning action. No sub-problem requires a capability the system lacks. | A sub-problem requires a tool not in the agent's manifest (e.g., 'query live database' when only file search is available) or requires ambiguous multi-tool orchestration. | Cross-reference each sub-problem against the agent's tool manifest. Fail if any sub-problem has zero matching tools or requires an unavailable capability. |
Error Handling and Contingency Awareness | The decomposition acknowledges uncertainty points and includes conditional branches or fallback steps for high-risk sub-problems. | The decomposition assumes all steps will succeed and provides no alternative path if a sub-problem fails or returns low-confidence results. | Scan for conditional language (if, otherwise, fallback). Fail if the trace contains zero contingency branches and the task has known failure modes. |
Enabling Efficiency, Speed & Accuracy
Intelligent Analysis, Decision & Execution
We build AI systems for teams that need search across company data, workflow automation across tools, or AI features inside products and internal software.
Talk to Us
Search across company data
Give teams answers from docs, tickets, runbooks, and product data with sources and permissions.
Useful when people spend too long searching or get different answers from different systems.

Automate internal workflows
Use AI to route work, draft outputs, trigger actions, and keep approvals and logs in place.
Useful when repetitive work moves across multiple tools and teams.

Add AI to products and internal tools
Build assistants, guided actions, or decision support into the software your team or customers already use.
Useful when AI needs to be part of the product, not a separate tool.
Adapt This Prompt
How to adapt
Use the base prompt with a frontier model (GPT-4o, Claude 3.5 Sonnet). Remove the JSON output schema requirement and ask for a structured markdown report instead. Drop the inter-rater reliability harness. Run 10-20 traces manually and spot-check decomposition quality.
Prompt modification
Replace [OUTPUT_SCHEMA] with: Return your evaluation as a markdown report with sections for Completeness, Independence, Ordering, and Granularity. Include a summary score (1-5) for each dimension.
Watch for
- The model producing vague dimension scores without step-level evidence
- Overly generous scoring on incomplete decompositions
- Missing sub-problem independence checks when problems are tightly coupled

About the author
Prasad Kumkar
CEO & MD, Inference Systems
Prasad Kumkar is the CEO & MD of Inference Systems and writes about AI systems architecture, LLM infrastructure, model serving, evaluation, and production deployment. Over 5+ years, he has worked across computer vision models, L5 autonomous vehicle systems, and LLM research, with a focus on taking complex AI ideas into real-world engineering systems.
His work and writing cover AI systems, large language models, AI agents, multimodal systems, autonomous systems, inference optimization, RAG, evaluation, and production AI engineering.
Partnered with leading AI, data, and software stack.
How We Work
Custom AI workflows for your Business
One-fit-all AI don't work for modern businesses. At Inferensys, we aim to understand your business & custom requirements; which we use to define most efficient agentic workflows, the data, and the tools for your business.
01
Review the use case
We understand the task, the users, and where AI can actually help.
Read more02
Pick the right approach
We define what needs search, automation, or product integration.
Read more03
Build the first useful version
We implement the part that proves the value first.
Read more04
Improve from there
We add the checks and visibility needed to keep it useful.
Read moreThe first call is a practical review of your use case and the right next step.
Talk to Us