Skip to content

Problem structures

Controlled vocabulary for reusable workflow problem forms used by canonical pattern entries.

Source fields

  • problem_structure

Usage notes

  • Use the stable id in canonical pattern YAML and reserve the label for display text.
  • Choose the term that best matches the primary workflow shape, not every secondary behavior.
  • Prefer the most reusable structure across domains rather than domain-specific phrasing.

Terms

Context gathering and synthesis

Structured representation transformation

  • Stable id: structured-representation-transformation
  • Summary: Convert heterogeneous inputs into normalized, schema-aligned outputs that preserve operational meaning for downstream use.
  • Definition: Use for workflows that transform documents, records, or mixed content into structured data through extraction, normalization, enrichment, or schema-preserving reshaping while keeping lossiness and uncertainty explicit.
  • Selection guidance: Choose this when the main deliverable is a downstream-usable representation or handoff package. Prefer context gathering and synthesis when the workflow ends in a brief, evidence-backed verification when correctness adjudication dominates, and approval-gated execution when the value comes from acting on the transformed result.
  • Related ids: context-gathering-and-synthesis, evidence-backed-verification
  • Used by patterns:
  • Approval-gated transformation release
  • Batch content transformation
  • Change-triggered representation refresh
  • Critical channel-safe state packaging
  • Document to structured data handoff
  • Normalization and enrichment

Discrepancy investigation

  • Stable id: discrepancy-investigation
  • Summary: Identify why observed facts, records, or outcomes do not align.
  • Definition: Use for workflows that trace causes, inspect conflicting signals, and build an explanation for a mismatch, anomaly, or unexpected outcome.
  • Selection guidance: Choose this when the workflow centers on finding causes and narrowing hypotheses. Prefer record reconciliation when the goal is restoring consistency across systems of record.
  • Related ids: record-reconciliation, evidence-backed-verification
  • Used by patterns:
  • Incident root cause analysis

Record reconciliation

  • Stable id: record-reconciliation
  • Summary: Compare representations of the same entity or event and restore a trusted state.
  • Definition: Use for workflows that match records, detect inconsistencies, and determine the authoritative resolution across ledgers, tickets, inventories, or other structured systems.
  • Selection guidance: Choose this when alignment across records is the primary outcome. Prefer discrepancy investigation when explanation matters more than state correction.
  • Related ids: discrepancy-investigation, evidence-backed-verification
  • Used by patterns:
  • Authoritative record reconciliation
  • Critical authoritative state restoration

Evidence-backed verification

  • Stable id: evidence-backed-verification
  • Summary: Confirm whether a claim, condition, or output is correct against trusted evidence.
  • Definition: Use for workflows that validate facts, outputs, compliance conditions, or execution results using independent checks or corroborating evidence.
  • Selection guidance: Choose this when the core task is proving correctness or confidence. Prefer context gathering and synthesis when the workflow mainly summarizes rather than verifies.
  • Related ids: context-gathering-and-synthesis, record-reconciliation
  • Used by patterns:
  • Claimed state verification
  • Evidence-gated verification for release

Continuous monitoring and triage

Constraint-aware planning

  • Stable id: constraint-aware-planning
  • Summary: Produce a workable plan that respects limits, dependencies, and objectives.
  • Definition: Use for workflows that create task sequences, schedules, or resource allocations while balancing constraints such as deadlines, policies, availability, and priorities.
  • Selection guidance: Choose this when generating a viable plan is the main deliverable. Prefer multi-party-coordination when stakeholder alignment is the harder problem than plan construction.
  • Related ids: multi-party-coordination, recommendation-and-decision-support
  • Used by patterns:
  • Contingency plan activation gate
  • Critical command-window resequencing
  • Schedule adjustment and replanning

Multi-party coordination

  • Stable id: multi-party-coordination
  • Summary: Align actors, handoffs, and commitments across people, teams, or systems.
  • Definition: Use for workflows that keep multiple participants synchronized, negotiate sequencing, and update plans or ownership as conditions change.
  • Selection guidance: Choose this when coordination overhead and dependency management dominate. Prefer constraint-aware planning when a single feasible plan is the primary output.
  • Related ids: constraint-aware-planning, human-agent-collaboration
  • Used by patterns:
  • Authoritative change coordination refresh
  • Calendar conflict coordination

Recommendation and decision support

Approval-gated execution

  • Stable id: approval-gated-execution
  • Summary: Prepare and carry out actions once required approvals and checks are satisfied.
  • Definition: Use for workflows that transform a selected plan or decision into operational steps under explicit approval boundaries and control gates.
  • Selection guidance: Choose this when action execution matters and a formal approval checkpoint remains central. Prefer recommendation and decision support when the workflow stops at advice.
  • Related ids: recommendation-and-decision-support, exception-aware-orchestration
  • Used by patterns:
  • Browser-based form completion with approval gates
  • Workflow hand-off and completion

Exception-aware orchestration

  • Stable id: exception-aware-orchestration
  • Summary: Drive multi-step work forward while detecting failures, retries, and escalation cases.
  • Definition: Use for workflows that execute or coordinate a process across systems and adapt when the normal path fails, stalls, or encounters policy exceptions.
  • Selection guidance: Choose this when the hard part is keeping execution moving through edge cases. Prefer approval-gated execution when the main control point is a human authorization gate.
  • Related ids: approval-gated-execution, continuous-monitoring-and-triage
  • Used by patterns:
  • Exception-aware task execution
  • Human-directed task orchestration
  • Staged change execution with rollback holds

Feedback-driven optimization

Human-agent collaboration

Canonical source

  • data/vocabularies/problem-structures.yaml